Zed エディタ接続設定

Zed で ACP または settings.json から QCode.cc に接続し、Opus 5 / 4.8 / 4.7 の 1M コンテキスト agent panel と OpenAI 互換エンドポイントを使う

API キーが必要ですか？ 登録する →·エンドポイントと Base URL →

最終確認：2026-09-18 · 📄 公式ドキュメント準拠（Zed stable v1.20.2、2026-09-17 リリース）

概要¶

QCode は全体を通じて同一の API Key（cr_ で始まる）を使用します。同じ Key で Anthropic、OpenAI Chat、OpenAI Responses、画像の各プロトコルをサポートし、api / asia / us の 3 つの接続ドメインに対応します（中国本土のユーザーは asia.qcode.cc を優先してください）。

Zed を使う理由¶

• ネイティブ ACP 統合：agent panel 内で Claude Code セッションを開き、エディタで直接 agent の推論とツール呼び出しを確認できます
• 1M コンテキスト：BYOK モードで Opus 5 / 4.8 / 4.7 の 1M token フルコンテキストウィンドウをサポート
• Rust の性能：起動が極めて速く、メモリ消費は VS Code / Electron 系列より一桁少ない
• マルチパネルレイアウト：エディタ + ターミナル + agent panel の 3 列並列で、ワークフローがコンパクト
• 2 つの接続パス：Claude Code CLI（全ツール保持）経由でも、settings.json で QCode を内蔵 provider として接続でも可能

2 つの接続方式の比較¶

Zed から QCode に到達するには相補的な 2 つのパスがあります。用途に応じて選択してください：

以下の「設定手順」はパス A を、「settings.json での provider 設定」はパス B をカバーします。

前提条件¶

• Zed がインストール済み（macOS / Linux）
• Claude Code CLI がインストール済み（Zed の ACP 統合は CLI バックエンドを使用します。パス B のみ使用する場合はスキップ可）
• QCode.cc API Key（cr_ で始まる）を保有、ダッシュボード で取得
• Claude Code CLI が QCode 環境変数で設定済み（クイックスタート を参照）

設定手順（パス A：ACP / Claude Agent）¶

ステップ 1：まず Claude Code CLI がターミナルで動作することを確認¶

ACP の Claude Agent バックエンドは Claude Code のログイン・設定を再利用するため、先にターミナルで CLI 自体を動作確認します：

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_xxxxxxxx"
claude --version   # バージョン番号が出るはず（本機と公式 Releases を正本に）
echo "ping" | claude   # 簡単なエコーテスト

ANTHROPIC_BASE_URL の末尾にスラッシュを付けないでください。Anthropic SDK が自動で /v1/messages を追加します。シェル設定（~/.zshrc / ~/.bashrc）でこれら 2 つの環境変数を永続化し、Zed 起動時にも継承されることを保証してください。

ステップ 2：Zed の agent panel を開く¶

• macOS：Cmd + ?
• Linux：Ctrl + ?

初回起動時に agent provider の選択を求められるので、Claude Code を選択してください（BYOK Anthropic API は選ばないでください——そのパスは CLI を経由せず、Zed の設定で別途 base URL を入力する必要があります。パス B を参照）。

ステップ 3：agent セッションの検証¶

agent panel の入力欄に「現在のファイルのエクスポートシンボルを列挙して」と入力します。Zed は現在開いているファイルをコンテキストとして Claude Code に渡し、agent は read / grep ツールを呼び出して解析後に応答します。

ACP エージェントが起動しない場合、settings.json の agent_servers.<名前>.command / args / env で起動コマンドを明示できます（agent.path という設定キーは存在しません）。名称・詳細は公式ドキュメント優先：

Zed の agent / assistant 設定項目はリリースごとに変化が速いため、正確なキー名は Zed 公式ドキュメント を基準としてください。

settings.json での provider 設定（パス B）¶

CLI を使いたくない場合は settings.json に直接記述します（JSON ファイル本体は Cmd+Alt+, / Linux では Ctrl+Alt+, で開く。Cmd+, は設定エディタ UI）。ファイルは ~/.config/zed/settings.json（Windows は %APPDATA%/Zed/settings.json）、保存後再起動不要。サードパーティ ゲートウェイ向けの公式推奨入口は anthropic_compatible / openai_compatible カスタム provider です。QCode は両プロトコルを同一の cr_ Key で提供します。

Anthropic 互換 provider¶

Zed 内蔵の Anthropic provider の base を QCode の Anthropic エンドポイントに向けます：

{
  "language_models": {
    "anthropic_compatible": {
      "QCode": {
        "api_url": "https://api.qcode.cc/api"
      }
    }
  }
}

