Skip to main content
このガイドでコーディングエージェントをPhaseoに接続します。認証情報と設定を管理したい場合はPhaseo CLIを、エージェント内で設定したい場合は手動のプロバイダー値を使ってください。

設定方法を選ぶ

Phaseo CLI で設定する

1 回ログインしてから、コーディングハーネスを設定します。
このコマンドはハーネスのインストール状態を確認します。対話型ターミナルで未インストールの場合、Phaseo は対応するインストールコマンドを表示し、実行前に確認します。その後、ハーネス専用のキーを作成して設定を書き込みます。非対話型の実行では、無人でシステムを変更せず、具体的なインストール手順を表示します。OpenCode、DeepSeek Harness、Pi、Prime Agent、OpenClaw には、Chat Completions 対応の有効なテキストモデルもすべて追加されます。動作範囲を絞るには --skip-install、--catalog default、--dry-run を使います。 永続的な連携には製品名のコマンドを使います。
Supported integration names are 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 のみで管理するアシスタントでは、残りの入力項目を表示し、専用ガイドにリンクし、そのアシスタントのキーだけをコピーできます。
設定前にファイル変更をプレビューし、後から安全に接続を解除できます。
削除すると Phaseo が管理する設定を消去し、そのアシスタントのキーを失効させます。無関係な設定は削除しません。

手動のプロバイダー設定

ツールから別のフィールド名を指定されない限り、次の値を使います。 Anthropic 互換ツールでは、次の値を使います。

Cursor

Cursor では、OpenAI API キー設定から OpenAI 互換のカスタムエンドポイントを追加できます。
  1. Cursor Settings を開きます。
  2. Models に移動します。
  3. OpenAI API Key の項目を有効にするか追加します。
  4. Phaseo API キーを貼り付けます。
  5. Override OpenAI Base URL を有効にします。
  6. ベース URL を https://api.phaseo.app/v1 に設定します。
  7. openai/gpt-5-nano などの Phaseo モデル ID を使ってカスタムモデルを追加します。
  8. モデルを有効にし、Cursor のモデル選択メニューで確認します。
Cursor が / を含むモデル ID を拒否する場合、UI で設定できる最も近いローカルエイリアスを作成し、クライアントがエイリアスに対応していれば、自分の設定でそのエイリアスを Phaseo モデルにルーティングします。

VS Code

VS Code の Language Models エディターでは、使用中の VS Code または Insiders ビルドで OpenAI 互換プロバイダーが利用できる場合にモデルを追加できます。
  1. コマンドパレットを開きます。
  2. Chat: Manage Language Models を実行します。
  3. OpenAI Compatible または OAI Compatible を選択します。
  4. Phaseo API キーを入力します。
  5. エンドポイントまたはベース URL を https://api.phaseo.app/v1 に設定します。
  6. openai/gpt-5-nano などの Phaseo モデル ID を追加します。
  7. チャットのモデル選択メニューから新しいモデルを選びます。
VS Code に OpenAI 互換プロバイダーが表示されない場合は、Continue、Cline、Roo Code、Kilo Code など、カスタムプロバイダーに対応する拡張機能を使ってください。

Continue

Continue では、カスタム API ベース URL を使い、OpenAI プロバイダー経由で Phaseo を利用できます。
Continue の既定は Responses ですが、ワークフローで Chat Completions 互換性が必要な場合は useResponsesApi: false を設定します。

Cline、Roo Code、Kilo Code

これらのツールでは、類似したプロバイダー設定を使います。
  1. 拡張機能の設定を開きます。
  2. プロバイダーとして OpenAI Compatible を選択します。
  3. ベース URL を https://api.phaseo.app/v1 に設定します。
  4. Phaseo API キーを貼り付けます。
  5. Phaseo モデル ID を入力します。
  6. ファイル編集ツールを使う前に保存し、短いチャットリクエストを試します。

Aider

OpenAI 互換の環境変数を設定し、起動時にモデルを指定します。
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 専用ガイドをご覧ください。要点は次のとおりです。
Codex のカスタムプロバイダーは Responses ワイヤープロトコルを使います。

OpenCode

OpenCode から OpenAI 互換のカスタムプロバイダー経由で Phaseo を呼び出す場合は、OpenCode 専用ガイドをご覧ください。

Claude Code

Claude Code 専用ガイドをご覧ください。Claude Code は Anthropic 互換のゲートウェイ環境変数を使います。
その後、同じシェルから Claude Code を起動します。

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 環境変数を読む場合は、次のように設定します。
その後、ツールのモデルフィールドに Phaseo モデル ID を指定します。

注意事項

  • モデル ID 内のスラッシュの扱いはコーディングエージェントごとに異なります。UI が openai/gpt-5-nano を拒否する場合、ツールが対応していればローカルエイリアスを作成してください。
  • ファイル編集のワークフローは慎重にテストしてください。phaseo:apply_patch は Responses 専用です。
  • セッション中にアシスタントが Phaseo ドキュメントを参照できるようにするには、Docs MCP を追加します。
  • 古いコーディングツールでは、Responses イベントとサーバーツールに明示的に対応している場合を除き、Chat Completions を優先してください。

関連情報

最終更新日 2026年10月2日