作者注：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，但模型名拼寫錯誤（直接
/model重新選一個就好） - 接入了第三方中轉站，Base URL 配置不正確，導致模型路由失敗
本文重點講解第二種情況的完整解決方案，以 API易（apiyi.com）爲例，覆蓋環境變量、settings.json 兩種配置方式，以及最新 Claude 模型名稱對照表。
核心價值：讀完本文，你將能夠正確配置 Claude Code 接入第三方中轉 API，消除模型找不到的報錯，在國內網絡環境下穩定使用 Claude Code 的全部功能。
一、快速定位問題：是模型名錯誤還是 Base URL 問題
在動手配置前，先花 30 秒判斷你遇到的是哪類問題：
| 症狀 | 可能原因 | 解決方向 |
|---|---|---|
報錯提示 Run /model to pick a different model |
模型名不存在或無權限 | 執行 /model 重新選擇 |
| 輸入正確模型名，仍然報錯 | Base URL 配置問題 | 檢查 ANTHROPIC_BASE_URL |
| API Key 驗證失敗 | Key 無效或未設置 | 重新配置 ANTHROPIC_API_KEY |
| 網絡超時 / 連接被拒絕 | 中轉站地址填錯 | 檢查 Base URL 格式 |
| 所有模型都報錯 | 中轉站未兼容 Anthropic 格式 | 確認中轉站支持 Anthropic 原生協議 |
如果你使用的是官方 Anthropic API Key 且可以正常訪問 anthropic.com，直接在 Claude Code 中執行 /model 命令即可切換模型，無需任何額外配置。
如果你接入了第三方中轉 API（如 apiyi.com），請繼續閱讀以下配置方案。
🎯 建議: 推薦通過 API易 apiyi.com 平臺接入 Claude Code，平臺兼容 Anthropic 原生格式，支持最新的 claude-opus-4-6、claude-sonnet-4-6 等全系列模型，國內網絡穩定可用。
二、第三方中轉 API 接入 Claude Code 的核心配置
2.1 Base URL 正確格式：去掉 /v1
這是最關鍵的一步，也是最容易犯錯的地方。
Claude Code 對 Base URL 有特殊處理邏輯：它會自動在你設置的 Base URL 後面追加 /v1/messages。因此：
-
❌ 錯誤寫法：
ANTHROPIC_BASE_URL=https://api.apiyi.com/v1- 實際請求路徑變成：
https://api.apiyi.com/v1/v1/messages（重複了 /v1） - 結果：路由找不到端點，模型報錯
- 實際請求路徑變成：
-
✅ 正確寫法：
ANTHROPIC_BASE_URL=https://api.apiyi.com- 實際請求路徑變成：
https://api.apiyi.com/v1/messages - 結果：正確命中 Anthropic 原生接口
- 實際請求路徑變成：
📌 規律總結：設置
ANTHROPIC_BASE_URL時，填寫域名根路徑即可，不要加/v1後綴。Claude Code 會自動補全完整路徑。
2.2 獲取 API Key
登錄 API易後臺獲取令牌：API易令牌管理頁 api.apiyi.com/token
令牌選擇建議：
| 令牌類型 | 適用場景 | 折扣 |
|---|---|---|
| 默認令牌 | 通用場景，直接可用 | 標準價格 |
| ClaudeCode 分組令牌 | 專門用於 Claude Code | 88折優惠 |
創建新令牌時，選擇 ClaudeCode 分組，可享受 88% 折扣，長期使用成本更低。
三、兩種配置方式詳解
方式一：環境變量配置（推薦臨時測試）
在終端中執行以下命令，配置後立即生效（當前會話有效）：
# 設置第三方中轉站 Base URL（注意：不加 /v1）
export ANTHROPIC_BASE_URL="https://api.apiyi.com"
# 設置 API Key（替換爲你的實際 Key）
export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"
# 啓動 Claude Code
claude
驗證配置是否生效：
# 查看當前環境變量
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY
# 應該輸出：
# https://api.apiyi.com
# sk-xxxxxx...
優缺點：
- ✅ 簡單快速，無需修改文件
- ✅ 不影響其他會話的配置
- ❌ 每次新開終端需要重新設置（除非寫入
.zshrc/.bashrc）
永久生效方案（寫入 Shell 配置文件）：
# 對於 zsh 用戶（macOS 默認）
echo 'export ANTHROPIC_BASE_URL="https://api.apiyi.com"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-你的key"' >> ~/.zshrc
source ~/.zshrc
# 對於 bash 用戶
echo 'export ANTHROPIC_BASE_URL="https://api.apiyi.com"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="sk-你的key"' >> ~/.bashrc
source ~/.bashrc
方式二：settings.json 配置（推薦長期使用）
編輯 ~/.claude/settings.json 文件（全局配置，對所有項目生效）：
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com"，
"ANTHROPIC_API_KEY": "sk-你的APIKey"
}
}
🎯 推薦做法: 使用
~/.claude/settings.json進行全局配置，一次設置永久生效，無需每次重複配置環境變量。訪問 API易 apiyi.com 獲取 Key，選擇 ClaudeCode 分組令牌享 88折。
如果文件不存在，手動創建：
# 創建 .claude 目錄（如果不存在）
mkdir -p ~/.claude
# 創建 settings.json
cat > ~/.claude/settings.json << 'EOF'
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com"，
"ANTHROPIC_API_KEY": "sk-替換爲你的Key"
}
}
EOF
配置優先級（從高到低）：
| 優先級 | 配置來源 | 說明 |
|---|---|---|
| 1（最高） | 環境變量 | 終端中直接 export |
| 2 | .claude/settings.local.json |
項目本地配置（不提交 git） |
| 3 | .claude/settings.json |
項目共享配置 |
| 4（最低） | ~/.claude/settings.json |
全局用戶配置 |
同一配置項，高優先級會覆蓋低優先級。如果你在項目目錄也有 settings.json，記住這個優先級關係。
四、Claude Code 支持的最新模型名稱
這是 2026 年最新的 Claude 模型名稱，必須精確填寫，大小寫和數字不能有任何出入：
標準推理模型
| 模型名稱 | 系列 | 能力定位 | 適用場景 |
|---|---|---|---|
claude-opus-4-6 |
Claude 4.6 | 最強能力 | 複雜代碼、深度分析、長文檔處理 |
claude-sonnet-4-6 |
Claude 4.6 | 能力與速度平衡 | 日常編程、代碼審查、文檔撰寫 |
claude-haiku-4-5-20251001 |
Claude 4.5 | 超快響應 | 簡單問答、代碼補全、快速任務 |
增強推理模型（思考模式）
通過在模型名後加 -thinking 後綴，可以開啓擴展思考模式，模型會在回答前進行深度推理：
| 模型名稱 | 基礎模型 | 特點 |
|---|---|---|
claude-opus-4-6-thinking |
claude-opus-4-6 | 最強推理，適合數學/邏輯/複雜決策 |
claude-sonnet-4-6-thinking |
claude-sonnet-4-6 | 推理與速度均衡，日常使用首選 |
claude-haiku-4-5-20251001-thinking |
claude-haiku-4-5-20251001 | 輕量級推理 |
💡 選型建議: 日常 Claude Code 使用推薦
claude-sonnet-4-6，在編碼質量和響應速度之間有最佳平衡。複雜架構設計或難以解決的 Bug 調試時，可切換claude-opus-4-6或claude-sonnet-4-6-thinking。
五、在 Claude Code 中切換模型
配置好 Base URL 和 API Key 後，有兩種方式切換模型：
5.1 使用 /model 命令（最簡單）
在 Claude Code 對話中直接輸入：
/model
Claude Code 會彈出模型選擇列表。如果使用第三方中轉站，選擇列表中可能不會自動顯示所有模型，此時需要手動輸入模型名稱。
5.2 在 settings.json 中指定默認模型
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com"，
"ANTHROPIC_API_KEY": "sk-你的APIKey"，
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6"，
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001"，
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6"
}
}
通過 ANTHROPIC_DEFAULT_*_MODEL 環境變量，可以爲每個模型檔位指定精確的模型名稱，避免 Claude Code 使用內置的默認名稱（可能與中轉站不匹配）。
🎯 完整配置示例: 以上配置推薦保存在
~/.claude/settings.json，使用 API易 apiyi.com 的 ClaudeCode 分組令牌作爲 ANTHROPIC_API_KEY。
六、常見報錯與解決方案 FAQ
Q1：配置了 ANTHROPIC_BASE_URL 後，Claude Code 完全無法啓動？
檢查 JSON 格式是否正確，常見錯誤：
- 最後一個鍵值對後多了逗號（JSON 不允許尾隨逗號）
- 引號使用了中文引號
""而非英文引號""
# 驗證 JSON 格式
cat ~/.claude/settings.json | python3 -m json.tool
如果輸出正常則格式無誤，如果報錯則有語法問題。
Q2：報錯 Invalid API key，但我的 Key 確實是對的？
可能原因：
- Key 前後有空格 → 檢查複製時是否帶了多餘空格
- Key 已過期或被禁用 → 登錄
api.apiyi.com/token重新生成 - 環境變量優先級問題 → 系統中可能存在舊的
ANTHROPIC_API_KEY環境變量
# 檢查是否有多個來源的環境變量
env | grep ANTHROPIC
Q3：模型可以調用，但返回結果質量很差或格式異常？
可能原因：中轉站對 Anthropic 格式的支持不完整，特別是 system prompt 處理。
驗證方法：直接用 curl 測試中轉站是否正常返回：
curl https://api.apiyi.com/v1/messages \
-H "Content-Type: application/json" \
-H "x-api-key: sk-你的Key" \
-H "anthropic-version: 2023-06-01" \
-d '{
"model": "claude-sonnet-4-6"，
"max_tokens": 100，
"messages": [{"role": "user"， "content": "Say hello"}]
}'
正常響應應該包含 content 字段和實際的文本輸出。如果返回異常，說明中轉站有問題。
🎯 快速排查: API易 apiyi.com 完全兼容 Anthropic 原生格式，上述 curl 測試在該平臺可以正常運行。若你在測試其他中轉站，可以用此命令快速驗證兼容性。
Q4：Windows 系統下如何設置環境變量？
Windows 用戶推薦使用 settings.json 方式，更簡單可靠：
// C:\Users\你的用戶名\.claude\settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com"，
"ANTHROPIC_API_KEY": "sk-你的APIKey"
}
}
如果使用 PowerShell 設置臨時環境變量：
$env:ANTHROPIC_BASE_URL = "https://api.apiyi.com"
$env:ANTHROPIC_API_KEY = "sk-你的APIKey"
claude
Q5：如何在不同項目中使用不同的 API 配置？
在項目根目錄創建 .claude/settings.json（此文件優先級高於全局配置）：
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com"，
"ANTHROPIC_API_KEY": "sk-項目專用Key"
}
}
注意：如果這個文件包含 Key，建議加入 .gitignore 避免提交到代碼倉庫。使用 .claude/settings.local.json（本地專用配置）更安全，它默認不會被 git 追蹤。
七、配置驗證清單
完成配置後，按以下步驟驗證：
# 步驟 1：確認環境變量已生效
echo "Base URL: $ANTHROPIC_BASE_URL"
echo "API Key: ${ANTHROPIC_API_KEY:0:10}..."
# 步驟 2：測試 API 連通性
curl -s https://api.apiyi.com/v1/models \
-H "x-api-key: $ANTHROPIC_API_KEY" | head -c 200
# 步驟 3：啓動 Claude Code 並測試
claude --version
claude
在 Claude Code 對話框中輸入 /status 查看當前連接狀態，確認 Base URL 和模型配置正確。
🎯 配置完成後: 推薦測試發送一條簡單消息，確認 Claude Code 正常響應。API易 apiyi.com 平臺支持餘額查詢，可在後臺實時監控 Claude Code 的 Token 使用情況，便於控制成本。
總結
Claude Code 接入第三方中轉 API 出現「模型找不到」報錯，90% 的原因是 Base URL 格式不對。核心原則是：
- Base URL 不加
/v1：填https://api.apiyi.com，Claude Code 會自動追加/v1/messages - 模型名精確匹配：使用
claude-sonnet-4-6、claude-opus-4-6、claude-haiku-4-5-20251001等完整名稱 - 推薦 settings.json 配置：寫入
~/.claude/settings.json永久生效，無需每次設置環境變量 - ClaudeCode 專用令牌：在 API易後臺選擇 ClaudeCode 分組，享 88折優惠
如果你只使用官方 Anthropic API Key 且網絡可以直連，直接在 Claude Code 中執行 /model 命令選擇模型即可，無需任何額外配置。
🎯 獲取 API Key: 訪問 API易 apiyi.com 註冊賬號，在令牌管理頁
api.apiyi.com/token創建 ClaudeCode 分組令牌。平臺支持按量計費，無最低消費，按實際 Token 用量結算，適合個人和團隊使用。
本文由 API易技術團隊整理，基於 Claude Code v2.x 實際測試。如有配置問題，歡迎訪問 API易幫助中心 help.apiyi.com 獲取支持。