Key は環境変数で提供します（Zed が起動時に継承）：

export QCODE_API_KEY="cr_xxxxxxxx"

内蔵の language_models.anthropic.api_url も存在し動作しますが、公式が第三者ゲートウェイ用に推奨するのは上記 anthropic_compatible です。base URL は /api まで——/v1 は付けない——/v1/messages は Zed 側が付与します。API キーを settings.json に書かないこと（公式明記）。生成される <PROVIDER名>_API_KEY 環境変数を使ってください。

OpenAI 互換 provider¶

Zed は OpenAI 互換 provider もサポートしており、QCode の GPT 系モデルに接続できます。base を QCode の OpenAI Chat エンドポイントに向けます：

{
  "language_models": {
    "openai_compatible": {
      "QCodeOpenAI": {
        "api_url": "https://api.qcode.cc/openai/v1",
        "available_models": [
          { "name": "gpt-5.6-terra" },
          { "name": "gpt-5.6" },
          { "name": "glm-5.3" },
          { "name": "deepseek-v4-flash" }
        ]
      }
    }
  }
}

Key は同様に環境変数で：

export QCODEOPENAI_API_KEY="cr_xxxxxxxx"

OpenAI Chat プロトコルの base は https://api.qcode.cc/openai/v1（SDK がさらに /chat/completions を追加）です。末尾にスラッシュを付けないでください。available_models のフィールド名（name / max_tokens など）は Zed 公式ドキュメントを基準としてください。

モデル選択¶

QCode の同一 Key で複数ベンダーのモデルを利用できます。agent panel または assistant のモデルドロップダウンで必要に応じて切り替えます：

どのプロトコルか：claude-* は Anthropic provider（https://api.qcode.cc/api）のみ、gpt-* は OpenAI provider（https://api.qcode.cc/openai/v1）のみです。取り違えると model_not_available_on_endpoint が返ります。

上表は現行の推奨です。claude-sonnet-4-6、claude-opus-4-8、claude-opus-4-7 などの 4.x は引き続き販売中です。一覧は qcode.cc/models。

• パス A（Claude Code）では、モデルは Claude Code 自身の設定で決まります（/model で切り替え、または ANTHROPIC_MODEL 環境変数）。
• パス B で Anthropic provider を使う場合は claude-* のモデル ID を、OpenAI provider を使う場合は gpt-* のモデル ID を記述します。
• 画像（gpt-image-2）プロトコルは Zed の assistant で必ずしもネイティブに公開されません。CLI / スクリプトから直接呼び出せます。詳細は 接続点と API 形式 と gpt-image-2 画像生成 を参照してください。

使用例¶

agent panel：ファイル横断タスク¶

agent panel は複数ステップ・ファイル横断のタスクに向いています。例：

「utils/ 以下のすべての同期 IO を async に変更し、呼び出し側も更新して。」

agent は自動的に grep で特定し、read で読み取り、edit で変更し、エディタで diff を段階的に表示するので、一つずつ accept / reject できます。

スクリーンショットを agent に渡す（ビジョン入力）¶

Claude Opus 5 / Sonnet 5 と GPT-5.x はすべてビジョン対応モデルです。UI モック、エラーのスクリーンショット、アーキテクチャ図を入力として agent に渡せます：

• 画像を貼り付け（Ctrl+V）または agent panel 入力欄にドラッグ＆ドロップ
• もしくは prompt 内でローカル画像ファイルパスを参照

典型的なシナリオ：デザイン稿から UI を生成、エラースクリーンショットからバグを特定、アーキテクチャ図 / チャートを読む。

注意：これはモデルに画像を渡すこと（ビジョン入力）であり、画像を生成することではありません。画像生成には gpt-image-2 を使用してください。gpt-image-2 画像生成 を参照。

Dynamic Workflows（バックグラウンド子エージェント編成）¶

Claude Code は Dynamic Workflows をサポートします：数十〜数百のバックグラウンド子エージェントを編成でき、リポジトリ全体のレビュー、移行、調査といった大規模タスクに適しています。トリガー方法は prompt にキーワード ultracode を含めるか、単に「workflow を実行して」と頼むこと。実行中のタスクは /workflows コマンドで確認します。子エージェントはバックグラウンドで動き続け、その間あなたは別の作業を続けられます。Claude Code が設定しているモデル上で実行されるため、Claude Code が QCode を指しているときも利用可能です。関連：サブエージェント。

ヘッドレス / 自動化の出力フォーマット¶

CI / スクリプトで Claude Code を呼ぶ場合は claude -p と --output-format を併用します：

# JSON：result / total_cost_usd / usage / session_id を含む単一の構造化オブジェクト
claude -p "この変更を要約して" --output-format json | jq .result

