[工具分享]CCSwitch 接入Claude 無限token

本期將會(huì)分享開源免費(fèi)的AI環(huán)境切換助手，同時(shí)以AgnesAI來給大家演示完整配置。

目前AgnesAI提供免費(fèi)Token使用，大家可完整體驗(yàn)整個(gè)流程。

1. 概念

CCSwitch 是一款開源免費(fèi)的跨平臺(tái)桌面 AI 環(huán)境切換助手，支持 Windows、macOS 和 Linux。它的核心作用是幫你統(tǒng)一管理多個(gè) AI 編程工具的 API 配置，實(shí)現(xiàn)一鍵切換。

簡(jiǎn)單來說，如果你同時(shí)使用 Claude Code、Codex、Gemini CLI 等多個(gè) AI 編程工具，每個(gè)工具都需要單獨(dú)配置 API Key 和模型參數(shù)——手動(dòng)改來改去非常麻煩。CCSwitch 就是解決這個(gè)痛點(diǎn)的工具：你只需要在 CCSwitch 里配置好各個(gè) Provider（供應(yīng)商），然后點(diǎn)一下就能切換，它會(huì)自動(dòng)把配置同步到對(duì)應(yīng)的 CLI 工具中。

CCSwitch 支持管理的 AI 工具包括：Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes Agent 等七大主流工具。它還內(nèi)置了 50 多個(gè)預(yù)設(shè) Provider 配置，覆蓋了主流的中外模型服務(wù)商。

本文將以 Claude Code + CCSwitch + Agnes-2.0-Flash 的組合為例，手把手教你完成配置。Agnes-2.0-Flash 是 Agnes AI 開放的一款完全免費(fèi)的文本模型，支持 1M Token 上下文，非常適合新手入門。

2. 安裝

在開始配置之前，需要先做一些前置工作。

第一步：下載并安裝 CCSwitch

官方網(wǎng)址：https://www.ccswitch.io/zh/

官方下載地址：https://github.com/farion1231/cc-switch/releases

1. Windows 用戶：

• 下載 .msi 安裝包（推薦，支持自動(dòng)更新），雙擊運(yùn)行安裝程序
• 默認(rèn)安裝到 C 盤，建議修改到非系統(tǒng)盤（如 D:\Program Files\CC Switch）
• 如果不想寫注冊(cè)表，可以下載 Portable 便攜版（.zip 文件），解壓后直接運(yùn)行 CC-Switch.exe

2. macOS 用戶：

• 下載 .dmg 文件，雙擊打開后將 CC Switch.app 拖入「應(yīng)用程序」文件夾
• 首次啟動(dòng)時(shí)如果提示“未知開發(fā)者”或“無法驗(yàn)證開發(fā)者”，這是正常情況。關(guān)閉提示后，前往「系統(tǒng)設(shè)置」→「隱私與安全性」，找到 CCSwitch 相關(guān)提示，點(diǎn)擊「仍然打開」即可

3. Linux 用戶：

• 根據(jù)發(fā)行版選擇 .deb、.rpm 或 .AppImage 格式
• 使用 .AppImage 的話，下載后添加執(zhí)行權(quán)限即可運(yùn)行

第二步：準(zhǔn)備 Claude Code 環(huán)境（可選）

如果你打算用 Claude Code 來調(diào)用 Agnes 模型，需要先安裝并配置好 Claude Code 基礎(chǔ)環(huán)境：

• 安裝 Node.js（推薦 LTS 版本）
  • macOS：brew install node@20
  • Windows：去 nodejs.org 官網(wǎng)下安裝包，一路 Next
  • Linux：curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && sudo apt install -y nodejs
• 通過 npm 安裝 Claude Code：npm install -g @anthropic-ai/claude-code
• 安裝完成后，可以在終端中運(yùn)行 claude 命令驗(yàn)證是否成功

提示：如果你主要用其他工具（如 Codex 或 Gemini CLI），也可以跳過這一步，配置原理是一樣的。

