docs(guides): add Codex + Claude local routing guide in three languages

Step-by-step guide for the v3.17.0 native Anthropic Messages upstream: add a custom Codex provider pointed at a Claude-family /v1/messages gateway, pick the anthropic upstream format, enable local routing, and verify the chain. Covers the auth-field choice (Bearer vs x-api-key), the Claude Code impersonation toggle, the 8192 max-output fallback, and a FAQ entry for gateways that restrict keys to Claude Code only. Includes four UI screenshots captured from the real 3.17.0 app with sample data, and links the guide from the v3.17.0 release notes in all three languages.
2026-07-24 12:44:18 +08:00 · 2026-07-14 11:53:55 +08:00
parent 7e73a1ffb2
commit c8b0d60c2d
10 changed files with 405 additions and 14 deletions
@@ -10,6 +10,7 @@

 The new capabilities in this release land mainly in the project switcher at the top of the home page, the Codex provider form, and the usage dashboard. The following docs are worth reading alongside it:

+- **[Using Claude in Codex (local routing guide)](../guides/codex-claude-routing-guide-en.md)**: a new step-by-step guide for this release's native Anthropic Messages upstream. It walks through setting a Codex provider's upstream format to `anthropic` to connect to any Claude-family gateway that only offers `/v1/messages`, and use Claude-family models inside Codex.
 - **[Using Kimi inside Codex (local routing guide)](../guides/codex-kimi-routing-guide-en.md)**: a new step-by-step guide added in this release. Newer Codex CLI speaks the OpenAI Responses protocol, while the Kimi Open Platform and Kimi For Coding expose Chat Completions endpoints, so a direct connection usually 404s; the guide walks through using the built-in `Kimi` / `Kimi For Coding` presets together with local routing to handle the protocol conversion.
 - **[Codex Official Login Preservation](../guides/codex-official-auth-preservation-guide-en.md)**: understand how CC Switch preserves your official ChatGPT login when you switch to a third-party provider. This release goes a step further — the official account itself can now route through the proxy too (see "Added" below).
 - **[Usage Statistics](../user-manual/en/4-proxy/4.4-usage.md)**: understand the Usage Dashboard's data sources and how the statistics are counted. This release fixes cache-write billing, fills in Codex subagent session accounting, and adds GPT-5.6 and Hunyuan Hy3 pricing.