# stream-json：改行区切りの JSON イベントストリーム、リアルタイムパイプライン向け
claude -p "このモジュールをリファクタして" --output-format stream-json

# text：デフォルトのプレーンテキスト
claude -p "このコードを説明して" --output-format text

その他の使い方は 自動化と CI/CD を参照してください。

他の接続先¶

現在のエンドポイントへのアクセスに問題がある場合は ANTHROPIC_BASE_URL（または settings.json の api_url）を切り替えてください：

OpenAI 互換パスはドメインを同様に置き換えるだけです。例えばアジアノードの OpenAI Chat base は https://asia.qcode.cc/openai/v1 です。完全なエンドポイント一覧は 接続点と API 形式 を参照してください。

共有クォータ¶

Zed 内の Claude Code agent は CLI / Claude Desktop / Codex CLI と同じ QCode API Key を使用してクォータを共有し、二重請求にはなりません。パス A とパス B も同一 Key のクォータを共有します。詳細は 請求について を参照してください。

制限と注意¶

• Zed の BYOK Anthropic 直接接続モードは Zed 内蔵の Anthropic provider を経由し、Claude Code CLI を通りません。Zed の設定で api_url に QCode エンドポイントを手動入力する必要があります（パス B）。本ガイドが対象とする ACP / Claude Agent モード（パス A）の方が推奨です——CLI のすべてのツール（hooks、skills、MCP）が保持されます。
• base URL の末尾にスラッシュを付けないでください。自己チェックで base パスに直接アクセスすると 401 が返るのは正常です（パスは正しく、認証がないだけ）。
• ACP 統合は Public Beta（2026-04 以降）で、一部の API は今後変更される可能性があります。挙動の差異が見つかった場合は Zed 公式ドキュメント を基準としてください。
• Linux サンドボックスユーザー：Zed が Flatpak でインストールされている場合、claude 子プロセスの spawn がサンドボックスに制限される可能性があります。.deb / AppImage / Homebrew 版を直接ダウンロードすることを推奨します。
• Gemini CLI は退役しました（企業版以外は 2026-06-18 EOL、企業有料 Key は影響なし）。後継は Google Antigravity CLI です。Antigravity CLI が受け付けるのは Gemini 互換エンドポイントのみ（環境変数 GOOGLE_GEMINI_BASE_URL）で、OpenAI 互換ではありません。QCode は現在 Gemini モデルを提供していません。詳細は Antigravity CLI 接続 を参照。

よくある質問¶

agent panel で "Failed to start agent" と表示される¶

• ターミナルで手動の claude が正常に起動するか？まず CLI 自身の設定問題を排除してください
• Zed が ANTHROPIC_* 環境変数を継承しているか？ターミナルから open -a Zed で起動すると継承を保証できます（macOS）
• claude-agent-acp と claude が PATH にあるか？which claude-agent-acp で確認し、必要なら agent_servers.<名前>.command で明示する

settings.json provider で 401 / 認証失敗が出る¶

• 対応する環境変数が設定済みで cr_ 始まりの QCode Key かを確認：カスタム provider は <PROVIDER名>_API_KEY（例 QCODE_API_KEY / QCODEOPENAI_API_KEY）、内蔵 provider のみ ANTHROPIC_API_KEY / OPENAI_API_KEY を使用
• Zed がその環境変数を継承しているか？ターミナルから Zed を起動して確認
• api_url の末尾に誤ってスラッシュが付いていないか？付いていたら削除

モデルドロップダウンに目的のモデルが表示されない¶

• パス B の OpenAI provider は、available_models にモデルを明示的に列挙しないとドロップダウンに表示されません
• パス A の選択可能モデルは Claude Code が決定します。/model で確認・切り替えできます

モデル名が無効 / 404¶

• モデル ID のスペルが上表と完全に一致しているか確認（例：claude-opus-5）
• base URL のプロトコルがモデルと一致しているか確認：claude-* は Anthropic エンドポイント、gpt-* は OpenAI エンドポイント

BYOK Anthropic モードとの違い¶

次のステップ¶

• Claude Code 完全チュートリアル — CLI の全機能の使い方
• 接続点と API 形式 — 3 つの接続ドメイン全表
• サブエージェント — Dynamic Workflows とマルチエージェント編成
• 自動化と CI/CD — ヘッドレスモードと出力フォーマット
• gpt-image-2 画像生成 — 画像生成（ビジョン入力とは別）
• VS Code 統合 — Electron 系エディタとの比較
• 請求について — 共有クォータのルール

各モデルのリアルタイム価格とコンテキスト仕様を確認したいですか？QCode 価格ページ へどうぞ。

企業版 →