ACP 接続概説
Agent Client Protocol:Zed / Devin Desktop / JetBrains で共通に使える設定 —— Claude Code を ACP agent として動かし、環境変数を QCode に向ける
API キーが必要ですか? 登録する →エンドポイントと Base URL →
目次
最終確認:2026-10-15 · 📄 公式ドキュメント準拠(agentclientprotocol.com を同日確認)
概要¶
| 項目 | 内容 |
|---|---|
| 利用できるモデル | マウントする agent 次第:Claude Agent / Claude Code(Anthropic 系統)✅ · GPT ✅(Codex 系 agent)· 中国系モデル ✅ · Gemini は QCode で現在提供なし |
| プロトコルと Base URL | 設定は agent 本体側:Anthropic 系統は https://api.qcode.cc/api(Claude 系 agent) |
| 設定場所 | agent の環境変数/自身の設定ファイル。ホストは起動するだけ |
| 公式ドキュメント | Agent Client Protocol |
Agent Client Protocol(ACP) は、エディタと AI agent の通信を分離するオープン標準です —— 言語サーバーにおける LSP のような位置づけです。ACP を話せるエディタは、ACP を話せる任意の agent を、個別実装なしにホストできます。
QCode の利用者にとっては、非常に実用的な結論が 1 つあります:
🔑 agent 本体(例:Claude Code CLI)を QCode に接続すれば、ホスト側は自動的に追随します。 ACP ホストは agent を子プロセスとして起動するため、環境変数を継承します。
ANTHROPIC_BASE_URL/ANTHROPIC_AUTH_TOKENを設定すれば、Zed・Devin Desktop・JetBrains の いずれのセッションも QCode を経由します。エディタごとに設定し直す必要はありません。
ACP に対応するホスト¶
| ホスト | 説明 | 当サイトの文書 |
|---|---|---|
| Zed | ネイティブ対応。agent panel からセッションを開始 | Zed 編集器接続 |
| Devin Desktop(旧 Windsurf) | 2026-06-02 から対応。Agent Command Center 内 | Devin Desktop 接続 |
| JetBrains 系 | ACP プラグイン経由 | JetBrains IDE |
ACP を話す agent¶
代表的なものは Claude Code、Codex CLI、OpenCode、および ACP を自前実装した agent です。ホストごとに adapter と起動コマンドが異なるため、正確なコマンドはホストの文書に従ってください。
設定:1 回設定すればどこでも有効¶
Claude Code(Anthropic 経路)¶
export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_あなたのQCodeキー"
~/.zshrc / ~/.bashrc に書けば永続化します。中国本土からは https://asia.qcode.cc/api を使用。
~/.claude/settings.jsonのenvブロックに書いても同じ効果です。 詳細は 環境変数の設定。
Codex CLI(OpenAI Responses 経路)¶
Codex は TOML 設定で、base_url は /openai まで。Codex 完全ガイド を参照。
🔴 よくある落とし穴:GUI 起動のエディタはシェルの環境変数を読まない¶
macOS / Linux で Dock やランチャー、デスクトップアイコンから起動したエディタは ~/.zshrc を読みません。症状は「ターミナルの claude は QCode に繋がるのに、エディタ内の ACP セッションは認証に失敗する」です。
対処は 2 つ:
- ターミナルからエディタを起動する(例:
zed .)。現在のシェル環境を継承します - シェルの profile ではなく agent 自身の設定ファイルに書く
(Claude Code なら
~/.claude/settings.jsonのenvブロック)
起動方法に依存しない 2 の方が堅実です。
QCode に到達しているかの確認¶
KEY="cr_あなたのQCodeキー"
curl -s -o /dev/null -w '%{http_code}\n' -X POST https://api.qcode.cc/api/v1/messages \
-H "x-api-key: $KEY" -H "anthropic-version: 2023-06-01"
# 400 = パスもキーも OK(ボディ未指定は想定内);401 = キーの問題
エンドポイント側が正常と分かったうえでホスト側が失敗するなら、原因は ホストがどう agent を起動しているか(多くは上記の環境変数の罠)であり、QCode 側ではありません。
QCode 経由のリクエストはすべて probe.qcode.cc に記録されます。API Key を入力すれば、実際に届いているか確認できます。
ACP が agent を起動する仕組み:環境変数が「引き継がれる」理由¶
2026-10-15 時点の ACP 公式のトランスポート説明によると、ACP は JSON-RPC でメッセージをエンコードし、推奨される stdio トランスポートではクライアント(エディタ)が agent をサブプロセスとして起動します。agent は標準入力から JSON-RPC メッセージを読み、標準出力へメッセージを書き、メッセージは改行で区切られます。ログは標準エラー(stderr)に書けます。また、有効な ACP メッセージ以外を stdout に書くことを agent に禁じています。
切り分けにとって、これは次の 2 点を意味します。
- サブプロセスは既定で起動元の環境を引き継ぐため、シェルで設定した
ANTHROPIC_BASE_URLが効くかどうかは、エディタ自体がどう起動されたかに左右されます(上の GUI 起動の落とし穴を参照)。 - agent に独自のラッパースクリプトをかぶせる場合、スクリプト内で stdout に
echoで挨拶やデバッグ出力をしないでください。不正なメッセージとして扱われます。出力が必要なら stderr に書いてください。
主な設定項目¶
| 設定 | 用途 | 補足 |
|---|---|---|
ANTHROPIC_BASE_URL |
Claude 系 agent の接続先 | https://api.qcode.cc/api。/v1 なし、末尾のスラッシュなし |
ANTHROPIC_AUTH_TOKEN |
QCode のキー | cr_ で始まる。Authorization: Bearer ヘッダーで送られる |
~/.claude/settings.json の env ブロック |
上の 2 つを agent 自身の設定に書く | エディタの起動方法に依存せず、最も確実 |
Codex の base_url |
Codex 系 agent の接続先 | /openai まで。Codex 完全ガイド参照 |
| ホスト側の agent 起動コマンド | エディタに agent の起動方法を伝える | ホストごとに異なる。ホストのドキュメントに従う |
よくあるエラーと切り分け¶
| 症状 | 主な原因 | 対処 |
|---|---|---|
ターミナルでは claude が動くが、エディタの ACP セッションは認証エラー |
エディタを Dock やランチャーから起動し、シェルの変数を読んでいない | ターミナルからエディタを起動するか、~/.claude/settings.json の env に設定を書く |
401 / Invalid API key |
キーの誤り・空白混入、または古い ANTHROPIC_API_KEY が認証を奪っている |
env \| grep -i anthropic で残りを探す |
| 404 | Base URL に /v1 を付けた、または末尾のスラッシュ |
https://api.qcode.cc/api に戻す |
model_not_available_on_endpoint |
Claude 系 agent で GPT 系モデル、または Codex 系 agent で Claude モデルを選んだ | Claude は Anthropic インターフェース、GPT は OpenAI Responses。接続先と API 形式参照 |
| セッションが「起動中」のまま、またはすぐ切断される | agent がサブプロセスとして起動できない、またはラッパーが stdout に出力している | まず同じ起動コマンドをターミナルで手動実行し、次にラッパースクリプトを確認 |
| QCode 側でリクエストが見えない | リクエストが送られていない、または別のアドレスへ送られている | probe.qcode.cc にキーを入力して確認し、Base URL を見直す |
よくある質問¶
エディタごとに QCode を設定し直す必要がありますか?¶
ありません。設定するのは agent 自体(たとえば Claude Code)で、エディタはそれを起動するだけです。agent を QCode に接続すれば、Zed、Devin Desktop、JetBrains の ACP セッションは同じ設定を使います。
ACP と LSP の関係は?¶
考え方は似ています。LSP がエディタと言語サーバーを切り離すように、ACP はエディタと AI agent を切り離します。ACP を話せるエディタなら、ACP を話せる任意の agent を個別の統合なしに載せられます。
Dock から起動したエディタが環境変数を受け取ったか、どう確認しますか?¶
エディタで ACP セッションを開いて 1 通送り、probe.qcode.cc にキーを入力してそのリクエストがあるか確認します。なければ環境変数が agent に届いていないので、設定を ~/.claude/settings.json の env ブロックに書いてください。
ACP セッションで GPT は使えますか?¶
載せる agent によります。Claude 系 agent は Anthropic インターフェースのみで、Claude と中国系モデルを使います。GPT を使うには Codex 系 agent を載せ、Codex の流儀で base_url を https://api.qcode.cc/openai に向けます。QCode は現在 Gemini モデルを提供していません。
中国本土ではどのドメインを使いますか?¶
api.qcode.cc を asia.qcode.cc(アジア向け接続先)に置き換えます。キーはそのままです。不安定なら元に戻してください。
関連ドキュメント¶
- エンドポイントと API パス — プロトコル × モデルファミリー対応表
- 環境変数の設定
- Zed 編集器接続 · Devin Desktop 接続 · JetBrains IDE
QCode を始める
API キーひとつで Claude Code・Codex などに対応。トークン単位の課金で、各モデルの単価は qcode.cc/models に掲載