# 查看是否安裝成功
node -v
claude -v

第三步：注冊(cè) Agnes AI 賬號(hào)并獲取 API Key

Agnes AI 開放了多款核心模型的 API，其中 Agnes-2.0-Flash 是完全免費(fèi)、無限期使用的文本模型。

Agnes 的 API 地址是 https://apihub.agnes-ai.com/v1，你可以分別按需去配置模型，比如說：

• 文本模型：agnes-2.0-flash
• 圖片模型：agnes-image-2.1-flash
• 視頻模型：agnes-video-v2.0

注冊(cè)步驟：

1. 訪問 Agnes AI 平臺(tái)注冊(cè)地址：https://platform.agnes-ai.com/login ?？芍苯油ㄟ^Github賬號(hào)登錄
2. 注冊(cè)并登錄賬號(hào)

3. 進(jìn)入后臺(tái)的「API密鑰」頁(yè)面，或直接訪問：https://platform.agnes-ai.com/settings/apiKeys
4. 點(diǎn)擊「創(chuàng)建新密鑰」，生成一個(gè)新的 API Key

5. 復(fù)制并保存好這個(gè) Key（格式類似 sk-xxxxxxxxxxxxxxxx）。出于安全考慮，之后你將無法再次通過賬戶查看這個(gè) Key，遺失需要重新生成

3. 配置

完成準(zhǔn)備工作后，就可以在 CCSwitch 中添加 Agnes 作為 Provider 了。

第一步：打開新增供應(yīng)商界面

啟動(dòng) CCSwitch 后，根據(jù)你要使用的 AI 工具點(diǎn)擊頂部對(duì)應(yīng)的圖標(biāo)（例如：我這里使用的是 Claude-cli就點(diǎn)擊 第一個(gè)Claude 圖標(biāo)），然后點(diǎn)擊右上角的 「+ 新增供應(yīng)商」。

第二步：創(chuàng)建自定義供應(yīng)商

• 預(yù)設(shè)供應(yīng)商選擇 「自定義配置」
• 供應(yīng)商類型選擇「自定義配置」

第三步：填寫 API 信息

填寫以下關(guān)鍵信息：

第四步：獲取模型列表并添加模型

1. 在配置頁(yè)面找到 「模型映射」，點(diǎn)擊 「獲取模型列表」

• 系統(tǒng)會(huì)自動(dòng)讀取當(dāng)前賬號(hào)可用的模型列表
• 如果成功拉取到列表，通過下拉框選擇不同模型映射即可。我這里全部選擇映射到agnes-2.0-flash

4. 點(diǎn)擊「添加」完成模型創(chuàng)建

Claude Code 真實(shí)跑起來時(shí)，可能會(huì)帶一些模型不認(rèn)識(shí)的參數(shù)，比如 thinking、context_management 這類字段。

為了避免請(qǐng)求因?yàn)閰?shù)不兼容直接失敗，可以再CC Switch 里加如下參數(shù)：

  "allowed_openai_params": [
    "thinking",
    "context_management"
  ],
  "litellm_settings": {
    "drop_params": true
  }

第五步：開啟本地路由映射（重要?。?/h3>

如果你使用的是 Claude Code，需要額外開啟本地路由映射：

• 在配置頁(yè)面找到 「需要本地路由映射」 選項(xiàng)，打開開關(guān)
• 進(jìn)入 CCSwitch 的 「設(shè)置」 → 「本地路由」，確保以下兩個(gè)開關(guān)都打開：
  • 路由總開關(guān)：開啟
  • Claude Code 路由：開啟

?? 很多新手配置完發(fā)現(xiàn)無法使用，原因就是本地路由沒有開啟。這一步非常關(guān)鍵，請(qǐng)務(wù)必確認(rèn)！

第六步：切換到新創(chuàng)建的渠道

返回 CCSwitch 主界面，點(diǎn)擊剛剛創(chuàng)建的 Provider（如 Agnes-Free），再點(diǎn)擊 「啟用」。配置就會(huì)自動(dòng)生效。