@@ -311,11 +312,11 @@ Visit [Releases](https://github.com/farion1231/cc-switch/releases/latest) and do

 ### System Requirements

-| System  | Minimum Version          | Architecture                        |
-| ------- | ------------------------ | ----------------------------------- |
-| Windows | Windows 10 and later     | x64 / ARM64                         |
-| macOS   | macOS 12 (Monterey)+     | Intel (x64) / Apple Silicon (arm64) |
-| Linux   | See table below          | x64 / ARM64                         |
+| System  | Minimum Version      | Architecture                        |
+| ------- | -------------------- | ----------------------------------- |
+| Windows | Windows 10 and later | x64 / ARM64                         |
+| macOS   | macOS 12 (Monterey)+ | Intel (x64) / Apple Silicon (arm64) |
+| Linux   | See table below      | x64 / ARM64                         |

 ### Windows

@@ -354,11 +355,12 @@ Linux assets are available for both **x86_64** and **ARM64** (`aarch64`). Choose
 - `CC-Switch-v3.17.0-Linux-arm64.AppImage` / `.deb` / `.rpm`

 | Distribution                            | Recommended Format | Install Command                                                        |
-| --------------------------------------- | ------------------ | --------------------------------------------------------------------- |
+| --------------------------------------- | ------------------ | ---------------------------------------------------------------------- |
 | Ubuntu / Debian / Linux Mint / Pop!\_OS | `.deb`             | `sudo dpkg -i CC-Switch-*.deb` or `sudo apt install ./CC-Switch-*.deb` |
 | Fedora / RHEL / CentOS / Rocky Linux    | `.rpm`             | `sudo rpm -i CC-Switch-*.rpm` or `sudo dnf install ./CC-Switch-*.rpm`  |
 | openSUSE                                | `.rpm`             | `sudo zypper install ./CC-Switch-*.rpm`                                |
-| Arch Linux / Manjaro                    | `.AppImage`        | Make executable and run directly, or use AUR                          |
-| Other distributions / unsure            | `.AppImage`        | `chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage`             |
+| Arch Linux / Manjaro                    | `.AppImage`        | Make executable and run directly, or use AUR                           |
+| Other distributions / unsure            | `.AppImage`        | `chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage`              |
+
 </content>
 </invoke>
@@ -10,6 +10,7 @@

 本リリースの新機能は、主にホーム画面上部のプロジェクト切り替え、Codex プロバイダーフォーム、使用量ダッシュボードにあります。以下のドキュメントもあわせてご覧ください：

+- **[Codex で Claude を使う（ローカルルーティングガイド）](../guides/codex-claude-routing-guide-ja.md)**：本リリースの「ネイティブ Anthropic Messages 上流」に対応した新しいステップバイステップガイドです。Codex プロバイダーの上流形式を `anthropic` にして、`/v1/messages` のみを提供する Claude 系ゲートウェイへ接続し、Codex の中で Claude 系モデルを使う手順を説明します。
 - **[Codex で Kimi を使う（ローカルルーティングガイド）](../guides/codex-kimi-routing-guide-ja.md)**：新しい Codex CLI は OpenAI Responses 形式を使いますが、Kimi Open Platform と Kimi For Coding は Chat Completions endpoint を提供するため、直接接続すると通常は 404 になります。このガイドでは、内蔵の `Kimi` / `Kimi For Coding` プリセットとローカルルーティングを使ったプロトコル変換を説明します。
 - **[Codex の公式ログインを保持する](../guides/codex-official-auth-preservation-guide-ja.md)**：サードパーティプロバイダーへ切り替える際に、CC Switch が公式 ChatGPT ログインをどう保持するかを説明します。本リリースではさらに、公式アカウント自体をプロキシ経由でルーティングできるようになりました。
 - **[使用量統計](../user-manual/ja/4-proxy/4.4-usage.md)**：使用量ダッシュボードのデータソースと集計方法を確認できます。本リリースではキャッシュ書き込み課金を修正し、Codex サブエージェントの使用量を補完し、GPT-5.6 と Hunyuan Hy3 の価格を追加しました。
@@ -332,7 +333,7 @@ Windows ARM64 デバイスでは、ファイル名に `arm64` が含まれる対
 | -------------------------------- | ------------------------------------------------------ |
 | `CC-Switch-v3.17.0-macOS.dmg`    | **推奨** - DMG インストーラー、Applications へドラッグ |
 | `CC-Switch-v3.17.0-macOS.zip`    | 展開して Applications へドラッグ、Universal Binary     |
-| `CC-Switch-v3.17.0-macOS.tar.gz` | Homebrew インストールと自動更新用                       |
+| `CC-Switch-v3.17.0-macOS.tar.gz` | Homebrew インストールと自動更新用                      |

 Homebrew インストール：

@@ -353,10 +354,10 @@ Linux アセットは **x86_64** と **ARM64**（`aarch64`）の両方を提供
 - `CC-Switch-v3.17.0-Linux-x86_64.AppImage` / `.deb` / `.rpm`
 - `CC-Switch-v3.17.0-Linux-arm64.AppImage` / `.deb` / `.rpm`

-| ディストリビューション                  | 推奨形式    | インストール方法                                                          |
-| --------------------------------------- | ----------- | ------------------------------------------------------------------------- |
+| ディストリビューション                  | 推奨形式    | インストール方法                                                           |
+| --------------------------------------- | ----------- | -------------------------------------------------------------------------- |
 | Ubuntu / Debian / Linux Mint / Pop!\_OS | `.deb`      | `sudo dpkg -i CC-Switch-*.deb` または `sudo apt install ./CC-Switch-*.deb` |
 | Fedora / RHEL / CentOS / Rocky Linux    | `.rpm`      | `sudo rpm -i CC-Switch-*.rpm` または `sudo dnf install ./CC-Switch-*.rpm`  |
-| openSUSE                                | `.rpm`      | `sudo zypper install ./CC-Switch-*.rpm`                                   |
-| Arch Linux / Manjaro                    | `.AppImage` | 実行権限を付与して直接起動、または AUR を使用                             |
-| その他 / 不明                           | `.AppImage` | `chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage`                 |
+| openSUSE                                | `.rpm`      | `sudo zypper install ./CC-Switch-*.rpm`                                    |
+| Arch Linux / Manjaro                    | `.AppImage` | 実行権限を付与して直接起動、または AUR を使用                              |
+| その他 / 不明                           | `.AppImage` | `chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage`                  |
@@ -10,6 +10,7 @@

 本版的新能力主要落在主页顶部的项目切换器、Codex 供应商表单与用量看板里，建议结合以下文档了解：

+- **[在 Codex 中用 Claude（本地路由攻略）](../guides/codex-claude-routing-guide-zh.md)**：本版新增的分步攻略，配合「原生 Anthropic Messages 上游」功能使用。攻略讲解如何把 Codex 供应商的上游格式选为 `anthropic`，接入任何只提供 `/v1/messages` 的 Claude 系网关，在 Codex 里用上 Claude 系列模型。
 - **[在 Codex 里使用 Kimi（本地路由攻略）](../guides/codex-kimi-routing-guide-zh.md)**：本版新增的分步攻略。较新的 Codex CLI 走 OpenAI Responses 协议，而 Kimi 开放平台与 Kimi For Coding 暴露的是 Chat Completions 端点，直连通常 404；攻略讲解如何用内置的 `Kimi` / `Kimi For Coding` 预设配合本地路由完成协议转换。
 - **[Codex 官方登录保留](../guides/codex-official-auth-preservation-guide-zh.md)**：了解 CC Switch 如何在切换第三方供应商时保留你的官方 ChatGPT 登录。本版在此基础上更进一步——官方账号本身也可以走代理路由（见下方「新功能」）。
 - **[用量统计](../user-manual/zh/4-proxy/4.4-usage.md)**：了解用量看板的数据来源与统计口径。本版修正了缓存写入计费、补齐了 Codex 子代理会话统计，并新增 GPT-5.6 与混元 Hy3 定价。