Zed エディタ接続設定

Zed エディタで Agent Client Protocol (ACP) を介して QCode.cc を Claude Code に接続し、Opus 4.7 の 1M コンテキスト agent panel を有効化する

Zed エディタ接続設定¶

Zed は Rust で書かれた高性能でモダンなコードエディタで、2026 Q1 から Agent Client Protocol (ACP) をネイティブにサポートしています——これは IDE と AI agent の通信を疎結合にするオープン標準で、言語サーバーに対する LSP に相当します。Zed は ACP を通じて Claude Code と統合し、複数ステップのコードタスクを編成するための agent panel を提供します。本ガイドでは、QCode.cc を Zed の Claude Code の上流として設定する方法を紹介します。

Zed を使う理由¶

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

前提条件¶

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

設定手順¶

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

Zed は claude プロセスを spawn して ACP を起動するため、先にターミナルで動作確認します：

export ANTHROPIC_BASE_URL="http://103.236.53.153/api"
export ANTHROPIC_AUTH_TOKEN="cr_xxxxxxxx"
claude --version   # バージョン番号が出力されるはず
echo "ping" | claude   # 簡単なエコーテスト

シェル設定（~/.zshrc / ~/.bashrc）でこれら 2 つの環境変数を永続化し、Zed 起動時にも継承されることを保証してください。

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

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

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

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

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

agent panel に claude コマンドが見つからないと表示される場合、Zed の設定（Cmd+,）で agent.path に CLI バイナリの完全パスを指定してください：

{
  "agent": {
    "path": "/usr/local/bin/claude"
  }
}

フォールバックエンドポイント¶

プライマリエンドポイントへのアクセスに問題がある場合は ANTHROPIC_BASE_URL を切り替えてください：

完全なエンドポイント一覧（北米 / 欧州 / アジアのフォールバックを含む）は 接続点と API 形式 を参照してください。

共有クォータ¶

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

制限と注意¶

• Zed の BYOK Anthropic 直接接続モードは Zed 内蔵の Anthropic provider を経由し、Claude Code CLI を通りません。Zed の設定で assistant.providers.anthropic.api_url に QCode エンドポイントを手動入力する必要があります。本ガイドが対象とする ACP / Claude Code モードの方が推奨です——CLI のすべてのツール（hooks、skills、MCP）が保持されます。
• ACP 統合は Public Beta（2026-04 以降）で、一部の API は今後変更される可能性があります。挙動の差異が見つかった場合は Zed 公式ドキュメント を基準としてください。
• Linux サンドボックスユーザー：Zed が Flatpak でインストールされている場合、claude 子プロセスの spawn がサンドボックスに制限される可能性があります。.deb / AppImage / Homebrew 版を直接ダウンロードすることを推奨します。

よくある質問¶

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

• ターミナルで手動の claude が正常に起動するか？まず CLI 自身の設定問題を排除してください
• Zed が ANTHROPIC_* 環境変数を継承しているか？ターミナルから open -a Zed で起動すると継承を保証できます（macOS）
• 設定の agent.path に指定したパスが存在するか？which claude で確認してください

BYOK Anthropic モードとの違い¶

次のステップ¶

• Claude Code 完全チュートリアル — CLI の全機能の使い方
• 接続点と API 形式 — 5 つの接続ドメイン全表
• VS Code 統合 — Electron 系エディタとの比較
• 請求について — 共有クォータのルール