9Router 集成 Claude Code用 ANTHROPIC_BASE_URL 與模型別名把 Claude Code 接入智能路由【免費(fèi)下載鏈接】9routerUnlimited FREE AI coding. Connect Claude Code, Codex, Cursor, Cline, Copilot, Antigravity to FREE Claude/GPT/Gemini via 40 providers. Auto-fallback, RTK -40% tokens, never hit limits.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/9r/9router本指南講解如何將 Anthropic 官方 Claude Code CLI 接入 9Router 的智能路由系統(tǒng)通過(guò)環(huán)境變量與~/.claude/settings.json配置文件把 Claude Code 的 API 請(qǐng)求指向 9Router再借助cc/命名空間的模型別名與自動(dòng)回退Auto-fallback機(jī)制把 Claude Code 的流量分發(fā)到 40 上游提供商。讀完本文你將掌握從環(huán)境變量配置、模型別名映射到故障排查的完整落地流程并理解儀表盤(pán)一鍵配置背后的實(shí)現(xiàn)原理。集成原理Claude Code 如何被路由到 9RouterClaude Code 客戶端本身只認(rèn) Anthropic 兼容的 API 地址。9Router 對(duì)外暴露 Anthropic 兼容端點(diǎn)本地默認(rèn)http://localhost:20128/v1Claude Code 的所有請(qǐng)求都發(fā)往該端點(diǎn)由 9Router 完成協(xié)議翻譯、提供商選擇與模型路由。從源碼可以印證這套機(jī)制的兩個(gè)關(guān)鍵點(diǎn)/v1/messages路徑即 Claude 協(xié)議信號(hào)在 open-sse/translator/formats.js 中只要請(qǐng)求路徑包含/v1/messages即判定為FORMATS.CLAUDE按 Claude 消息格式處理cc是 Claude Code 的提供商命名空間在 open-sse/providers/registry/claude.js 中Claude Code 對(duì)應(yīng) provider 的id為claude、alias為cc這也是下文所有cc/...模型 ID 前綴的來(lái)源。因此集成工作本質(zhì)上只有一件事讓 Claude Code 把 9Router 當(dāng)作它的 Anthropic API 服務(wù)端其余的路由、降級(jí)、限額管理全部由 9Router 接管。前置條件開(kāi)始配置前請(qǐng)確認(rèn)以下三項(xiàng)就緒Claude Code CLI 已安裝可通過(guò)npm install -g anthropic-ai/claude-code安裝macOS / Linux / Windows 通用安裝后執(zhí)行claude驗(yàn)證可用9Router 正在運(yùn)行或已配置云端端點(diǎn)本地運(yùn)行默認(rèn)監(jiān)聽(tīng)20128端口或使用云端端點(diǎn)見(jiàn)文末云端端點(diǎn)一節(jié)擁有 9Router 的 API Key從 9Router 儀表盤(pán)Dashboard獲取用于在請(qǐng)求中標(biāo)識(shí)你的賬戶與配額。核心配置設(shè)置環(huán)境變量Claude Code 通過(guò)環(huán)境變量感知 API 地址與默認(rèn)模型。在你的 shell 配置文件中~/.bashrc、~/.zshrc或~/.bash_profile按你使用的 shell 選擇追加以下內(nèi)容# 9Router 的 Base URL export ANTHROPIC_BASE_URLhttp://localhost:20128/v1 # 可選為別名設(shè)置默認(rèn)模型 export ANTHROPIC_DEFAULT_OPUS_MODELcc/claude-opus-4-5-20251101 export ANTHROPIC_DEFAULT_SONNET_MODELcc/claude-sonnet-4-5-20250929 export ANTHROPIC_DEFAULT_HAIKU_MODELcc/claude-haiku-4-5-20251001配置完成后重載 shell 配置source ~/.zshrc # 或 source ~/.bashrc最后驗(yàn)證變量是否生效echo $ANTHROPIC_BASE_URL # 預(yù)期輸出http://localhost:20128/v1關(guān)于 Base URL 與/v1后綴ANTHROPIC_BASE_URL必須帶/v1后綴Claude Code 才會(huì)拼接出/v1/messages路徑。9Router 的 Web 端在寫(xiě)入配置時(shí)會(huì)主動(dòng)做這個(gè)歸一化在 src/app/api/cli-tools/claude-settings/route.js 中若用戶填寫(xiě)的地址不以/v1結(jié)尾服務(wù)端會(huì)自動(dòng)補(bǔ)上避免因手寫(xiě)遺漏導(dǎo)致路由失敗。模型別名與默認(rèn)模型映射Claude Code 支持將opus、sonnet、haiku等別名映射到 9Router 的具體模型 ID。映射關(guān)系由下表的環(huán)境變量控制別名對(duì)應(yīng)模型環(huán)境變量opusClaude Opus 4.5ANTHROPIC_DEFAULT_OPUS_MODELsonnetClaude Sonnet 4.5ANTHROPIC_DEFAULT_SONNET_MODELhaikuClaude Haiku 4.5ANTHROPIC_DEFAULT_HAIKU_MODEL除了表格中的三個(gè)9Router 對(duì) Claude Code 還登記了更完整的別名體系。在 src/shared/constants/cliTools.js 中可以看到 Claude Code 的全部別名default、sonnet、opus、fable、haiku、opusplan并定義了以下默認(rèn)映射別名默認(rèn)模型defaultValue環(huán)境變量opuscc/claude-opus-5ANTHROPIC_DEFAULT_OPUS_MODELsonnetcc/claude-sonnet-5ANTHROPIC_DEFAULT_SONNET_MODELhaikucc/claude-haiku-4-5-20251001ANTHROPIC_DEFAULT_HAIKU_MODELfablecc/claude-fable-5ANTHROPIC_DEFAULT_FABLE_MODEL而在 9Router 的 TUI 客戶端cli/src/cli/menus/cliTools.js中Claude 模型類型的默認(rèn)值與 Web 端保持一致例如sonnet默認(rèn)cc/claude-sonnet-4-5-20250929、opus默認(rèn)cc/claude-opus-4-5-20251101、haiku默認(rèn)cc/claude-haiku-4-5-20251001。你可以按實(shí)際使用的上游提供商與模型隨時(shí)改寫(xiě)這些變量。理解cc/前綴的模型 IDcc/claude-opus-4-5-20251101這類 ID 的格式是提供商命名空間/模型 ID。其中cc即 Claude Code 命名空間見(jiàn) open-sse/providers/registry/claude.js。除cc外9Router 還維護(hù)gemini/、glm/、if/、cx/等多個(gè)命名空間分別對(duì)應(yīng) Gemini、GLM、iFlow、Codex 等提供商。更靈活的是模型 ID 位置也可以填Combo 名稱。9Router 支持在儀表盤(pán)創(chuàng)建自定義回退鏈Combo例如Combo 名稱: premium-coding Models: 1. cc/claude-opus-4-5-20251101 (優(yōu)先嘗試) 2. glm/glm-4.7 (配額耗盡時(shí)回退) 3. minimax/MiniMax-M2.1 (再耗盡時(shí)繼續(xù)回退)隨后在ANTHROPIC_DEFAULT_SONNET_MODEL中填premium-coding即可讓 Claude Code 的 sonnet 別名走這條自動(dòng)回退鏈詳見(jiàn) gitbook/content/en/features/combos.md。這正是 9Router 集成方案相對(duì)直連 Anthropic 的核心價(jià)值單個(gè)別名背后可以掛一整條永不中斷的提供商鏈。使用示例通過(guò)別名調(diào)用模型# 使用 Opus 模型 claude --model opus Explain quantum computing # 使用 Sonnet 模型 claude --model sonnet Write a Python function # 使用 Haiku 模型 claude --model haiku Quick code review使用完整模型名claude --model cc/claude-opus-4-5-20251101 Your prompt here兩種寫(xiě)法等價(jià)別名會(huì)被環(huán)境變量展開(kāi)為對(duì)應(yīng)的完整模型 ID最終都解析為cc/...形式的 9Router 模型。配置文件方式編輯~/.claude/settings.json環(huán)境變量并非唯一途徑。Claude Code 的配置集中在~/.claude/settings.json你可以手動(dòng)編輯{ baseUrl: http://localhost:20128/v1, defaultModel: sonnet }從 9Router 的實(shí)現(xiàn)看settings.json實(shí)際使用的是env字段結(jié)構(gòu)。Web 端寫(xiě)入配置時(shí)生成的完整內(nèi)容形如見(jiàn) src/app/(dashboard)/dashboard/cli-tools/components/ClaudeToolCard.js/dashboard/cli-tools/components/ClaudeToolCard.js#L236-L255) 中g(shù)etManualConfigs的邏輯{ hasCompletedOnboarding: true, env: { ANTHROPIC_BASE_URL: http://localhost:20128/v1, ANTHROPIC_AUTH_TOKEN: sk_9router, ANTHROPIC_DEFAULT_OPUS_MODEL: cc/claude-opus-5, ANTHROPIC_DEFAULT_SONNET_MODEL: cc/claude-sonnet-5, ANTHROPIC_DEFAULT_HAIKU_MODEL: cc/claude-haiku-4-5-20251001 } }除上述變量外后端還會(huì)維護(hù)幾個(gè)對(duì) Claude Code 有用的鍵見(jiàn) src/app/api/cli-tools/claude-settings/route.js 的 Reset 鍵清單ANTHROPIC_AUTH_TOKEN9Router 的 API Key本地部署時(shí)默認(rèn)為sk_9routerAPI_TIMEOUT_MS請(qǐng)求超時(shí)時(shí)間毫秒CLAUDE_CODE_MAX_CONTEXT_TOKENS上下文窗口上限。其中CLAUDE_CODE_MAX_CONTEXT_TOKENS在儀表盤(pán)里以Context window下拉框提供預(yù)設(shè)值ClaudeToolCard.js/dashboard/cli-tools/components/ClaudeToolCard.js#L14-L20)Default不寫(xiě)入沿用模型原生窗口、200K、300K、500K、1M。注意 UI 顯示的是取整數(shù)字實(shí)際寫(xiě)入值會(huì)被下調(diào) 2K如 200K 寫(xiě)為198000目的是安全地保持在模型上下文硬上限之下。兩個(gè)文件的分工settings.json與~/.claude.json一個(gè)容易踩坑的細(xì)節(jié)Claude Code 的環(huán)境變量配置在~/.claude/settings.json而MCP 服務(wù)器配置在~/.claude.json位于主目錄注意沒(méi)有.claude目錄前綴。9Router 在注入 Exa MCP為路由后的非 Claude 模型提供聯(lián)網(wǎng)搜索能力時(shí)就是寫(xiě)入~/.claude.json的mcpServers字段見(jiàn) src/app/api/cli-tools/claude-settings/route.js。若你手動(dòng)配置時(shí)把 MCP 寫(xiě)錯(cuò)了文件Claude Code 不會(huì)讀取且該文件還可能因?yàn)?JSON 末尾逗號(hào)等問(wèn)題解析失敗——9Router 在讀取時(shí)專門(mén)做了容錯(cuò)處理去除尾隨逗號(hào)、解析失敗視為無(wú)配置。儀表盤(pán)一鍵配置CLI Tools除手工編輯外9Router Web 儀表盤(pán)的CLI Tools頁(yè)面提供針對(duì) Claude Code 的可視化配置對(duì)應(yīng) ClaudeToolCard.js/dashboard/cli-tools/components/ClaudeToolCard.js)。核心能力包括Select Endpoint選擇本地、Tunnel 公網(wǎng)地址、Tailscale 或云端端點(diǎn)API Key從賬戶已保存的 Key 中選取本地部署無(wú) Key 時(shí)自動(dòng)回退sk_9routerModel Mappings分別為 opus / sonnet / haiku / fable 別名選擇目標(biāo)模型可手動(dòng)輸入provider/model-id或從模型選擇彈窗挑選Context window預(yù)設(shè) 200K / 300K / 500K / 1M或保持 DefaultFilter naming攔截 Claude Code 的對(duì)話主題命名請(qǐng)求并在本地返回假響應(yīng)節(jié)省 API Token對(duì)應(yīng)ccFilterNaming設(shè)置項(xiàng)Exa MCP向~/.claude.json注入 Exa MCP使路由到的非 Claude 模型也具備聯(lián)網(wǎng)搜索能力開(kāi)啟后需重啟 Claude CodeApply / Reset / Manual Config一鍵寫(xiě)入配置、一鍵清除 9Router 注入的環(huán)境變量、或復(fù)制手動(dòng)配置 JSON。后端對(duì)應(yīng)的 API 在 src/app/api/cli-tools/claude-settings/route.js其GET會(huì)檢測(cè) Claude CLI 是否安裝which claude/where claude并讀取當(dāng)前配置POST負(fù)責(zé)合并寫(xiě)入env并歸一化/v1后綴DELETE則按RESET_ENV_KEYS清單清除 9Router 注入的變量。9Router 自帶的 TUI 客戶端同樣提供這套配置入口見(jiàn) cli/src/cli/menus/cliTools.js方便純終端環(huán)境下完成配置。常見(jiàn)問(wèn)題排查連接異常Connection Issues若出現(xiàn)連接錯(cuò)誤按順序排查確認(rèn) 9Router 正在運(yùn)行curl http://localhost:20128/health能返回健康響應(yīng)說(shuō)明服務(wù)正常檢查環(huán)境變量是否配置正確echo $ANTHROPIC_BASE_URL確認(rèn)值以/v1結(jié)尾確認(rèn)防火墻未攔截20128端口本地回環(huán)地址一般無(wú)礙但若 9Router 部署在遠(yuǎn)端服務(wù)器需放行對(duì)應(yīng)端口。模型不存在Model Not Found如果出現(xiàn) model not found 錯(cuò)誤核對(duì)模型名稱與 9Router 配置一致cc/...前綴與模型 ID 必須與 9Router 注冊(cè)的命名空間匹配可參考 src/shared/constants/cliTools.js 的默認(rèn)值檢查儀表盤(pán)中提供商連接是否為活躍狀態(tài)只有isActive且測(cè)試狀態(tài)為active/success的連接才會(huì)參與模型映射見(jiàn) cliTools.js 的getProviderModelsForMapping確認(rèn)模型在已連接的上游提供商中真實(shí)可用若上游未開(kāi)通或已下線該模型9Router 無(wú)法代為提供。協(xié)議層面的提示從源碼結(jié)構(gòu)看cc命名空間對(duì)應(yīng)的 provider 注冊(cè)項(xiàng)帶有deprecated: true與風(fēng)險(xiǎn)提示標(biāo)記open-sse/providers/registry/claude.js說(shuō)明官方 Claude 直連通道存在風(fēng)險(xiǎn)提示建議優(yōu)先使用儀表盤(pán)中狀態(tài)正常的活躍提供商來(lái)承接路由流量。使用云端端點(diǎn)若不想在本地運(yùn)行 9Router可直接使用云端端點(diǎn)export ANTHROPIC_BASE_URLhttps://9router.com使用前需在 9Router 云端儀表盤(pán)完成兩件事生成并配置 API Key云端模式下ANTHROPIC_AUTH_TOKEN必須使用儀表盤(pán)簽發(fā)的真實(shí) Key本地模式的sk_9router僅限本機(jī)回環(huán)使用確認(rèn)云端賬戶已連接可用的上游提供商路由依賴的是云端側(cè)維護(hù)的提供商連接。配置完成后同一套claude --model sonnet ...命令即可在云端路由下工作無(wú)需任何客戶端改動(dòng)?？偨Y(jié)把 Claude Code 接入 9Router 的本質(zhì)是把ANTHROPIC_BASE_URL指向 9Router 的 Anthropic 兼容端點(diǎn)并用ANTHROPIC_DEFAULT_*_MODEL系列變量把opus/sonnet/haiku別名映射到cc/命名空間下的模型 ID 或 Combo 回退鏈。無(wú)論你選擇 shell 環(huán)境變量、手動(dòng)編輯~/.claude/settings.json還是直接使用 9Router 儀表盤(pán)的 CLI Tools 一鍵配置最終生效的都是同一套環(huán)境變量體系配合cc/前綴的多提供商路由、Combo 自動(dòng)回退與上下文窗口調(diào)優(yōu)即可在保留 Claude Code 原生日志、工具調(diào)用與終端交互體驗(yàn)的同時(shí)獲得更靈活的模型選擇與更強(qiáng)的可用性保障?！久赓M(fèi)下載鏈接】9routerUnlimited FREE AI coding. Connect Claude Code, Codex, Cursor, Cline, Copilot, Antigravity to FREE Claude/GPT/Gemini via 40 providers. Auto-fallback, RTK -40% tokens, never hit limits.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/9r/9router創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 9Router 集成 Claude Code：用 ANTHROPIC_BASE_URL 與模型別名把 Claude Code 接入智能路由
9Router 集成 Claude Code用 ANTHROPIC_BASE_URL 與模型別名把 Claude Code 接入智能路由【免費(fèi)下載鏈接】9routerUnlimited FREE AI coding. Connect Claude Code, Codex, Cursor, Cline, Copilot, Antigravity to FREE Claude/GPT/Gemini via 40 providers. Auto-fallback, RTK -40% tokens, never hit limits.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/9r/9router本指南講解如何將 Anthropic 官方 Claude Code CLI 接入 9Router 的智能路由系統(tǒng)通過(guò)環(huán)境變量與~/.claude/settings.json配置文件把 Claude Code 的 API 請(qǐng)求指向 9Router再借助cc/命名空間的模型別名與自動(dòng)回退Auto-fallback機(jī)制把 Claude Code 的流量分發(fā)到 40 上游提供商。讀完本文你將掌握從環(huán)境變量配置、模型別名映射到故障排查的完整落地流程并理解儀表盤(pán)一鍵配置背后的實(shí)現(xiàn)原理。集成原理Claude Code 如何被路由到 9RouterClaude Code 客戶端本身只認(rèn) Anthropic 兼容的 API 地址。9Router 對(duì)外暴露 Anthropic 兼容端點(diǎn)本地默認(rèn)http://localhost:20128/v1Claude Code 的所有請(qǐng)求都發(fā)往該端點(diǎn)由 9Router 完成協(xié)議翻譯、提供商選擇與模型路由。從源碼可以印證這套機(jī)制的兩個(gè)關(guān)鍵點(diǎn)/v1/messages路徑即 Claude 協(xié)議信號(hào)在 open-sse/translator/formats.js 中只要請(qǐng)求路徑包含/v1/messages即判定為FORMATS.CLAUDE按 Claude 消息格式處理cc是 Claude Code 的提供商命名空間在 open-sse/providers/registry/claude.js 中Claude Code 對(duì)應(yīng) provider 的id為claude、alias為cc這也是下文所有cc/...模型 ID 前綴的來(lái)源。因此集成工作本質(zhì)上只有一件事讓 Claude Code 把 9Router 當(dāng)作它的 Anthropic API 服務(wù)端其余的路由、降級(jí)、限額管理全部由 9Router 接管。前置條件開(kāi)始配置前請(qǐng)確認(rèn)以下三項(xiàng)就緒Claude Code CLI 已安裝可通過(guò)npm install -g anthropic-ai/claude-code安裝macOS / Linux / Windows 通用安裝后執(zhí)行claude驗(yàn)證可用9Router 正在運(yùn)行或已配置云端端點(diǎn)本地運(yùn)行默認(rèn)監(jiān)聽(tīng)20128端口或使用云端端點(diǎn)見(jiàn)文末云端端點(diǎn)一節(jié)擁有 9Router 的 API Key從 9Router 儀表盤(pán)Dashboard獲取用于在請(qǐng)求中標(biāo)識(shí)你的賬戶與配額。核心配置設(shè)置環(huán)境變量Claude Code 通過(guò)環(huán)境變量感知 API 地址與默認(rèn)模型。在你的 shell 配置文件中~/.bashrc、~/.zshrc或~/.bash_profile按你使用的 shell 選擇追加以下內(nèi)容# 9Router 的 Base URL export ANTHROPIC_BASE_URLhttp://localhost:20128/v1 # 可選為別名設(shè)置默認(rèn)模型 export ANTHROPIC_DEFAULT_OPUS_MODELcc/claude-opus-4-5-20251101 export ANTHROPIC_DEFAULT_SONNET_MODELcc/claude-sonnet-4-5-20250929 export ANTHROPIC_DEFAULT_HAIKU_MODELcc/claude-haiku-4-5-20251001配置完成后重載 shell 配置source ~/.zshrc # 或 source ~/.bashrc最后驗(yàn)證變量是否生效echo $ANTHROPIC_BASE_URL # 預(yù)期輸出http://localhost:20128/v1關(guān)于 Base URL 與/v1后綴ANTHROPIC_BASE_URL必須帶/v1后綴Claude Code 才會(huì)拼接出/v1/messages路徑。9Router 的 Web 端在寫(xiě)入配置時(shí)會(huì)主動(dòng)做這個(gè)歸一化在 src/app/api/cli-tools/claude-settings/route.js 中若用戶填寫(xiě)的地址不以/v1結(jié)尾服務(wù)端會(huì)自動(dòng)補(bǔ)上避免因手寫(xiě)遺漏導(dǎo)致路由失敗。模型別名與默認(rèn)模型映射Claude Code 支持將opus、sonnet、haiku等別名映射到 9Router 的具體模型 ID。映射關(guān)系由下表的環(huán)境變量控制別名對(duì)應(yīng)模型環(huán)境變量opusClaude Opus 4.5ANTHROPIC_DEFAULT_OPUS_MODELsonnetClaude Sonnet 4.5ANTHROPIC_DEFAULT_SONNET_MODELhaikuClaude Haiku 4.5ANTHROPIC_DEFAULT_HAIKU_MODEL除了表格中的三個(gè)9Router 對(duì) Claude Code 還登記了更完整的別名體系。在 src/shared/constants/cliTools.js 中可以看到 Claude Code 的全部別名default、sonnet、opus、fable、haiku、opusplan并定義了以下默認(rèn)映射別名默認(rèn)模型defaultValue環(huán)境變量opuscc/claude-opus-5ANTHROPIC_DEFAULT_OPUS_MODELsonnetcc/claude-sonnet-5ANTHROPIC_DEFAULT_SONNET_MODELhaikucc/claude-haiku-4-5-20251001ANTHROPIC_DEFAULT_HAIKU_MODELfablecc/claude-fable-5ANTHROPIC_DEFAULT_FABLE_MODEL而在 9Router 的 TUI 客戶端cli/src/cli/menus/cliTools.js中Claude 模型類型的默認(rèn)值與 Web 端保持一致例如sonnet默認(rèn)cc/claude-sonnet-4-5-20250929、opus默認(rèn)cc/claude-opus-4-5-20251101、haiku默認(rèn)cc/claude-haiku-4-5-20251001。你可以按實(shí)際使用的上游提供商與模型隨時(shí)改寫(xiě)這些變量。理解cc/前綴的模型 IDcc/claude-opus-4-5-20251101這類 ID 的格式是提供商命名空間/模型 ID。其中cc即 Claude Code 命名空間見(jiàn) open-sse/providers/registry/claude.js。除cc外9Router 還維護(hù)gemini/、glm/、if/、cx/等多個(gè)命名空間分別對(duì)應(yīng) Gemini、GLM、iFlow、Codex 等提供商。更靈活的是模型 ID 位置也可以填Combo 名稱。9Router 支持在儀表盤(pán)創(chuàng)建自定義回退鏈Combo例如Combo 名稱: premium-coding Models: 1. cc/claude-opus-4-5-20251101 (優(yōu)先嘗試) 2. glm/glm-4.7 (配額耗盡時(shí)回退) 3. minimax/MiniMax-M2.1 (再耗盡時(shí)繼續(xù)回退)隨后在ANTHROPIC_DEFAULT_SONNET_MODEL中填premium-coding即可讓 Claude Code 的 sonnet 別名走這條自動(dòng)回退鏈詳見(jiàn) gitbook/content/en/features/combos.md。這正是 9Router 集成方案相對(duì)直連 Anthropic 的核心價(jià)值單個(gè)別名背后可以掛一整條永不中斷的提供商鏈。使用示例通過(guò)別名調(diào)用模型# 使用 Opus 模型 claude --model opus Explain quantum computing # 使用 Sonnet 模型 claude --model sonnet Write a Python function # 使用 Haiku 模型 claude --model haiku Quick code review使用完整模型名claude --model cc/claude-opus-4-5-20251101 Your prompt here兩種寫(xiě)法等價(jià)別名會(huì)被環(huán)境變量展開(kāi)為對(duì)應(yīng)的完整模型 ID最終都解析為cc/...形式的 9Router 模型。配置文件方式編輯~/.claude/settings.json環(huán)境變量并非唯一途徑。Claude Code 的配置集中在~/.claude/settings.json你可以手動(dòng)編輯{ baseUrl: http://localhost:20128/v1, defaultModel: sonnet }從 9Router 的實(shí)現(xiàn)看settings.json實(shí)際使用的是env字段結(jié)構(gòu)。Web 端寫(xiě)入配置時(shí)生成的完整內(nèi)容形如見(jiàn) src/app/(dashboard)/dashboard/cli-tools/components/ClaudeToolCard.js/dashboard/cli-tools/components/ClaudeToolCard.js#L236-L255) 中g(shù)etManualConfigs的邏輯{ hasCompletedOnboarding: true, env: { ANTHROPIC_BASE_URL: http://localhost:20128/v1, ANTHROPIC_AUTH_TOKEN: sk_9router, ANTHROPIC_DEFAULT_OPUS_MODEL: cc/claude-opus-5, ANTHROPIC_DEFAULT_SONNET_MODEL: cc/claude-sonnet-5, ANTHROPIC_DEFAULT_HAIKU_MODEL: cc/claude-haiku-4-5-20251001 } }除上述變量外后端還會(huì)維護(hù)幾個(gè)對(duì) Claude Code 有用的鍵見(jiàn) src/app/api/cli-tools/claude-settings/route.js 的 Reset 鍵清單ANTHROPIC_AUTH_TOKEN9Router 的 API Key本地部署時(shí)默認(rèn)為sk_9routerAPI_TIMEOUT_MS請(qǐng)求超時(shí)時(shí)間毫秒CLAUDE_CODE_MAX_CONTEXT_TOKENS上下文窗口上限。其中CLAUDE_CODE_MAX_CONTEXT_TOKENS在儀表盤(pán)里以Context window下拉框提供預(yù)設(shè)值ClaudeToolCard.js/dashboard/cli-tools/components/ClaudeToolCard.js#L14-L20)Default不寫(xiě)入沿用模型原生窗口、200K、300K、500K、1M。注意 UI 顯示的是取整數(shù)字實(shí)際寫(xiě)入值會(huì)被下調(diào) 2K如 200K 寫(xiě)為198000目的是安全地保持在模型上下文硬上限之下。兩個(gè)文件的分工settings.json與~/.claude.json一個(gè)容易踩坑的細(xì)節(jié)Claude Code 的環(huán)境變量配置在~/.claude/settings.json而MCP 服務(wù)器配置在~/.claude.json位于主目錄注意沒(méi)有.claude目錄前綴。9Router 在注入 Exa MCP為路由后的非 Claude 模型提供聯(lián)網(wǎng)搜索能力時(shí)就是寫(xiě)入~/.claude.json的mcpServers字段見(jiàn) src/app/api/cli-tools/claude-settings/route.js。若你手動(dòng)配置時(shí)把 MCP 寫(xiě)錯(cuò)了文件Claude Code 不會(huì)讀取且該文件還可能因?yàn)?JSON 末尾逗號(hào)等問(wèn)題解析失敗——9Router 在讀取時(shí)專門(mén)做了容錯(cuò)處理去除尾隨逗號(hào)、解析失敗視為無(wú)配置。儀表盤(pán)一鍵配置CLI Tools除手工編輯外9Router Web 儀表盤(pán)的CLI Tools頁(yè)面提供針對(duì) Claude Code 的可視化配置對(duì)應(yīng) ClaudeToolCard.js/dashboard/cli-tools/components/ClaudeToolCard.js)。核心能力包括Select Endpoint選擇本地、Tunnel 公網(wǎng)地址、Tailscale 或云端端點(diǎn)API Key從賬戶已保存的 Key 中選取本地部署無(wú) Key 時(shí)自動(dòng)回退sk_9routerModel Mappings分別為 opus / sonnet / haiku / fable 別名選擇目標(biāo)模型可手動(dòng)輸入provider/model-id或從模型選擇彈窗挑選Context window預(yù)設(shè) 200K / 300K / 500K / 1M或保持 DefaultFilter naming攔截 Claude Code 的對(duì)話主題命名請(qǐng)求并在本地返回假響應(yīng)節(jié)省 API Token對(duì)應(yīng)ccFilterNaming設(shè)置項(xiàng)Exa MCP向~/.claude.json注入 Exa MCP使路由到的非 Claude 模型也具備聯(lián)網(wǎng)搜索能力開(kāi)啟后需重啟 Claude CodeApply / Reset / Manual Config一鍵寫(xiě)入配置、一鍵清除 9Router 注入的環(huán)境變量、或復(fù)制手動(dòng)配置 JSON。后端對(duì)應(yīng)的 API 在 src/app/api/cli-tools/claude-settings/route.js其GET會(huì)檢測(cè) Claude CLI 是否安裝which claude/where claude并讀取當(dāng)前配置POST負(fù)責(zé)合并寫(xiě)入env并歸一化/v1后綴DELETE則按RESET_ENV_KEYS清單清除 9Router 注入的變量。9Router 自帶的 TUI 客戶端同樣提供這套配置入口見(jiàn) cli/src/cli/menus/cliTools.js方便純終端環(huán)境下完成配置。常見(jiàn)問(wèn)題排查連接異常Connection Issues若出現(xiàn)連接錯(cuò)誤按順序排查確認(rèn) 9Router 正在運(yùn)行curl http://localhost:20128/health能返回健康響應(yīng)說(shuō)明服務(wù)正常檢查環(huán)境變量是否配置正確echo $ANTHROPIC_BASE_URL確認(rèn)值以/v1結(jié)尾確認(rèn)防火墻未攔截20128端口本地回環(huán)地址一般無(wú)礙但若 9Router 部署在遠(yuǎn)端服務(wù)器需放行對(duì)應(yīng)端口。模型不存在Model Not Found如果出現(xiàn) model not found 錯(cuò)誤核對(duì)模型名稱與 9Router 配置一致cc/...前綴與模型 ID 必須與 9Router 注冊(cè)的命名空間匹配可參考 src/shared/constants/cliTools.js 的默認(rèn)值檢查儀表盤(pán)中提供商連接是否為活躍狀態(tài)只有isActive且測(cè)試狀態(tài)為active/success的連接才會(huì)參與模型映射見(jiàn) cliTools.js 的getProviderModelsForMapping確認(rèn)模型在已連接的上游提供商中真實(shí)可用若上游未開(kāi)通或已下線該模型9Router 無(wú)法代為提供。協(xié)議層面的提示從源碼結(jié)構(gòu)看cc命名空間對(duì)應(yīng)的 provider 注冊(cè)項(xiàng)帶有deprecated: true與風(fēng)險(xiǎn)提示標(biāo)記open-sse/providers/registry/claude.js說(shuō)明官方 Claude 直連通道存在風(fēng)險(xiǎn)提示建議優(yōu)先使用儀表盤(pán)中狀態(tài)正常的活躍提供商來(lái)承接路由流量。使用云端端點(diǎn)若不想在本地運(yùn)行 9Router可直接使用云端端點(diǎn)export ANTHROPIC_BASE_URLhttps://9router.com使用前需在 9Router 云端儀表盤(pán)完成兩件事生成并配置 API Key云端模式下ANTHROPIC_AUTH_TOKEN必須使用儀表盤(pán)簽發(fā)的真實(shí) Key本地模式的sk_9router僅限本機(jī)回環(huán)使用確認(rèn)云端賬戶已連接可用的上游提供商路由依賴的是云端側(cè)維護(hù)的提供商連接。配置完成后同一套claude --model sonnet ...命令即可在云端路由下工作無(wú)需任何客戶端改動(dòng)?？偨Y(jié)把 Claude Code 接入 9Router 的本質(zhì)是把ANTHROPIC_BASE_URL指向 9Router 的 Anthropic 兼容端點(diǎn)并用ANTHROPIC_DEFAULT_*_MODEL系列變量把opus/sonnet/haiku別名映射到cc/命名空間下的模型 ID 或 Combo 回退鏈。無(wú)論你選擇 shell 環(huán)境變量、手動(dòng)編輯~/.claude/settings.json還是直接使用 9Router 儀表盤(pán)的 CLI Tools 一鍵配置最終生效的都是同一套環(huán)境變量體系配合cc/前綴的多提供商路由、Combo 自動(dòng)回退與上下文窗口調(diào)優(yōu)即可在保留 Claude Code 原生日志、工具調(diào)用與終端交互體驗(yàn)的同時(shí)獲得更靈活的模型選擇與更強(qiáng)的可用性保障?！久赓M(fèi)下載鏈接】9routerUnlimited FREE AI coding. Connect Claude Code, Codex, Cursor, Cline, Copilot, Antigravity to FREE Claude/GPT/Gemini via 40 providers. Auto-fallback, RTK -40% tokens, never hit limits.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/9r/9router創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考