CC-Switch Claude Code
このページでは、CC Switchでプロバイダーを追加または選択し、Claude Codeに適用する手順のみを説明します。Claude Code自体の直接的な設定チュートリアルではありません。Claude Codeの設定ファイルを直接変更したい場合は、「Claude Code CLI設定」をご覧ください。
公式情報 ダウンロードやドキュメントは公式サイトの情報をご確認ください。
このページで説明すること
CC Switchの目的は、プロバイダーを一元管理し、対象ツールへ設定を同期することです。Claude Codeでは、Claude / Anthropicプロトコル、APIキー、モデル名を重点的に確認してください。プロバイダーがClaude Code対応を明記していない限り、OpenAI互換アドレスをそのままClaudeアドレスとして使用しないでください。
開始前の確認事項
| 確認項目 | 確認方法 | 理由 |
|---|---|---|
| Claude Codeが起動できること | ターミナルまたはクライアントでClaude Codeが正常に開くことを確認します | CC Switchは設定の切り替えのみを行い、Claude Code自体のインストールは行いません |
| プロバイダーがClaude Codeに対応していること | 管理画面やドキュメントにClaude / Anthropic / Claude Codeに関する記載があることを確認します | OpenAI互換インターフェースのみを提供するプロバイダーは、Claude Codeで使用できない場合があります |
| キーとモデル名が利用可能であること | 管理画面でトークン、キー、モデル一覧、または利用可能なモデルの案内を確認できます | モデル名を誤って入力すると、モデルが見つからないエラー（model not found）になります |
| まずは対象ツールを1つだけ変更する | 最初はClaude Codeのみを選択します | トラブルシューティング時に、どこに問題があるかを特定しやすくなります |
項目の入力方法
| 設定項目 | 入力方法 | 初心者の注意点 |
|---|---|---|
| プロバイダー名 | 識別しやすい名前を入力します | 例：「メインプロバイダー Claude」など。数字だけにしないようにしてください |
| 対象ツール / プリセット | Claude CodeまたはClaude関連のプリセットを選択します | Codex、OpenAI、Geminiを選択しないでください |
| Base URL | プロバイダーの管理画面で提供されているClaude / Anthropic用のAPIリンクをコピーします | すべてのプロバイダーがOpenAIと同じBase URLを共有しているわけではありません |
| API Key | 管理画面で生成された完全なキーをコピーします | トークン、Key、Secret Keyなどと呼ばれることもあります |
| モデル名 | 管理画面でサポートされているClaudeモデル名を正確にコピーします | 自己流で省略したり、表示用の名称をモデル名に入力したりしないでください |
プロバイダーの管理画面でプロトコルごとにアドレスが分かれている場合、Claude CodeではClaude / Anthropicグループのものを使用します。管理画面に「Claude CodeはOpenAI互換アドレスを使用」と明記されている場合に限り、その案内に従って入力してください。
Claude Codeに適用する
- CC Switchを開き、プロバイダー管理エリアに移動します。
- 新しいプロバイダーを追加するか、作成済みのプロバイダー設定を選択します。
- 対象ツールでClaude Code関連のプリセットを選択します。
- プロバイダー名、Base URL、API Key、モデル名を順に入力します。
- 保存後、「Apply / Switch」を実行して、現在のプロバイダー設定をClaude Codeに適用します。
- ターミナルや対象ツールの再起動を促すメッセージが表示された場合は、現在のClaude Codeセッションを閉じてから再起動してください。
動作確認
テスト時は、実際のプロジェクトを直接開かず、まず非常に短い質問を送信してください。正常に応答が返ってくれば、APIキー、Base URL、モデル名、および対象ツールへの同期が基本的に問題なく動作していることを示しています。
Claude Code 最小テスト
claude "Please reply only: CC-Switch Claude Code is active"テストに失敗した場合は、次の優先順位で確認してください：対象ツールの選択が間違っていないか、Base URLがClaude / Anthropic用のものであるか、キーが完全にコピーされているか、モデル名が管理画面の表記通り正確にコピーされているか。