作者注:Claude Code 接入第三方中轉 API 後報錯「模型找不到」的完整解決方案:Base URL 正確寫法、settings.json 配置方法、最新模型名稱對照表。
<!– Divider –>
<!– Error card –>
<!– Arrow between cards –>
<!– Fix card –>
<!– Bottom info bar –>
<!– Footer –>
在國內使用 Claude Code 時,最常見的報錯就是這一條:
There's an issue with the selected model (claude-sonnet-4-6). It may not exist or you may not have access to it. Run /model to pick a different model.
這個錯誤通常出現在兩種情況下:
- 用了官方 API Key,但模型名拼寫錯誤(直接 重新選一個就好)
- 接入了第三方中轉站,Base URL 配置不正確,導致模型路由失敗
本文重點講解第二種情況的完整解決方案,以 API易(apiyi.com)爲例,覆蓋環境變量、settings.json 兩種配置方式,以及最新 Claude 模型名稱對照表。
核心價值:讀完本文,你將能夠正確配置 Claude Code 接入第三方中轉 API,消除模型找不到的報錯,在國內網絡環境下穩定使用 Claude Code 的全部功能。
在動手配置前,先花 30 秒判斷你遇到的是哪類問題:
如果你使用的是官方 Anthropic API Key 且可以正常訪問 anthropic.com,直接在 Claude Code 中執行 命令即可切換模型,無需任何額外配置。
如果你接入了第三方中轉 API(如 apiyi.com),請繼續閱讀以下配置方案。
🎯 建議: 推薦通過 API易 apiyi.com 平臺接入 Claude Code,平臺兼容 Anthropic 原生格式,支持最新的 claude-opus-4-6、claude-sonnet-4-6 等全系列模型,國內網絡穩定可用。
<!– ── Node 1: Claude Code ── –>
<!– Arrow 1 –>
<!– Node 2: Base URL Config –>
<!– Arrow 2 –>
<!– Node 3: 中轉站 –>
<!– Arrow 3 –>
<!– Node 4: Anthropic API –>
<!– Separator –>
<!– Wrong vs Right comparison –> <!– Wrong –>
<!– Correct –>
<!– Bottom –>
這是最關鍵的一步,也是最容易犯錯的地方。
Claude Code 對 Base URL 有特殊處理邏輯:它會自動在你設置的 Base URL 後面追加 。因此:
- ❌ 錯誤寫法:
- 實際請求路徑變成:(重複了 /v1)
- 結果:路由找不到端點,模型報錯
- ✅ 正確寫法:
- 實際請求路徑變成:
- 結果:正確命中 Anthropic 原生接口
📌 規律總結:設置 時,填寫域名根路徑即可,不要加 後綴。Claude Code 會自動補全完整路徑。
登錄 API易後臺獲取令牌:API易令牌管理頁
令牌選擇建議:
創建新令牌時,選擇 ClaudeCode 分組,可享受 88% 折扣,長期使用成本更低。
在終端中執行以下命令,配置後立即生效(當前會話有效):
GPT plus 代充 只需 145
驗證配置是否生效:
優缺點:
- ✅ 簡單快速,無需修改文件
- ✅ 不影響其他會話的配置
- ❌ 每次新開終端需要重新設置(除非寫入 / )
永久生效方案(寫入 Shell 配置文件):
GPT plus 代充 只需 145
編輯 文件(全局配置,對所有項目生效):
🎯 推薦做法: 使用 進行全局配置,一次設置永久生效,無需每次重複配置環境變量。訪問 API易 apiyi.com 獲取 Key,選擇 ClaudeCode 分組令牌享 88折。
如果文件不存在,手動創建:
GPT plus 代充 只需 145
配置優先級(從高到低):
同一配置項,高優先級會覆蓋低優先級。如果你在項目目錄也有 ,記住這個優先級關係。
<!– Card 1: Opus –>
<!– Bars for Opus –>
<!– Card 2: Sonnet –>
<!– Card 3: Haiku –>
<!– Bottom tips –>
這是 2026 年最新的 Claude 模型名稱,必須精確填寫,大小寫和數字不能有任何出入:
通過在模型名後加 後綴,可以開啓擴展思考模式,模型會在回答前進行深度推理:
💡 選型建議: 日常 Claude Code 使用推薦 ,在編碼質量和響應速度之間有**平衡。複雜架構設計或難以解決的 Bug 調試時,可切換 或 。
配置好 Base URL 和 API Key 後,有兩種方式切換模型:
在 Claude Code 對話中直接輸入:
Claude Code 會彈出模型選擇列表。如果使用第三方中轉站,選擇列表中可能不會自動顯示所有模型,此時需要手動輸入模型名稱。
GPT plus 代充 只需 145
通過 環境變量,可以爲每個模型檔位指定精確的模型名稱,避免 Claude Code 使用內置的默認名稱(可能與中轉站不匹配)。
🎯 完整配置示例: 以上配置推薦保存在 ,使用 API易 apiyi.com 的 ClaudeCode 分組令牌作爲 ANTHROPIC_API_KEY。
Q1:配置了 ANTHROPIC_BASE_URL 後,Claude Code 完全無法啓動?
檢查 JSON 格式是否正確,常見錯誤:
- 最後一個鍵值對後多了逗號(JSON 不允許尾隨逗號)
- 引號使用了中文引號 而非英文引號
如果輸出正常則格式無誤,如果報錯則有語法問題。
Q2:報錯 ,但我的 Key 確實是對的?
可能原因:
- Key 前後有空格 → 檢查複製時是否帶了多餘空格
- Key 已過期或被禁用 → 登錄 重新生成
- 環境變量優先級問題 → 系統中可能存在舊的 環境變量
GPT plus 代充 只需 145
Q3:模型可以調用,但返回結果質量很差或格式異常?
可能原因:中轉站對 Anthropic 格式的支持不完整,特別是 system prompt 處理。
驗證方法:直接用 curl 測試中轉站是否正常返回:
正常響應應該包含 字段和實際的文本輸出。如果返回異常,說明中轉站有問題。
🎯 快速排查: API易 apiyi.com 完全兼容 Anthropic 原生格式,上述 curl 測試在該平臺可以正常運行。若你在測試其他中轉站,可以用此命令快速驗證兼容性。
Q4:Windows 系統下如何設置環境變量?
Windows 用戶推薦使用 settings.json 方式,更簡單可靠:
GPT plus 代充 只需 145
如果使用 PowerShell 設置臨時環境變量:
Q5:如何在不同項目中使用不同的 API 配置?
在項目根目錄創建 (此文件優先級高於全局配置):
GPT plus 代充 只需 145
注意:如果這個文件包含 Key,建議加入 避免提交到代碼倉庫。使用 (本地專用配置)更安全,它默認不會被 git 追蹤。
完成配置後,按以下步驟驗證:
在 Claude Code 對話框中輸入 查看當前連接狀態,確認 Base URL 和模型配置正確。
🎯 配置完成後: 推薦測試發送一條簡單消息,確認 Claude Code 正常響應。API易 apiyi.com 平臺支持餘額查詢,可在後臺實時監控 Claude Code 的 Token 使用情況,便於控制成本。
Claude Code 接入第三方中轉 API 出現「模型找不到」報錯,90% 的原因是 Base URL 格式不對。核心原則是:
- Base URL 不加 :填 ,Claude Code 會自動追加
- 模型名精確匹配:使用 、、 等完整名稱
- 推薦 settings.json 配置:寫入 永久生效,無需每次設置環境變量
- ClaudeCode 專用令牌:在 API易後臺選擇 ClaudeCode 分組,享 88折優惠
如果你只使用官方 Anthropic API Key 且網絡可以直連,直接在 Claude Code 中執行 命令選擇模型即可,無需任何額外配置。
🎯 獲取 API Key: 訪問 API易 apiyi.com 註冊賬號,在令牌管理頁 創建 ClaudeCode 分組令牌。平臺支持按量計費,無最低消費,按實際 Token 用量結算,適合個人和團隊使用。
本文由 API易技術團隊整理,基於 Claude Code v2.x 實際測試。如有配置問題,歡迎訪問 API易幫助中心 help.apiyi.com 獲取支持。
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/241744.html