diff --git a/blog/cc-switch-claude-desktop-entry.png b/blog/cc-switch-claude-desktop-entry.png new file mode 100644 index 0000000..0292d40 Binary files /dev/null and b/blog/cc-switch-claude-desktop-entry.png differ diff --git a/blog/claude-desktop-apply-cc-switch-locally.png b/blog/claude-desktop-apply-cc-switch-locally.png new file mode 100644 index 0000000..1f82f00 Binary files /dev/null and b/blog/claude-desktop-apply-cc-switch-locally.png differ diff --git a/blog/claude-desktop-configure-third-party-inference.png b/blog/claude-desktop-configure-third-party-inference.png new file mode 100644 index 0000000..b8992b2 Binary files /dev/null and b/blog/claude-desktop-configure-third-party-inference.png differ diff --git a/blog/claude-desktop-enable-developer-mode.png b/blog/claude-desktop-enable-developer-mode.png new file mode 100644 index 0000000..206b405 Binary files /dev/null and b/blog/claude-desktop-enable-developer-mode.png differ diff --git a/src/content/writings/en/configure-claude-code-app-with-cc-switch-and-token-station.md b/src/content/writings/en/configure-claude-code-app-with-cc-switch-and-token-station.md index e8ad46c..8089114 100644 --- a/src/content/writings/en/configure-claude-code-app-with-cc-switch-and-token-station.md +++ b/src/content/writings/en/configure-claude-code-app-with-cc-switch-and-token-station.md @@ -1,8 +1,8 @@ --- slug: "configure-claude-code-app-with-cc-switch-and-token-station" lang: "en" -title: "Configure the Claude Code App with CC Switch and Token Station" -summary: "Configure a Token Station provider for the Claude Code App, enable model mapping and CC Switch local routing, then verify the complete route with a real request." +title: "Configure Claude Desktop with CC Switch and Token Station" +summary: "Learn about and install CC Switch, configure a Token Station provider for Claude Desktop, enable model mapping and local routing, then verify the complete route." category: "tutorial" date: "2026-08-17" cta: "https://models.bytefuture.ai/intro.html" @@ -10,41 +10,63 @@ cover: "blog/configure-claude-code-app-with-cc-switch-and-token-station-cover.pn draft: false --- -CC Switch can store several Claude Code providers and switch between them without repeatedly editing configuration files. This guide connects the Claude Code App to Token Station, maps Claude's Sonnet, Opus, and Haiku roles to models available in Token Station, and routes requests through the local CC Switch service. +This guide explains how to install CC Switch and use it to connect Claude Desktop to Token Station. Once configured, CC Switch maps the Sonnet, Opus, and Haiku roles requested by Claude Desktop to selected models in Token Station. -> This guide is for the **Claude Code App** panel in CC Switch. Claude Desktop and the Claude Code CLI use different configuration paths. Do not apply their instructions to this setup. +> This guide is for the **Claude Desktop** panel in CC Switch. Claude Desktop and the Claude Code CLI use different configuration paths. Do not apply the Claude Code CLI instructions to this setup. + +## Install CC Switch + +[CC Switch](https://github.com/farion1231/cc-switch) is a desktop application for managing AI tool providers. It supports tools including Claude Desktop, Claude Code, Codex, and Gemini CLI. + +Configuring these tools directly usually requires editing separate configuration files or environment variables. CC Switch brings tools and providers into one graphical interface, where you can save several configurations and switch between them without repeatedly entering API endpoints and keys. + +macOS users can install it with Homebrew: + +```bash +brew install --cask cc-switch +``` + +Windows and Linux users, as well as macOS users who prefer manual installation, can download the package for their system from [CC Switch Releases](https://github.com/farion1231/cc-switch/releases) and follow the instructions on the release page. ## Before you start You need the following in place: -- CC Switch and the Claude Code App +- CC Switch installed and able to open +- Claude Desktop installed and able to start - A valid Token Station API key - Access to the models you plan to use, and credit to spend on them -Open the [Token Station dashboard](https://models.bytefuture.ai/dashboard) and copy the complete model IDs. Keep the API key out of screenshots, chat messages, and version control. +Open the [Token Station dashboard](https://models.bytefuture.ai/dashboard), copy the API key, and confirm the complete IDs of the models you plan to use. Keep the API key out of screenshots, chat messages, and version control. ## Configuration flow The complete setup is: -1. Create a Claude Code provider in CC Switch +1. Create a Claude Desktop provider in CC Switch 2. Enter the Token Station endpoint and API key 3. Turn on **Needs model mapping** 4. Map Sonnet, Opus, and Haiku to Token Station model IDs 5. Enable the CC Switch routing service and Claude routing -6. Enable the provider and fully restart the Claude Code App +6. Enable the provider and fully restart Claude Desktop 7. Send a request and verify it in Token Station Skipping model mapping or local routing can leave the app on its previous service even when CC Switch shows Token Station as the current provider. ## Add the Token Station provider -Button labels can differ slightly between CC Switch releases, but the required settings are the same. - ### 1. Create a provider -Open CC Switch, select **Claude Code**, enter provider management, and click Add, New Provider, or the plus button. Give the provider a recognizable name: +Open CC Switch, select **Claude Desktop** in the top toolbar, enter provider management, and click Add, New Provider, or the plus button. + +
+ Claude Desktop is selected in the CC Switch top toolbar, and the Claude Desktop Official provider is visible +
Select Claude Desktop in the CC Switch top toolbar.
+
+ +### 2. Enter the connection settings + +Give the provider a recognizable name: ```text Token Station @@ -52,8 +74,6 @@ Token Station If a provider type or API format is required, select Claude, Anthropic, or **Anthropic Messages (native)**. -### 2. Enter the connection settings - | Field | Value | | --- | --- | | Request URL / Base URL | `https://models.bytefuture.ai` | @@ -80,7 +100,7 @@ Some templates use `ANTHROPIC_API_KEY` instead of `ANTHROPIC_AUTH_TOKEN`. Follow ### 3. Turn on Needs model mapping -The **Needs model mapping** switch must be On. The Claude Code App requests models by Claude roles such as Sonnet, Opus, and Haiku. CC Switch must translate those roles into the full model IDs understood by Token Station. +The **Needs model mapping** switch must be On. Claude Desktop requests models by Claude roles such as Sonnet, Opus, and Haiku. CC Switch must translate those roles into the full model IDs understood by Token Station.
CC Switch provider form with the Needs model mapping option enabled @@ -115,36 +135,63 @@ This is the step most often skipped, and skipping it is why the app keeps answer 2. Turn on **Show local routing switch on the home page** 3. Start or keep the routing master switch running 4. Enable **Claude** under routing -5. Return to the Claude Code panel and turn its local routing toggle On +5. Return to the Claude Desktop panel and turn its local routing toggle On
CC Switch routing settings with local routing running and Claude routing enabled
Keep the routing service running, expose the home-page switch, and enable Claude routing.
-CC Switch must remain open while this route is in use. Quitting it stops the local gateway and the Claude Code App can no longer reach Token Station through this configuration. - -The active request path is: - -```text -Claude Code App - → CC Switch local routing - → model mapping - → Token Station - → selected model -``` +CC Switch must remain open while this route is in use. Quitting it stops the local gateway and Claude Desktop can no longer reach Token Station through this configuration. ## Save, enable, and restart Before saving, confirm that the URL has no extra path, the API key has no surrounding whitespace, **Needs model mapping** is On, and every model ID includes its provider prefix. -Save the provider, select **Token Station**, and click Enable, Apply, or Switch. Then completely quit the Claude Code App and reopen it. Closing only the window may leave the process running with its old configuration. +Save the provider, select **Token Station**, and click Enable, Apply, or Switch. Then completely quit Claude Desktop and reopen it. Closing only the window may leave the process running with its old configuration. + +On Windows, check the system tray and choose Quit if necessary. On macOS, use `Command + Q`. Keep CC Switch and its routing service running when you reopen Claude Desktop. + +## Use Claude Desktop without an Anthropic account + +After configuring CC Switch, you can connect Claude Desktop to its local gateway through the third-party inference feature without first signing in to an Anthropic account. The steps below use Claude Desktop for Windows. Menu locations may differ slightly on other systems or versions. + +### 1. Enable Developer Mode + +Open the menu in the upper-left corner of Claude Desktop, then select **Help → Troubleshooting → Enable Developer Mode**. + +
+ The Claude Desktop Help menu is open, with Troubleshooting expanded and Enable Developer Mode selected +
Select Enable Developer Mode under Help → Troubleshooting.
+
+ +The **Developer** entry should now appear in the main menu. If it does not appear immediately, completely quit Claude Desktop and reopen it. + +### 2. Open the third-party inference settings + +From the upper-left menu, select **Developer → Configure Third-Party Inference...**. + +
+ Configure Third-Party Inference is selected in the Claude Desktop Developer menu +
Open the third-party inference settings from the Developer menu.
+
+ +### 3. Apply the CC Switch configuration + +On the settings page, confirm that **CC Switch** appears in the upper-right corner and that Connection is set to **Gateway**. If the provider and local routing were configured correctly, CC Switch automatically fills the Gateway base URL, API key, and authentication scheme. + +Do not enter or change anything on this page. Click **Apply locally** at the bottom. + +
+ The Claude Desktop third-party inference page contains local Gateway settings supplied by CC Switch and an Apply locally button +
After confirming that CC Switch supplied the settings, leave the generated Gateway fields unchanged and click Apply locally.
+
-On Windows, check the system tray and choose Quit if necessary. On macOS, use `Command + Q`. Keep CC Switch and its routing service running when you reopen the app. +Claude Desktop will now send inference requests through the CC Switch local gateway. Keep CC Switch and local routing running while you use it. Treat the Gateway API key as sensitive even when CC Switch generated it automatically. Do not publish screenshots that reveal it or share it with anyone. ## Verify the complete route -Start a new conversation in the Claude Code App and send: +Start a new conversation in Claude Desktop and send: ```text Reply only: Token Station test succeeded @@ -160,7 +207,7 @@ A response in the app and a matching Token Station record together prove that th ## Switch back to the original provider -Keep the official provider instead of overwriting it. To restore it, select the original provider, click Apply or Switch, turn off the Token Station route if it is no longer needed, fully quit the Claude Code App, and reopen it. +Keep the official provider instead of overwriting it. To restore it, select the original provider, click Apply or Switch, turn off the Token Station route if it is no longer needed, fully quit Claude Desktop, and reopen it. ## Troubleshooting @@ -174,7 +221,7 @@ Edit the provider, enable **Needs model mapping**, and verify that Sonnet, Opus, ### Local routing is off -Open **Settings → Routing**, start the routing service, enable Claude routing, and turn on the local routing switch in the Claude Code panel. +Open **Settings → Routing**, start the routing service, enable Claude routing, and turn on the local routing switch in the Claude Desktop panel. ### CC Switch is not running @@ -201,11 +248,11 @@ The request may still be using the original service. Check the active provider, - Keep real API keys out of tutorial screenshots - Do not commit CC Switch configuration files or credentials to Git - Revoke and replace a key immediately if it may have leaked -- Back up a working provider before upgrading CC Switch or the Claude Code App +- Back up a working provider before upgrading CC Switch or Claude Desktop ## Summary -This setup depends on four parts working together: a Token Station provider, **Needs model mapping**, CC Switch local and Claude routing, and a complete restart of the Claude Code App. Verify the result in the Token Station activity log so you know which service and model handled the request. +This setup depends on four parts working together: a Token Station provider, **Needs model mapping**, CC Switch local and Claude routing, and a complete restart of Claude Desktop. Verify the result in the Token Station activity log so you know which service and model handled the request. ## References diff --git a/src/content/writings/ja/configure-claude-code-app-with-cc-switch-and-token-station.md b/src/content/writings/ja/configure-claude-code-app-with-cc-switch-and-token-station.md index 3503c6d..e2c7b9c 100644 --- a/src/content/writings/ja/configure-claude-code-app-with-cc-switch-and-token-station.md +++ b/src/content/writings/ja/configure-claude-code-app-with-cc-switch-and-token-station.md @@ -1,8 +1,8 @@ --- slug: "configure-claude-code-app-with-cc-switch-and-token-station" lang: "ja" -title: "CC Switch と Token Station で Claude Code App を設定する" -summary: "Claude Code App 用の Token Station Provider を作成し、モデルマッピング、CC Switch のローカルルーティング、Claude ルーティングを有効にして、実際のリクエストで経路全体を検証します。" +title: "CC Switch と Token Station で Claude Desktop を設定する" +summary: "CC Switch の概要とインストール方法を確認し、Claude Desktop 用の Token Station Provider、モデルマッピング、ローカルルーティングを設定して経路全体を検証します。" category: "tutorial" date: "2026-08-17" cta: "https://models.bytefuture.ai/intro.html" @@ -10,39 +10,61 @@ cover: "blog/configure-claude-code-app-with-cc-switch-and-token-station-cover.pn draft: false --- -CC Switch を使うと、複数の Claude Code Provider を保存し、設定ファイルを何度も手作業で変更せずにサービスを切り替えられます。本記事では Claude Code App を Token Station に接続し、Claude の Sonnet、Opus、Haiku ロールを Token Station で利用可能なモデルへ割り当て、CC Switch のローカルサービス経由でリクエストを転送します。 +本記事では CC Switch をインストールし、Claude Desktop を Token Station に接続する方法を説明します。設定後は、Claude Desktop が要求する Sonnet、Opus、Haiku ロールを CC Switch が Token Station の指定モデルへ割り当てます。 -> 本記事は CC Switch の **Claude Code App** パネルを対象としています。Claude Desktop と Claude Code CLI は設定経路が異なるため、それらの手順をこの設定に流用しないでください。 +> 本記事は CC Switch の **Claude Desktop** パネルを対象としています。Claude Desktop と Claude Code CLI は設定経路が異なるため、Claude Code CLI の手順をこの設定に流用しないでください。 + +## CC Switch をインストールする + +[CC Switch](https://github.com/farion1231/cc-switch) は、AI ツールの Provider を管理するデスクトップアプリです。Claude Desktop、Claude Code、Codex、Gemini CLI などに対応しています。 + +これらのツールを直接設定する場合、通常はツールごとに設定ファイルや環境変数を変更する必要があります。CC Switch はツールと Provider を一つの画面にまとめ、複数の設定を保存して、API URL や Key を何度も入力せずに切り替えられるようにします。 + +macOS では Homebrew からインストールできます。 + +```bash +brew install --cask cc-switch +``` + +Windows、Linux、または手動でインストールする macOS ユーザーは、[CC Switch Releases](https://github.com/farion1231/cc-switch/releases) から使用中のシステムに合うパッケージをダウンロードし、リリースページの手順に従ってインストールしてください。 ## 準備するもの -- CC Switch と Claude Code App +- インストール済みで起動できる CC Switch +- インストール済みで起動できる Claude Desktop - 有効な Token Station API Key - 利用するモデルへのアクセス権と利用可能なクレジット -[Token Station ダッシュボード](https://models.bytefuture.ai/dashboard)を開き、完全なモデル ID を確認します。API Key をスクリーンショット、チャット、Git リポジトリに含めないでください。 +[Token Station ダッシュボード](https://models.bytefuture.ai/dashboard)を開き、API Key をコピーして、利用するモデルの完全な ID を確認します。API Key をスクリーンショット、チャット、Git リポジトリに含めないでください。 ## 設定の流れ 必要な手順は次のとおりです。 -1. CC Switch で Claude Code Provider を作成する +1. CC Switch で Claude Desktop Provider を作成する 2. Token Station の URL と API Key を入力する 3. **Needs model mapping** を有効にする 4. Sonnet、Opus、Haiku を Token Station のモデル ID に割り当てる 5. CC Switch のローカルルーティングと Claude ルーティングを有効にする -6. Provider を有効にし、Claude Code App を完全に再起動する +6. Provider を有効にし、Claude Desktop を完全に再起動する 7. リクエストを送信し、Token Station で記録を確認する モデルマッピングやローカルルーティングを省略すると、CC Switch に Token Station が現在の Provider と表示されていても、App が以前のサービスを使い続けることがあります。 ## Token Station Provider を追加する -CC Switch のバージョンによってボタン名は多少異なりますが、必要な設定値は同じです。 - ### 1. Provider を作成する -CC Switch を開き、**Claude Code** を選択して Provider 管理画面に進みます。Add、New Provider、またはプラスボタンをクリックし、分かりやすい名前を付けます。 +CC Switch を開き、上部ツールバーの **Claude Desktop** を選択して Provider 管理画面に進みます。Add、New Provider、またはプラスボタンをクリックします。 + +
+ CC Switch の上部ツールバーで Claude Desktop が選択され、Claude Desktop Official Provider が表示されている画面 +
CC Switch の上部ツールバーで Claude Desktop を選択します。
+
+ +### 2. 接続情報を入力する + +分かりやすい Provider 名を付けます。 ```text Token Station @@ -50,8 +72,6 @@ Token Station Provider の種類や API 形式を求められた場合は、Claude、Anthropic、または **Anthropic Messages（native）** を選択します。 -### 2. 接続情報を入力する - | 項目 | 設定値 | | --- | --- | | Request URL / Base URL | `https://models.bytefuture.ai` | @@ -78,7 +98,7 @@ ANTHROPIC_MODEL=<完全なモデル ID> ### 3. Needs model mapping を必ず有効にする -**Needs model mapping** は必ず有効にします。Claude Code App は Sonnet、Opus、Haiku などの Claude ロールでモデルを要求します。CC Switch がこれらのロールを、Token Station が認識する完全なモデル ID に変換する必要があります。 +**Needs model mapping** は必ず有効にします。Claude Desktop は Sonnet、Opus、Haiku などの Claude ロールでモデルを要求します。CC Switch がこれらのロールを、Token Station が認識する完全なモデル ID に変換する必要があります。
Needs model mapping オプションを有効にした CC Switch の Provider フォーム @@ -113,36 +133,63 @@ openai/gpt-5.6-sol 2. **Show local routing switch on the home page** を有効にする 3. ルーティングのマスタースイッチを起動した状態にする 4. ルーティング対象の **Claude** を有効にする -5. Claude Code パネルへ戻り、ローカルルーティングのトグルを On にする +5. Claude Desktop パネルへ戻り、ローカルルーティングのトグルを On にする
ローカルルーティングが稼働し、Claude ルーティングが有効になっている CC Switch のルーティング設定
ルーティングサービスを稼働させ、ホーム画面のスイッチと Claude ルーティングを有効にします。
-この経路を使う間は CC Switch を起動したままにしてください。CC Switch を終了するとローカルゲートウェイも停止し、この設定では Claude Code App から Token Station に接続できなくなります。 - -実際のリクエスト経路は次のとおりです。 - -```text -Claude Code App - → CC Switch local routing - → model mapping - → Token Station - → selected model -``` +この経路を使う間は CC Switch を起動したままにしてください。CC Switch を終了するとローカルゲートウェイも停止し、この設定では Claude Desktop から Token Station に接続できなくなります。 ## 保存、有効化、再起動 保存前に、URL に余分なパスがないこと、API Key の前後に空白がないこと、**Needs model mapping** が有効なこと、各モデル ID に Provider プレフィックスが含まれることを確認します。 -Provider を保存し、**Token Station** を選択して Enable、Apply、または Switch をクリックします。その後、Claude Code App を完全に終了してから再度開きます。ウィンドウを閉じただけでは、古い設定を保持したプロセスが残る場合があります。 +Provider を保存し、**Token Station** を選択して Enable、Apply、または Switch をクリックします。その後、Claude Desktop を完全に終了してから再度開きます。ウィンドウを閉じただけでは、古い設定を保持したプロセスが残る場合があります。 + +Windows ではシステムトレイを確認し、必要なら Quit を選びます。macOS では `Command + Q` を使います。Claude Desktop の再起動時も CC Switch とルーティングサービスを稼働させてください。 + +## Anthropic アカウントなしで Claude Desktop を使う + +CC Switch の設定後は、Anthropic アカウントにログインせず、Claude Desktop のサードパーティ推論機能からローカルゲートウェイへ接続できます。以下は Windows 版の手順です。OS やバージョンによってメニュー位置が多少異なる場合があります。 + +### 1. Developer Mode を有効にする + +Claude Desktop 左上のメニューを開き、**Help → Troubleshooting → Enable Developer Mode** を選択します。 + +
+ Claude Desktop の Help メニューで Troubleshooting を開き、Enable Developer Mode を選択している画面 +
Help → Troubleshooting から Enable Developer Mode を選択します。
+
+ +有効にすると、メインメニューに **Developer** が表示されます。すぐに表示されない場合は、Claude Desktop を完全に終了して再度開いてください。 + +### 2. サードパーティ推論設定を開く + +左上のメニューから **Developer → Configure Third-Party Inference...** を選択します。 + +
+ Claude Desktop の Developer メニューで Configure Third-Party Inference を選択している画面 +
Developer メニューからサードパーティ推論設定を開きます。
+
+ +### 3. CC Switch の設定を適用する + +設定画面の右上に **CC Switch** と表示され、Connection が **Gateway** になっていることを確認します。Provider とローカルルーティングが正しく設定されていれば、Gateway base URL、API Key、認証方式は CC Switch によって自動入力されます。 + +この画面では何も入力、変更せず、下部の **Apply locally** をクリックします。 + +
+ CC Switch がローカル Gateway 情報を入力した Claude Desktop のサードパーティ推論設定画面と Apply locally ボタン +
設定元が CC Switch であることを確認し、自動生成された Gateway 情報を変更せずに Apply locally をクリックします。
+
-Windows ではシステムトレイを確認し、必要なら Quit を選びます。macOS では `Command + Q` を使います。App の再起動時も CC Switch とルーティングサービスを稼働させてください。 +適用後、Claude Desktop は CC Switch のローカルゲートウェイ経由で推論リクエストを送信します。利用中は CC Switch とローカルルーティングを稼働させてください。自動生成された Gateway API Key も機密情報です。表示された状態のスクリーンショットを公開したり、第三者に共有したりしないでください。 ## 経路全体を検証する -Claude Code App で新しい会話を開始し、次を送信します。 +Claude Desktop で新しい会話を開始し、次を送信します。 ```text 「Token Station テスト成功」とだけ返信してください @@ -158,7 +205,7 @@ App の応答と一致する Token Station の記録がそろって、初めて ## 元の Provider に戻す -公式 Provider は上書きせず残しておきます。戻す場合は元の Provider を選び、Apply または Switch をクリックします。Token Station の経路が不要なら関連するルーティングを無効にし、Claude Code App を完全に終了して再度開きます。 +公式 Provider は上書きせず残しておきます。戻す場合は元の Provider を選び、Apply または Switch をクリックします。Token Station の経路が不要なら関連するルーティングを無効にし、Claude Desktop を完全に終了して再度開きます。 ## トラブルシューティング @@ -172,7 +219,7 @@ Provider を編集して **Needs model mapping** を有効にし、Sonnet、Opus ### ローカルルーティングが無効になっている -**Settings → Routing** でルーティングサービスを開始し、Claude ルーティングを有効にします。Claude Code パネルに戻り、ローカルルーティングのスイッチも有効にします。 +**Settings → Routing** でルーティングサービスを開始し、Claude ルーティングを有効にします。Claude Desktop パネルに戻り、ローカルルーティングのスイッチも有効にします。 ### CC Switch が起動していない @@ -199,11 +246,11 @@ Token Station から完全なモデル ID をコピーし、対応する Sonnet - 実際の API Key をチュートリアルのスクリーンショットに含めない - CC Switch の設定や認証情報を Git にコミットしない - 漏えいの可能性があれば、すぐに Key を無効化して再発行する -- CC Switch や Claude Code App の更新前に、動作する Provider をバックアップする +- CC Switch や Claude Desktop の更新前に、動作する Provider をバックアップする ## まとめ -この設定には Token Station Provider、**Needs model mapping**、CC Switch のローカルルーティングと Claude ルーティング、Claude Code App の完全な再起動という 4 つの要素が必要です。最後に Token Station のアクティビティログを確認し、実際にどのサービスとモデルがリクエストを処理したかを確かめてください。 +この設定には Token Station Provider、**Needs model mapping**、CC Switch のローカルルーティングと Claude ルーティング、Claude Desktop の完全な再起動という 4 つの要素が必要です。最後に Token Station のアクティビティログを確認し、実際にどのサービスとモデルがリクエストを処理したかを確かめてください。 ## 参考資料 diff --git a/src/content/writings/ko/configure-claude-code-app-with-cc-switch-and-token-station.md b/src/content/writings/ko/configure-claude-code-app-with-cc-switch-and-token-station.md index e2786c4..dc8689f 100644 --- a/src/content/writings/ko/configure-claude-code-app-with-cc-switch-and-token-station.md +++ b/src/content/writings/ko/configure-claude-code-app-with-cc-switch-and-token-station.md @@ -1,8 +1,8 @@ --- slug: "configure-claude-code-app-with-cc-switch-and-token-station" lang: "ko" -title: "CC Switch와 Token Station으로 Claude Code App 설정하기" -summary: "Claude Code App용 Token Station Provider를 만들고 모델 매핑, CC Switch 로컬 라우팅, Claude 라우팅을 활성화한 뒤 실제 요청으로 전체 경로를 검증합니다." +title: "CC Switch와 Token Station으로 Claude Desktop 설정하기" +summary: "CC Switch를 알아보고 설치한 뒤 Claude Desktop용 Token Station Provider, 모델 매핑, 로컬 라우팅을 설정하고 전체 경로를 검증합니다." category: "tutorial" date: "2026-08-17" cta: "https://models.bytefuture.ai/intro.html" @@ -10,41 +10,63 @@ cover: "blog/configure-claude-code-app-with-cc-switch-and-token-station-cover.pn draft: false --- -CC Switch를 사용하면 여러 Claude Code Provider를 저장하고 설정 파일을 반복해서 직접 수정하지 않고도 서비스를 전환할 수 있습니다. 이 글에서는 Claude Code App을 Token Station에 연결하고 Claude의 Sonnet, Opus, Haiku 역할을 Token Station에서 사용할 수 있는 모델에 매핑한 다음, CC Switch의 로컬 서비스를 통해 요청을 전달합니다. +이 글에서는 CC Switch를 설치하고 Claude Desktop을 Token Station에 연결하는 방법을 설명합니다. 설정이 완료되면 Claude Desktop이 요청하는 Sonnet, Opus, Haiku 역할을 CC Switch가 Token Station의 지정 모델에 매핑합니다. -> 이 글은 CC Switch의 **Claude Code App** 패널을 대상으로 합니다. Claude Desktop과 Claude Code CLI는 설정 경로가 다르므로 해당 지침을 이 설정에 그대로 적용하지 마세요. +> 이 글은 CC Switch의 **Claude Desktop** 패널을 대상으로 합니다. Claude Desktop과 Claude Code CLI는 설정 경로가 다르므로 Claude Code CLI 지침을 이 설정에 그대로 적용하지 마세요. + +## CC Switch 설치하기 + +[CC Switch](https://github.com/farion1231/cc-switch)는 AI 도구의 Provider를 관리하는 데스크톱 앱입니다. Claude Desktop, Claude Code, Codex, Gemini CLI 등의 도구를 지원합니다. + +이러한 도구를 직접 설정하려면 일반적으로 도구마다 별도의 설정 파일이나 환경 변수를 수정해야 합니다. CC Switch는 도구와 Provider를 하나의 그래픽 화면에 모아 여러 설정을 저장하고, API URL과 Key를 반복해서 입력하지 않고 전환할 수 있게 합니다. + +macOS 사용자는 Homebrew로 설치할 수 있습니다. + +```bash +brew install --cask cc-switch +``` + +Windows, Linux 또는 수동 설치를 원하는 macOS 사용자는 [CC Switch Releases](https://github.com/farion1231/cc-switch/releases)에서 현재 시스템에 맞는 패키지를 내려받고 릴리스 페이지의 안내에 따라 설치하세요. ## 시작하기 전에 다음을 준비하세요. -- CC Switch와 Claude Code App +- 설치되어 정상적으로 열리는 CC Switch +- 설치되어 정상적으로 실행되는 Claude Desktop - 유효한 Token Station API Key - 사용할 모델에 대한 접근 권한과 사용 가능한 크레딧 -[Token Station 대시보드](https://models.bytefuture.ai/dashboard)를 열고 전체 모델 ID를 확인합니다. API Key를 스크린샷, 채팅 메시지, Git 저장소에 노출하지 마세요. +[Token Station 대시보드](https://models.bytefuture.ai/dashboard)를 열어 API Key를 복사하고 사용할 모델의 전체 ID를 확인합니다. API Key를 스크린샷, 채팅 메시지, Git 저장소에 노출하지 마세요. ## 전체 설정 흐름 필요한 단계는 다음과 같습니다. -1. CC Switch에서 Claude Code Provider 만들기 +1. CC Switch에서 Claude Desktop Provider 만들기 2. Token Station URL과 API Key 입력하기 3. **Needs model mapping** 켜기 4. Sonnet, Opus, Haiku를 Token Station 모델 ID에 매핑하기 5. CC Switch 로컬 라우팅과 Claude 라우팅 켜기 -6. Provider를 활성화하고 Claude Code App을 완전히 재시작하기 +6. Provider를 활성화하고 Claude Desktop을 완전히 재시작하기 7. 요청을 보내고 Token Station에서 기록 확인하기 모델 매핑이나 로컬 라우팅을 빠뜨리면 CC Switch에 Token Station이 현재 Provider로 표시되어도 App이 이전 서비스를 계속 사용할 수 있습니다. ## Token Station Provider 추가하기 -CC Switch 버전에 따라 버튼 이름이 조금 다를 수 있지만 필수 설정은 같습니다. - ### 1. Provider 만들기 -CC Switch를 열고 **Claude Code**를 선택한 뒤 Provider 관리 화면으로 이동합니다. Add, New Provider 또는 더하기 버튼을 클릭하고 알아보기 쉬운 이름을 입력합니다. +CC Switch를 열고 상단 도구 모음에서 **Claude Desktop**을 선택한 뒤 Provider 관리 화면으로 이동합니다. Add, New Provider 또는 더하기 버튼을 클릭합니다. + +
+ CC Switch 상단 도구 모음에서 Claude Desktop이 선택되어 있고 Claude Desktop Official Provider가 표시된 화면 +
CC Switch 상단 도구 모음에서 Claude Desktop을 선택합니다.
+
+ +### 2. 연결 설정 입력하기 + +알아보기 쉬운 Provider 이름을 사용하세요. ```text Token Station @@ -52,8 +74,6 @@ Token Station Provider 유형이나 API 형식을 선택해야 한다면 Claude, Anthropic 또는 **Anthropic Messages (native)**를 선택합니다. -### 2. 연결 설정 입력하기 - | 항목 | 설정값 | | --- | --- | | Request URL / Base URL | `https://models.bytefuture.ai` | @@ -80,7 +100,7 @@ ANTHROPIC_MODEL=<전체 모델 ID 입력> ### 3. Needs model mapping을 반드시 켜기 -**Needs model mapping**은 반드시 켜야 합니다. Claude Code App은 Sonnet, Opus, Haiku 같은 Claude 역할로 모델을 요청합니다. CC Switch가 이 역할을 Token Station이 인식하는 전체 모델 ID로 변환해야 합니다. +**Needs model mapping**은 반드시 켜야 합니다. Claude Desktop은 Sonnet, Opus, Haiku 같은 Claude 역할로 모델을 요청합니다. CC Switch가 이 역할을 Token Station이 인식하는 전체 모델 ID로 변환해야 합니다.
Needs model mapping 옵션을 활성화한 CC Switch Provider 양식 @@ -115,36 +135,63 @@ openai/gpt-5.6-sol 2. **Show local routing switch on the home page** 켜기 3. 라우팅 마스터 스위치를 실행 상태로 유지하기 4. 라우팅 대상에서 **Claude** 활성화하기 -5. Claude Code 패널로 돌아가 로컬 라우팅 토글을 On으로 전환하기 +5. Claude Desktop 패널로 돌아가 로컬 라우팅 토글을 On으로 전환하기
로컬 라우팅이 실행 중이고 Claude 라우팅이 활성화된 CC Switch 라우팅 설정
라우팅 서비스를 실행 상태로 유지하고 홈 화면 스위치와 Claude 라우팅을 활성화합니다.
-이 경로를 사용하는 동안 CC Switch를 계속 실행해야 합니다. CC Switch를 종료하면 로컬 게이트웨이가 중지되고 Claude Code App은 이 설정을 통해 Token Station에 접근할 수 없습니다. - -실제 요청 경로는 다음과 같습니다. - -```text -Claude Code App - → CC Switch local routing - → model mapping - → Token Station - → selected model -``` +이 경로를 사용하는 동안 CC Switch를 계속 실행해야 합니다. CC Switch를 종료하면 로컬 게이트웨이가 중지되고 Claude Desktop은 이 설정을 통해 Token Station에 접근할 수 없습니다. ## 저장, 활성화, 재시작 저장하기 전에 URL에 불필요한 경로가 없는지, API Key 앞뒤에 공백이 없는지, **Needs model mapping**이 켜져 있는지, 각 모델 ID에 Provider 접두사가 포함되어 있는지 확인합니다. -Provider를 저장하고 **Token Station**을 선택한 뒤 Enable, Apply 또는 Switch를 클릭합니다. 그런 다음 Claude Code App을 완전히 종료하고 다시 엽니다. 창만 닫으면 이전 설정을 유지하는 프로세스가 남을 수 있습니다. +Provider를 저장하고 **Token Station**을 선택한 뒤 Enable, Apply 또는 Switch를 클릭합니다. 그런 다음 Claude Desktop을 완전히 종료하고 다시 엽니다. 창만 닫으면 이전 설정을 유지하는 프로세스가 남을 수 있습니다. + +Windows에서는 시스템 트레이를 확인하고 필요하면 Quit을 선택합니다. macOS에서는 `Command + Q`를 사용합니다. Claude Desktop을 다시 열 때도 CC Switch와 라우팅 서비스가 실행 중이어야 합니다. + +## Anthropic 계정 없이 Claude Desktop 사용하기 + +CC Switch 설정을 마치면 Anthropic 계정에 먼저 로그인하지 않고 Claude Desktop의 타사 추론 기능을 통해 로컬 게이트웨이에 연결할 수 있습니다. 아래 단계는 Windows용 Claude Desktop을 기준으로 하며, 운영체제나 버전에 따라 메뉴 위치가 조금 다를 수 있습니다. + +### 1. Developer Mode 활성화하기 + +Claude Desktop 왼쪽 위 메뉴를 열고 **Help → Troubleshooting → Enable Developer Mode**를 선택합니다. + +
+ Claude Desktop Help 메뉴에서 Troubleshooting을 펼치고 Enable Developer Mode를 선택한 화면 +
Help → Troubleshooting에서 Enable Developer Mode를 선택합니다.
+
+ +활성화하면 메인 메뉴에 **Developer** 항목이 나타납니다. 바로 표시되지 않으면 Claude Desktop을 완전히 종료한 뒤 다시 여세요. + +### 2. 타사 추론 설정 열기 + +왼쪽 위 메뉴에서 **Developer → Configure Third-Party Inference...**를 선택합니다. + +
+ Claude Desktop Developer 메뉴에서 Configure Third-Party Inference를 선택한 화면 +
Developer 메뉴에서 타사 추론 설정을 엽니다.
+
+ +### 3. CC Switch 설정 적용하기 + +설정 화면 오른쪽 위에 **CC Switch**가 표시되고 Connection이 **Gateway**로 설정되어 있는지 확인합니다. Provider와 로컬 라우팅이 올바르게 구성되었다면 Gateway base URL, API Key, 인증 방식은 CC Switch가 자동으로 입력합니다. + +이 화면에서는 아무것도 입력하거나 변경하지 말고 아래쪽의 **Apply locally**를 클릭합니다. + +
+ CC Switch가 로컬 Gateway 정보를 입력한 Claude Desktop 타사 추론 설정 화면과 Apply locally 버튼 +
설정 출처가 CC Switch인지 확인한 뒤 자동 생성된 Gateway 정보를 변경하지 말고 Apply locally를 클릭합니다.
+
-Windows에서는 시스템 트레이를 확인하고 필요하면 Quit을 선택합니다. macOS에서는 `Command + Q`를 사용합니다. App을 다시 열 때도 CC Switch와 라우팅 서비스가 실행 중이어야 합니다. +적용 후 Claude Desktop은 CC Switch 로컬 게이트웨이를 통해 추론 요청을 보냅니다. 사용하는 동안 CC Switch와 로컬 라우팅을 계속 실행하세요. 자동 생성된 Gateway API Key도 민감한 정보이므로 키가 보이는 스크린샷을 공개하거나 다른 사람과 공유하지 마세요. ## 전체 경로 검증하기 -Claude Code App에서 새 대화를 시작하고 다음을 전송합니다. +Claude Desktop에서 새 대화를 시작하고 다음을 전송합니다. ```text Token Station 테스트 성공이라고만 답하세요 @@ -160,7 +207,7 @@ App의 응답과 일치하는 Token Station 기록이 모두 있어야 전체 ## 원래 Provider로 되돌리기 -공식 Provider를 덮어쓰지 말고 그대로 보관하세요. 복원하려면 원래 Provider를 선택하고 Apply 또는 Switch를 클릭합니다. Token Station 경로가 더 이상 필요 없다면 관련 라우팅을 끄고 Claude Code App을 완전히 종료한 다음 다시 엽니다. +공식 Provider를 덮어쓰지 말고 그대로 보관하세요. 복원하려면 원래 Provider를 선택하고 Apply 또는 Switch를 클릭합니다. Token Station 경로가 더 이상 필요 없다면 관련 라우팅을 끄고 Claude Desktop을 완전히 종료한 다음 다시 엽니다. ## 문제 해결 @@ -174,7 +221,7 @@ Provider를 편집해 **Needs model mapping**을 켜고 Sonnet, Opus, Haiku가 ### 로컬 라우팅이 꺼져 있음 -**Settings → Routing**에서 라우팅 서비스를 시작하고 Claude 라우팅을 활성화합니다. Claude Code 패널로 돌아가 로컬 라우팅 스위치도 켭니다. +**Settings → Routing**에서 라우팅 서비스를 시작하고 Claude 라우팅을 활성화합니다. Claude Desktop 패널로 돌아가 로컬 라우팅 스위치도 켭니다. ### CC Switch가 실행 중이 아님 @@ -201,11 +248,11 @@ Token Station에서 전체 모델 ID를 복사하고 해당 Sonnet, Opus, Haiku - 실제 API Key를 튜토리얼 스크린샷에 포함하지 마세요 - CC Switch 설정 파일이나 인증 정보를 Git에 커밋하지 마세요 - 유출 가능성이 있으면 Key를 즉시 폐기하고 새로 발급하세요 -- CC Switch 또는 Claude Code App을 업그레이드하기 전에 작동하는 Provider를 백업하세요 +- CC Switch 또는 Claude Desktop을 업그레이드하기 전에 작동하는 Provider를 백업하세요 ## 정리 -이 설정은 Token Station Provider, **Needs model mapping**, CC Switch 로컬 라우팅과 Claude 라우팅, Claude Code App의 완전한 재시작이라는 네 요소가 함께 작동해야 합니다. 마지막으로 Token Station 활동 로그에서 요청을 확인해 실제로 어떤 서비스와 모델이 처리했는지 검증하세요. +이 설정은 Token Station Provider, **Needs model mapping**, CC Switch 로컬 라우팅과 Claude 라우팅, Claude Desktop의 완전한 재시작이라는 네 요소가 함께 작동해야 합니다. 마지막으로 Token Station 활동 로그에서 요청을 확인해 실제로 어떤 서비스와 모델이 처리했는지 검증하세요. ## 참고 자료 diff --git a/src/content/writings/zh/configure-claude-code-app-with-cc-switch-and-token-station.md b/src/content/writings/zh/configure-claude-code-app-with-cc-switch-and-token-station.md index acb9e38..d56433b 100644 --- a/src/content/writings/zh/configure-claude-code-app-with-cc-switch-and-token-station.md +++ b/src/content/writings/zh/configure-claude-code-app-with-cc-switch-and-token-station.md @@ -1,8 +1,8 @@ --- slug: "configure-claude-code-app-with-cc-switch-and-token-station" lang: "zh" -title: "用 CC Switch 和 Token Station 配置 Claude Code App" -summary: "为 Claude Code App 配置 Token Station Provider，开启模型映射、CC Switch 本地路由和 Claude 路由，再通过真实请求验证完整链路。" +title: "用 CC Switch 和 Token Station 配置 Claude Desktop" +summary: "了解并安装 CC Switch，然后为 Claude Desktop 配置 Token Station Provider、模型映射和本地路由，并通过真实请求验证完整链路。" category: "tutorial" date: "2026-08-17" cta: "https://models.bytefuture.ai/intro.html" @@ -10,41 +10,63 @@ cover: "blog/configure-claude-code-app-with-cc-switch-and-token-station-cover.pn draft: false --- -CC Switch 可以保存多组 Claude Code Provider，让你在不同服务之间切换，而不必反复手动修改配置文件。本文将 Claude Code App 接入 Token Station，把 Claude 的 Sonnet、Opus 和 Haiku 角色映射到 Token Station 中可用的模型，并通过 CC Switch 的本地服务转发请求。 +本文介绍如何安装 CC Switch，并用它把 Claude Desktop 接入 Token Station。配置完成后，Claude Desktop 发出的 Sonnet、Opus 和 Haiku 请求会由 CC Switch 映射到 Token Station 中的指定模型。 -> 本文针对 CC Switch 中的 **Claude Code App** 面板。Claude Desktop 和 Claude Code CLI 使用不同的配置路径，不要直接套用它们的步骤。 +> 本文针对 CC Switch 中的 **Claude Desktop** 面板。Claude Desktop 和 Claude Code CLI 使用不同的配置路径，不要直接套用 Claude Code CLI 的配置步骤。 + +## 安装 CC Switch + +[CC Switch](https://github.com/farion1231/cc-switch) 是一个用于管理 AI 工具 Provider 的桌面应用，支持 Claude Desktop、Claude Code、Codex 和 Gemini CLI 等工具。 + +如果直接配置这些工具，通常需要分别修改配置文件或环境变量。CC Switch 将不同工具和 Provider 集中到一个图形界面中，可以保存多组配置，并在需要时快速切换，不必反复输入 API 地址和密钥。 + +macOS 用户可以通过 Homebrew 安装： + +```bash +brew install --cask cc-switch +``` + +Windows、Linux 或需要手动安装的 macOS 用户，可以前往 [CC Switch Releases](https://github.com/farion1231/cc-switch/releases)，下载适用于当前系统的安装包，并按照 Release 页面中的说明完成安装。 ## 开始之前 请准备： -- 已安装的 CC Switch 和 Claude Code App +- 已安装并能正常打开的 CC Switch +- 已安装并能正常启动的 Claude Desktop - 有效的 Token Station API Key - 目标模型的调用权限和可用额度 -打开 [Token Station 控制台](https://models.bytefuture.ai/dashboard)，复制模型的完整 ID。不要在截图、聊天记录或 Git 仓库中暴露真实 API Key。 +打开 [Token Station 控制台](https://models.bytefuture.ai/dashboard)，复制 API Key，并确认准备使用的模型完整 ID。不要在截图、聊天记录或 Git 仓库中暴露真实 API Key。 ## 完整配置流程 整个过程包括： -1. 在 CC Switch 中新建 Claude Code Provider +1. 在 CC Switch 中新建 Claude Desktop Provider 2. 填写 Token Station 地址和 API Key 3. 开启 **需要模型映射（Needs model mapping）** 4. 将 Sonnet、Opus、Haiku 映射到 Token Station 模型 ID 5. 开启 CC Switch 本地路由和 Claude 路由 -6. 启用 Provider，并完全重启 Claude Code App +6. 启用 Provider，并完全重启 Claude Desktop 7. 发起真实请求，在 Token Station 中核对记录 -如果遗漏模型映射或本地路由，即使 CC Switch 显示 Token Station 是当前 Provider，App 仍可能继续使用原来的服务。 +如果遗漏模型映射或本地路由，即使 CC Switch 显示 Token Station 是当前 Provider，Claude Desktop 仍可能继续使用原来的服务。 ## 添加 Token Station Provider -不同版本的 CC Switch 按钮名称可能略有不同，但核心设置一致。 - ### 1. 新建 Provider -打开 CC Switch，选择 **Claude Code**，进入 Provider 管理页，然后点击“添加”“新建 Provider”或加号按钮。建议使用容易辨认的名称： +打开 CC Switch，选择顶部工具栏中的 **Claude Desktop**，进入 Provider 管理页，然后点击“添加”“新建 Provider”或加号按钮。 + +
+ CC Switch 顶部工具栏中已选中 Claude Desktop，页面显示 Claude Desktop Official Provider +
在 CC Switch 顶部工具栏中选择 Claude Desktop。
+
+ +### 2. 填写连接设置 + +建议使用容易辨认的名称： ```text Token Station @@ -52,8 +74,6 @@ Token Station 如果界面要求选择 Provider 类型或 API 格式，请选择 Claude、Anthropic 或 **Anthropic Messages（原生）**。 -### 2. 填写连接设置 - | 字段 | 填写内容 | | --- | --- | | 请求地址 / Base URL | `https://models.bytefuture.ai` | @@ -80,7 +100,7 @@ ANTHROPIC_MODEL=<完整模型 ID> ### 3. 必须开启“需要模型映射” -**需要模型映射（Needs model mapping）** 必须保持开启。Claude Code App 会以 Sonnet、Opus、Haiku 等 Claude 角色请求模型，CC Switch 需要把这些角色转换成 Token Station 能识别的完整模型 ID。 +**需要模型映射（Needs model mapping）** 必须保持开启。Claude Desktop 会以 Sonnet、Opus、Haiku 等 Claude 角色请求模型，CC Switch 需要把这些角色转换成 Token Station 能识别的完整模型 ID。
CC Switch Provider 表单中已开启需要模型映射选项 @@ -115,36 +135,63 @@ openai/gpt-5.6-sol 2. 开启 **在主页显示本地路由开关** 3. 启动并保持路由总开关运行 4. 在路由启用列表中打开 **Claude** -5. 回到 Claude Code 面板，把本地路由开关切换为 On +5. 回到 Claude Desktop 面板，把本地路由开关切换为 On
CC Switch 路由设置，本地路由正在运行，并已启用 Claude 路由
保持路由服务运行，显示主页开关，并明确启用 Claude 路由。
-使用这条链路期间，CC Switch 必须保持运行。退出 CC Switch 会停止本地网关，Claude Code App 也就无法通过该配置访问 Token Station。 - -实际请求路径是： - -```text -Claude Code App - → CC Switch local routing - → model mapping - → Token Station - → selected model -``` +使用这条链路期间，CC Switch 必须保持运行。退出 CC Switch 会停止本地网关，Claude Desktop 也就无法通过该配置访问 Token Station。 ## 保存、启用并重启 保存前确认：地址没有多余路径，API Key 前后没有空格，**需要模型映射** 已开启，并且每个模型 ID 都包含提供方前缀。 -保存 Provider，选择 **Token Station**，点击“启用”“应用”或“切换”。然后完全退出 Claude Code App 再重新打开。只关闭窗口可能仍会保留使用旧配置的后台进程。 +保存 Provider，选择 **Token Station**，点击“启用”“应用”或“切换”。然后完全退出 Claude Desktop 再重新打开。只关闭窗口可能仍会保留使用旧配置的后台进程。 + +Windows 用户应检查系统托盘，必要时选择“退出”；macOS 用户可以使用 `Command + Q`。重新打开 Claude Desktop 时，CC Switch 和路由服务都要保持运行。 + +## 无需 Anthropic 账号使用 Claude Desktop + +CC Switch 配置完成后，可以通过 Claude Desktop 的第三方推理功能连接本地网关，无需先登录 Anthropic 账号。下面以 Windows 版 Claude Desktop 为例；不同系统或版本的菜单位置可能略有差异。 + +### 1. 开启开发者模式 + +打开 Claude Desktop 左上角的菜单，依次选择 **Help → Troubleshooting → Enable Developer Mode**。 + +
+ Claude Desktop 的 Help 菜单中依次展开 Troubleshooting，并选中 Enable Developer Mode +
在 Help → Troubleshooting 中选择 Enable Developer Mode。
+
+ +开启后，主菜单中会出现 **Developer** 入口。如果没有立即显示，可以完全退出 Claude Desktop，再重新打开。 + +### 2. 打开第三方推理设置 + +在左上角菜单中选择 **Developer → Configure Third-Party Inference...**。 + +
+ Claude Desktop 的 Developer 菜单中选中 Configure Third-Party Inference +
通过 Developer 菜单打开第三方推理设置。
+
+ +### 3. 应用 CC Switch 配置 + +进入设置页后，确认右上角显示 **CC Switch**，Connection 选择 **Gateway**。如果前面的 Provider 和本地路由已经配置正确，Gateway base URL、API Key 和认证方式会由 CC Switch 自动写入。 + +此处无需手动填写或修改任何字段，直接点击页面底部的 **Apply locally**。 + +
+ Claude Desktop 的第三方推理设置页已由 CC Switch 填入本地 Gateway 信息，底部显示 Apply locally 按钮 +
确认配置来源为 CC Switch 后，不要修改自动生成的 Gateway 信息，直接点击 Apply locally。
+
-Windows 用户应检查系统托盘，必要时选择“退出”；macOS 用户可以使用 `Command + Q`。重新打开 App 时，CC Switch 和路由服务都要保持运行。 +应用完成后，Claude Desktop 会使用 CC Switch 的本地网关发送推理请求。使用期间应保持 CC Switch 和本地路由运行。Gateway API Key 属于敏感信息，即使由 CC Switch 自动生成，也不要截图公开或复制给他人。 ## 验证完整链路 -在 Claude Code App 中新建会话并发送： +在 Claude Desktop 中新建会话并发送： ```text 请只回复：Token Station 测试成功 @@ -156,17 +203,17 @@ Windows 用户应检查系统托盘，必要时选择“退出”；macOS 用户 - 请求状态为成功 - 实际记录的模型与 CC Switch 中的角色映射一致 -App 正常回复，并且 Token Station 出现匹配记录，才能证明整条链路已经生效。仅看到 CC Switch 的“当前 Provider”标签并不足以完成验证。 +Claude Desktop 正常回复，并且 Token Station 出现匹配记录，才能证明整条链路已经生效。仅看到 CC Switch 的“当前 Provider”标签并不足以完成验证。 ## 切回原 Provider -建议保留官方 Provider，不要覆盖唯一配置。需要恢复时，选择原 Provider，点击“应用”或“切换”；如果不再需要 Token Station 路由，可以关闭相应开关；然后完全退出并重新打开 Claude Code App。 +建议保留官方 Provider，不要覆盖唯一配置。需要恢复时，选择原 Provider，点击“应用”或“切换”；如果不再需要 Token Station 路由，可以关闭相应开关；然后完全退出并重新打开 Claude Desktop。 ## 常见问题 -### App 仍在使用旧 Provider +### Claude Desktop 仍在使用旧 Provider -完全退出 App，重新应用 Token Station Provider，确认本地路由和 Claude 路由均已开启，再启动 App。 +完全退出 Claude Desktop，重新应用 Token Station Provider，确认本地路由和 Claude 路由均已开启，再启动 Claude Desktop。 ### 没有开启模型映射 @@ -174,7 +221,7 @@ App 正常回复，并且 Token Station 出现匹配记录，才能证明整条 ### 本地路由未开启 -进入 **设置 → 路由**，启动路由服务，开启 Claude 路由，再回到 Claude Code 面板打开本地路由开关。 +进入 **设置 → 路由**，启动路由服务，开启 Claude 路由，再回到 Claude Desktop 面板打开本地路由开关。 ### CC Switch 没有运行 @@ -190,22 +237,22 @@ Base URL 应为 `https://models.bytefuture.ai`。删除手动追加的 `/message ### 返回模型不存在或无权限 -从 Token Station 复制完整模型 ID，并检查对应的 Sonnet、Opus 或 Haiku 映射。不要根据 App 的展示名称猜测模型 ID。 +从 Token Station 复制完整模型 ID，并检查对应的 Sonnet、Opus 或 Haiku 映射。不要根据 Claude Desktop 的展示名称猜测模型 ID。 -### App 有回复，但 Token Station 没有记录 +### Claude Desktop 有回复，但 Token Station 没有记录 -请求可能仍在使用原服务。逐项检查当前 Provider、模型映射、两个路由开关、App 是否已重启，以及 Token Station 账号和活动记录的时间筛选。 +请求可能仍在使用原服务。逐项检查当前 Provider、模型映射、两个路由开关、Claude Desktop 是否已重启，以及 Token Station 账号和活动记录的时间筛选。 ## 安全建议 - 不要在教程截图中显示真实 API Key - 不要把 CC Switch 配置文件或密钥提交到 Git - 密钥疑似泄露时，立即撤销并重新生成 -- 升级 CC Switch 或 Claude Code App 前备份可用 Provider +- 升级 CC Switch 或 Claude Desktop 前备份可用 Provider ## 总结 -这套配置需要四部分共同生效：Token Station Provider、**需要模型映射**、CC Switch 本地路由与 Claude 路由，以及 Claude Code App 的完全重启。最后应在 Token Station 活动记录中核对请求，确认实际处理请求的服务和模型。 +这套配置需要四部分共同生效：Token Station Provider、**需要模型映射**、CC Switch 本地路由与 Claude 路由，以及 Claude Desktop 的完全重启。最后应在 Token Station 活动记录中核对请求，确认实际处理请求的服务和模型。 ## 参考资料