作者注：Claude Code 接入第三方中转 API 后报错「模型找不到」的完整解决方案：Base URL 正确写法、settings.json 配置方法、最新模型名称对照表。
在国内使用 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 获取支持。
