設定方法を選ぶ
Phaseo CLI で設定する
1 回ログインしてから、コーディングハーネスを設定します。--skip-install、--catalog default、--dry-run を使います。
永続的な連携には製品名のコマンドを使います。
codex, claude-code, opencode, deepseek-harness, pi, openclaw, hermes, aider, cline, roo-code, kilo-code, continue, cursor, and zed. 分離されたCLIランナーはcline、kilo、omp、muse、minimaxです。
CLI はアシスタントごとに専用の有効期限なし API キーを作成します。クリーンインストールでは Aider と Continue を自動設定し、Zed のプロバイダー/モデル設定も自動で書き込みます。シークレットをエディター UI のみで管理するアシスタントでは、残りの入力項目を表示し、専用ガイドにリンクし、そのアシスタントのキーだけをコピーできます。
手動のプロバイダー設定
ツールから別のフィールド名を指定されない限り、次の値を使います。
Anthropic 互換ツールでは、次の値を使います。
Cursor
Cursor では、OpenAI API キー設定から OpenAI 互換のカスタムエンドポイントを追加できます。- Cursor Settings を開きます。
Modelsに移動します。OpenAI API Keyの項目を有効にするか追加します。- Phaseo API キーを貼り付けます。
Override OpenAI Base URLを有効にします。- ベース URL を
https://api.phaseo.app/v1に設定します。 openai/gpt-5-nanoなどの Phaseo モデル ID を使ってカスタムモデルを追加します。- モデルを有効にし、Cursor のモデル選択メニューで確認します。
/ を含むモデル ID を拒否する場合、UI で設定できる最も近いローカルエイリアスを作成し、クライアントがエイリアスに対応していれば、自分の設定でそのエイリアスを Phaseo モデルにルーティングします。
VS Code
VS Code の Language Models エディターでは、使用中の VS Code または Insiders ビルドで OpenAI 互換プロバイダーが利用できる場合にモデルを追加できます。- コマンドパレットを開きます。
Chat: Manage Language Modelsを実行します。OpenAI CompatibleまたはOAI Compatibleを選択します。- Phaseo API キーを入力します。
- エンドポイントまたはベース URL を
https://api.phaseo.app/v1に設定します。 openai/gpt-5-nanoなどの Phaseo モデル ID を追加します。- チャットのモデル選択メニューから新しいモデルを選びます。
Continue
Continue では、カスタム API ベース URL を使い、OpenAI プロバイダー経由で Phaseo を利用できます。useResponsesApi: false を設定します。
Cline、Roo Code、Kilo Code
これらのツールでは、類似したプロバイダー設定を使います。- 拡張機能の設定を開きます。
- プロバイダーとして
OpenAI Compatibleを選択します。 - ベース URL を
https://api.phaseo.app/v1に設定します。 - Phaseo API キーを貼り付けます。
- Phaseo モデル ID を入力します。
- ファイル編集ツールを使う前に保存し、短いチャットリクエストを試します。
Aider
OpenAI 互換の環境変数を設定し、起動時にモデルを指定します。openai/ プレフィックスが必要な場合があります。 Phaseo のモデル ID にはプロバイダープレフィックスが含まれるため、Aider でのモデル指定全体は openai/openai/gpt-5-nano のようになります。
Pi、Prime Agent、OpenClaw、Hermes Agent
phaseo pi は専用のプロバイダー拡張機能を追加し、実行時に Phaseo CLI からキーを取得します。phaseo prime-agent はコマンド経由のプロバイダーを ~/.prime/agent/models.json に書き込みます。どちらにも互換性のある Phaseo モデルカタログが追加されます。phaseo openclaw は互換モデルカタログと exec ベースの SecretRef を登録し、API キーを openclaw.json に保存しません。
phaseo hermes は、Hermes が未インストールの場合に Nous Research の公式インストーラーを実行し、インストール後にエージェントを設定します。以前の Hermes モデル設定を保存し、Phaseo をカスタムエンドポイントとして設定します。また、Hermes 公式の hermes config set コマンドで専用キーを ~/.hermes/.env の OPENAI_API_KEY に設定します。Hermes はプロバイダー認証情報にこの平文ファイルを意図的に使うため、他の API キーファイルと同様に保護してください。削除時には以前のモデル設定を復元し、OPENAI_API_KEY と Phaseo の復旧状態を削除して、キーを失効させます。
MiniMax Code
mcode CLIには専用のMiniMax Codeガイドを使ってください。phaseo minimaxはPhaseoのOpenAI互換エンドポイントで一時的なMiniMaxプロバイダーを作成し、CLIを起動して、セッション終了時に一時データディレクトリを削除します。エディターやホストがACPを直接使う場合は、mcode acpによるACPにも対応しています。
Zed
phaseo zed を実行し、表示された手順に従って Zed の設定に OpenAI 互換プロバイダーを追加します。生成されたキーは Zed の認証情報欄だけに入力してください。
Codex
Codex CLI、Codex App、Codex IDE 拡張機能については、Codex 専用ガイドをご覧ください。要点は次のとおりです。OpenCode
OpenCode から OpenAI 互換のカスタムプロバイダー経由で Phaseo を呼び出す場合は、OpenCode 専用ガイドをご覧ください。Claude Code
Claude Code 専用ガイドをご覧ください。Claude Code は Anthropic 互換のゲートウェイ環境変数を使います。Claude Desktop
Claude Desktop は MCP サーバーに対応していますが、Cursor、Codex、Claude Code などのコーディングエージェントと同じカスタムモデルプロバイダー設定はありません。 Docs MCP を使うと、Claude Desktop に Phaseo ドキュメントのコンテキストを追加できます。Phaseo をモデルゲートウェイとして使う場合は Claude Code を利用してください。Deep Agents CLI と LangChain ツール
LangChain と同じベース URL と API キーを使います。ツールが OpenAI 環境変数を読む場合は、次のように設定します。注意事項
- モデル ID 内のスラッシュの扱いはコーディングエージェントごとに異なります。UI が
openai/gpt-5-nanoを拒否する場合、ツールが対応していればローカルエイリアスを作成してください。 - ファイル編集のワークフローは慎重にテストしてください。
phaseo:apply_patchは Responses 専用です。 - セッション中にアシスタントが Phaseo ドキュメントを参照できるようにするには、Docs MCP を追加します。
- 古いコーディングツールでは、Responses イベントとサーバーツールに明示的に対応している場合を除き、Chat Completions を優先してください。