Claude Code 連携

本ページでは、cc-router のアプリ内蔵 settings.json エディタを使い、集約済みの model-opus / model-sonnet / model-haiku などの仮想モデルへ Claude Code をワンクリックで接続する手順を説明します。

クイックスタート の「env スニペットを手でコピーして設定ファイルに貼り付ける」方式と比べ、これは cc-router のネイティブな方式です。アプリ内のボタンを 1 回押すだけで cc-router 関連フィールドが ~/.claude/settings.json に書き込まれます。最も安定しており、シェル環境に依存せず、既存のユーザー設定も尊重されます。

前提条件

  • クイックスタート に沿って cc-router をインストールし、最低 1 つの仮想モデルをバインド済み
  • Claude Code がインストール済み
  • cc-router が起動中で、ローカルプロキシが 127.0.0.1:23456 で待ち受けている（「接続ガイド」ページ上部の「プロキシ待ち受けアドレス」で確認）

ステップ 1：「接続ガイド → Claude Code」を開く

cc-router を開き、左メニューの 接続ガイド に切り替え、上部タブで Claude Code を選択します。

ページ上部の プロキシ待ち受けアドレス に現在のポートと稼働状態（例：127.0.0.1:23456 · 稼働中）が表示されます。その下の settings.json エディタ は ~/.claude/settings.json を直接読み書きし、右上の「同期済み」バッジはエディタの内容がディスク上のファイルと一致していることを示します。

cc-router 接続ガイドの Claude Code settings.json エディタ

ステップ 2：「cc-router 推奨設定を挿入」をクリック

エディタ下部の cc-router 推奨設定を挿入 ボタンをクリックすると、cc-router が必要なフィールドを必要に応じて JSON に書き込みます：

  • 既にあなた自身の設定（effortLevel、enabledPlugins など）がある場合は上書きされません。cc-router 関連の env フィールドのみが補完されます。
  • トークンとポートは稼働中の実値が入力されるため、手で書き写す必要はありません。

挿入される主な env フィールドは次のとおりです（実際の値はアプリが生成したものに従ってください）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:23456",
    "ANTHROPIC_AUTH_TOKEN": "アプリが自動入力する実トークン",
    "ANTHROPIC_MODEL": "model-opus",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "model-opus",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "model-sonnet",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "model-haiku",
    "CLAUDE_CODE_SUBAGENT_MODEL": "model-opus",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK": "1"
  }
}

model-opus、model-sonnet、model-haiku は cc-router でバインドした仮想スロット名で、アプリが自動的に実モデル名へ変換します。

1M コンテキストの書き方：スロットにバインドした実モデルが 1M コンテキストに対応している場合、モデル名を model-opus[1m] と書けます。これは Claude Code が解釈できる記法です。

ステップ 3：保存して Claude Code を再起動

保存 をクリックすると、cc-router が変更を ~/.claude/settings.json へ一括で書き戻します（バッジが「同期済み」に戻ります）。ディスク上の最新内容を確認するには 再読み込み をクリックします。

新しい設定を反映させるには Claude Code を完全に終了して再起動 してください。以降、Claude Code が送るリクエストはすべて 127.0.0.1:23456 を経由して、バインド済みの実モデルへルーティングされます。

検証

cc-router メイン画面の左メニューで ログ → リクエストログ に切り替え、Claude Code で対話を 1 回行うと、リクエストが記録され、クライアント 列に Claude Code、仮想モデル / 実モデル 列に対応するスロットと最終的な上流モデルが表示されるはずです。

トラブルシューティング

  • 変更が反映されない —— settings.json はホットリロードされません。Claude Code を完全に終了して再起動してください。
  • ポート使用中 / connection refused —— 既定ポート 23456 が使用中の場合、cc-router は自動的に +1 します。「接続ガイド」上部の プロキシ待ち受けアドレス に表示される実ポートを基準にし、cc-router 推奨設定を挿入 をもう一度クリックして最新ポートを同期してください。
  • 401 Unauthorized —— cc-router のトークンがローテーションされた可能性があります。本ページに戻り、cc-router 推奨設定を挿入 を再度クリックし、保存 して最新トークンを書き込みます。
  • 手動で設定したい —— ファイルを自分で編集したい場合は、クイックスタート の env スニペットを参照してください。結果は同じです。

セキュリティに関する注意

  • ANTHROPIC_AUTH_TOKEN はアクセス資格情報であり、すべての上流プロバイダを直接呼び出すのと同等です。漏洩させないこと、リポジトリにコミットしないこと。
  • cc-router のポートは信頼できる LAN 内でのみ公開してください。公開ネットワークへの露出はリスクを自己評価し、リバースプロキシ＋認証層で強化してください。