プロバイダーとキー

stepperは5つのAIプロバイダーをサポートします。APIキーは明示的な設定、環境変数、またはOSキーリングを通じて構成できます。優先順位が重要であり、各プロバイダーごとに認証要件が異なります。

サポートするプロバイダー

• ollama-cloud — Ollamaクラウドモデル
• oMLX — localhost:8000/v1で動作するローカルのApple-Silicon MLX。認証はオプションです
• OpenAI — OpenAI API
• Anthropic — Anthropic Claudeモデル
• Codex — OAuth経由のChatGPT

キーの優先順位

stepperは次の順序でAPIキーを探します: 設定内の明示的なapiKey → 環境変数 → OSキーリング。最初に一致したものが採用されます。

環境変数でキーを設定する

STEPPER_<PROVIDER>_API_KEYという規約を使用します。ここでプロバイダー名は大文字に変換し、ハイフンはアンダースコアに置き換えます。

# Env var: STEPPER_<PROVIDER>_API_KEY  (provider uppercased, '-' → '_')
export STEPPER_ANTHROPIC_API_KEY=sk-ant-...
export STEPPER_OLLAMA_CLOUD_API_KEY=...

OSキーリングにキーを保存する

keyringコマンドを使ってキーを安全に保存・管理します。キーリングはシステムの資格情報マネージャー(macOSのKeychain、Linuxのsecret-service、WindowsのCredential Manager)にキーを保存します。

# Store a key (prompts for the key on stdin):
stepper auth set-key <provider>

# Remove a key:
stepper auth delete-key <provider>

Codex (ChatGPT) OAuth

Codexプロバイダー(ChatGPT)を使用するには、OAuthで認証します。この過程でブラウザが開き、資格情報がローカルに保存されます。

# Codex (ChatGPT) OAuth — opens a browser, stores ~/.stepper/codex-auth.json (0600):
stepper auth login --codex

oMLXのローカルセットアップ

localhostで動作するoMLXは通常APIキーが不要で、外部依存のないローカル開発に最適です。