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

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

目前AgnesAI提供免費Token使用，大家可完整體驗整個流程。

1. 概念

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

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

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

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

2. 安裝

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

第一步：下載并安裝 CCSwitch

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

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

1. Windows 用戶：

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

2. macOS 用戶：

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

3. Linux 用戶：

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

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

如果你打算用 Claude Code 來調(diào)用 Agnes 模型，需要先安裝并配置好 Claude Code 基礎環(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
• 安裝完成后，可以在終端中運行 claude 命令驗證是否成功

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

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

第三步：注冊 Agnes AI 賬號并獲取 API Key

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

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

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

注冊步驟：

1. 訪問 Agnes AI 平臺注冊地址：https://platform.agnes-ai.com/login 。可直接通過Github賬號登錄
2. 注冊并登錄賬號

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

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

3. 配置

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

第一步：打開新增供應商界面

啟動 CCSwitch 后，根據(jù)你要使用的 AI 工具點擊頂部對應的圖標（例如：我這里使用的是 Claude-cli就點擊 第一個Claude 圖標），然后點擊右上角的 「+ 新增供應商」。

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

• 預設供應商選擇 「自定義配置」
• 供應商類型選擇「自定義配置」

第三步：填寫 API 信息

填寫以下關鍵信息：

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

1. 在配置頁面找到 「模型映射」，點擊 「獲取模型列表」

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

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

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

為了避免請求因為參數(shù)不兼容直接失敗，可以再CC Switch 里加如下參數(shù)：

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

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

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

• 在配置頁面找到 「需要本地路由映射」 選項，打開開關
• 進入 CCSwitch 的 「設置」 → 「本地路由」，確保以下兩個開關都打開：
  • 路由總開關：開啟
  • Claude Code 路由：開啟

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

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

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

4. 驗證

配置完成后，可以通過以下方式驗證：

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

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

# 終端輸入claude，以啟動claude cli
claude

3. 實際測試：隨便問一下，看是否能正常返回結果

如果健康檢查通過但工具無法使用，請檢查本地路由開關是否已開啟。

同時如果雖然Claude頁面顯示還是Opus 4.8模型，但因為我們做了模型映射，實際請求已經(jīng)走到了Agnes，大家也可以到Agnes官網(wǎng)去查看自己的token用量。

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

常見問題

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

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

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

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

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

A：檢查是否在 CCSwitch 頂部正確選中了對應的應用（如 Claude Code 或 Codex），因為每個應用的配置是獨立管理的。另外記得重啟對應的客戶端。

Q4：獲取模型列表失敗

A：檢查 API Key 是否正確、Base URL 是否填寫為 https://apihub.agnes-ai.com/v1。錯誤配置 Base URL 會導致 404 錯誤。

Q5：Agnes 模型真的完全免費嗎

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

總結

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

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

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

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

最新評論