CC Switch の使い方：Claude Code と Codex の API をワンクリックで切り替え

まずファイルを見て、それからセッションを開き直してください。~/.claude/settings.json を開き、ANTHROPIC_BASE_URL がいま有効化した組になっているか確かめます。ファイルは変わったのにセッションが変わらないなら、実行中の claude を閉じ、新しいターミナルで起動し直します。QCode のドキュメントが引く issue #3057 にまさにこの挙動が記録されていて、Claude Code はプロセスの起動時に settings.json の env を環境変数に読み込み、実行中のセッションは読み直しません。そもそも再起動が要るかについては公式の記述が分かれており、公式 README は Claude Code がホットスイッチに対応し再起動は不要と書き、ユーザーマニュアルの FAQ はターミナルを閉じて開き直すか IDE を再起動するよう書いています。Codex については両方ともターミナルの開き直しを求めています。トレイからの切り替えも同じファイルに書き込むだけで、実行中の claude を止めてはくれません。

たいていはどれか一つの設定のキーが間違っています。キーが cr_ で始まり前後に空白がないことを確かめ、コンソールでまだ有効かを確認してください。Claude Code は 401 なのに Codex は動く（またはその逆）なら、問題はその設定です。CC Switch は設定ごとにキーを別々に保存するので、キーを替えたら一つずつ更新します。なお、カードの接続チェックはアドレスに届くかを見るだけで、公式ユーザーマニュアルはキーを検証しないと明記しています。チェックが通ってもキーが正しいとは限りません。

まず ~/.codex/config.toml を確認します。base_url は /openai までで、/openai/v1 ではありません。wire_api = "responses" は必ず残します。QCode のドキュメントによると、最も多い原因は最上位の model_provider が書かれていないか、[model_providers.xxx] のテーブル名と一致していないことで、その場合 Codex は組み込みの openai 公式エンドポイントに戻ってしまいます。直したらターミナルを開き直して codex を実行してください。

使えます。CC Switch は Claude の設定を ~/.claude/、Codex の設定を ~/.codex/ に書き込み、互いに干渉しないので、ターミナルで claude と codex をそれぞれ起動するだけです。両方に同じ cr_ キーを入れられ、Claude Code は https://api.qcode.cc/api、Codex は https://api.qcode.cc/openai です。QCode のドキュメントは、このように一つのキーを共有しても、設定を二つ作ったことで二重に課金されることはないと明記しています。

消えることがあるので、先にバックアップしてください。QCode のドキュメントによると、有効化の際に CC Switch はその設定の値で ~/.claude/settings.json の該当項目を上書きし、一部の版ではファイル全体が上書きされて enabledPlugins や hooks が消えたという報告もあります。v4.0 プレビュー版のリリースノートには、切り替えが主要フィールドだけの置き換えに変わったと書かれています。消えた場合は ~/.cc-switch/backups/（公式には直近 10 個を保持）か、書き出した cc-switch-export-{timestamp}.sql から戻せます。また初回起動時、CC Switch は既存の Claude Code と Codex の設定を default という名前の設定として取り込みます。

一覧で組み込みの公式設定（Claude Code は Claude Official、Codex は OpenAI Official。削除していたらプリセットから追加し直します）を選び、「有効化」を押して CLI を再起動し、ツール自身のログイン手順を進めます。Claude Code は /login、Codex は codex login です。その後は公式ログインと QCode のカスタム設定を自由に行き来できます。QCode のドキュメントは、env を空にしたまま cr_ キーだけ残すような混ぜ合わせの設定を手作りしないよう注意しています。