4. 驗(yàn)證

配置完成后，可以通過以下方式驗(yàn)證：

1. 健康檢查：在 CCSwitch 中點(diǎn)擊 Provider 旁邊的「健康檢查」按鈕，發(fā)送測(cè)試請(qǐng)求來驗(yàn)證 API Key 和網(wǎng)絡(luò)連通性

• 重啟客戶端：關(guān)閉并重新打開 Claude Code（或你使用的其他 AI 工具），讓配置重新加載

# 終端輸入claude，以啟動(dòng)claude cli
claude

3. 實(shí)際測(cè)試：隨便問一下，看是否能正常返回結(jié)果

如果健康檢查通過但工具無法使用，請(qǐng)檢查本地路由開關(guān)是否已開啟。

同時(shí)如果雖然Claude頁(yè)面顯示還是Opus 4.8模型，但因?yàn)槲覀冏隽四Ｐ陀成洌瑢?shí)際請(qǐng)求已經(jīng)走到了Agnes，大家也可以到Agnes官網(wǎng)去查看自己的token用量。

token用量查詢地址：https://platform.agnes-ai.com/billing/billing

常見問題

Q1：首次啟動(dòng) CCSwitch 時(shí)提示“未識(shí)別的開發(fā)者”

A：這是 macOS 的安全機(jī)制。關(guān)閉警告窗口后，前往「系統(tǒng)設(shè)置」→「隱私與安全性」，找到 CCSwitch 相關(guān)提示，點(diǎn)擊「仍然打開」即可。

Q2：系統(tǒng)托盤里沒有 CCSwitch 圖標(biāo)

A：Windows 版本可能默認(rèn)啟動(dòng)后隱藏在任務(wù)欄了，點(diǎn)擊系統(tǒng)托盤區(qū)域的小箭頭展開查看。如果還是沒有，嘗試重新啟動(dòng)軟件。

Q3：切換 Provider 后 AI 工具沒有生效

A：檢查是否在 CCSwitch 頂部正確選中了對(duì)應(yīng)的應(yīng)用（如 Claude Code 或 Codex），因?yàn)槊總€(gè)應(yīng)用的配置是獨(dú)立管理的。另外記得重啟對(duì)應(yīng)的客戶端。

Q4：獲取模型列表失敗

A：檢查 API Key 是否正確、Base URL 是否填寫為 https://apihub.agnes-ai.com/v1。錯(cuò)誤配置 Base URL 會(huì)導(dǎo)致 404 錯(cuò)誤。

Q5：Agnes 模型真的完全免費(fèi)嗎

A：是的。Agnes AI 開放了核心全模態(tài)模型的 API，免費(fèi)、無限期開放、無需等待名單。文本模型 Agnes-2.0-Flash 支持 1M Token 上下文，足夠日常編程使用。

總結(jié)

通過 CCSwitch + Agnes AI 的組合，你可以零成本搭建一個(gè)多模型切換的 AI 編程環(huán)境。整個(gè)過程的核心步驟就是：

1. 安裝 CCSwitch（跨平臺(tái)，3 分鐘搞定）
2. 注冊(cè) Agnes AI 獲取免費(fèi) API Key（免費(fèi)，無限期）
3. 在 CCSwitch 中添加自定義 Provider（填好 Base URL 和 API Key）
4. 開啟本地路由映射（Claude Code 用戶必做）
5. 啟用并測(cè)試

配置完成后，你就可以在 Claude Code、Codex 等工具中自由使用 Agnes-2.0-Flash 模型了。如果你平時(shí)在多個(gè) AI 編程工具之間切換、手上有幾套不同的 API 配置，CCSwitch 絕對(duì)值得一試。

到此這篇關(guān)于CCSwitch 接入Claude 無限token的完整配置(工具推薦)的文章就介紹到這了,更多相關(guān)CCSwitch 接入Claude內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論