先看错误信息
model not foundClaude Code model not found 先核对当前平台授权且支持 Messages 的准确模型 ID，再检查用户、项目和启动环境中的模型覆盖。展示名称和其他平台别名不能直接当作接口 ID，修改后在新会话验证。
正在打开页面…
正在加载内容，请稍候。
- 保留现场
记录状态码、错误正文和请求时间
- 缩小范围
按下方检查项逐个排除，不同时修改多项
- 最小复测
用同一请求验证，再回到原工具测试
选出你的现象，查看下一步
只需选择错误类型，无需粘贴密钥或完整日志。本页不会发送 API 请求，也不会自动判定连接成功。
先取得错误详情，暂时不能确定原因
- 展开错误详情，记录时间、HTTP 状态、错误码和最终请求路径。不要只截最外层提示。
- 核对服务商协议、模型 ID、API 地址；然后按对应教程进行同条件终端检查。
新会话只问“只回复 OK”，确认平台收到对应 Messages 请求；再授权读取测试 README。记录版本、请求时间与脱敏错误，不把终端 API 成功写成客户端实测。
查看 Claude Code 完整配置教程记录仅在浏览器中生成；下载后可补充脱敏结果，便于对照复测或提交客服。
常见表现
- 认证成功但模型调用失败
- 错误里出现 model not found
- 换 Key 后仍然失败
这个报错是什么意思
model not found 需要结合错误正文定位。apizt 的 ANTHROPIC_BASE_URL 使用 https://api.apizt.com，模型调用应到 /v1/messages。不能把 Chat Completions 或 Responses 地址当作 Claude Code 接口。
先判断是哪一类问题
对照请求链路定位失败阶段
判断 01
apizt 的 ANTHROPIC_BASE_URL 使用 https://api.apizt.com，模型调用应到 /v1/messages。不能把 Chat Completions 或 Responses 地址当作 Claude Code 接口。
判断 02
仅改 Base URL 不代表已更换登录凭据。遇到 401 应核对当前有效认证方式；403 则结合正文查权限或访问限制。
判断 03
CC Switch 显示切换完成不等于模型调用已成功。文字、工具调用及其他高级能力要分别验证。
按顺序修复
01
核对平台实际授权且支持当前协议的模型 ID
02
检查 ~/.claude/settings.json
03
删除项目内覆盖配置
04
重启 Claude Code
详细修复步骤
Step 01
找到实际生效的配置
使用 CC Switch 时确认选中 Claude Code 对应的提供商并已启用；核对写入或代理的目标，不把 Codex 的配置当作 Claude Code 配置。
Step 02
核对协议与凭据
检查当前进程读取的 ANTHROPIC_BASE_URL 和有效网关凭据来源；不要输出 Key。ANTHROPIC_AUTH_TOKEN 与 ANTHROPIC_API_KEY 按网关认证方式使用，避免遗留冲突。
Step 03
回到新会话验证
保留全局与项目 settings 备份，检查环境变量或项目设置覆盖；退出旧进程后重新启动，选择平台实际授权且支持 Messages 的模型。
正确配置
apizt 的 ANTHROPIC_BASE_URL 使用 https://api.apizt.com，模型调用应到 /v1/messages。不能把 Chat Completions 或 Responses 地址当作 Claude Code 接口。
模型 ID：从当前平台授权列表复制，不能用显示名称代替。
API Key：在客户端安全输入；本页无需提供。
成功判据：新会话只问“只回复 OK”，确认平台收到对应 Messages 请求；再授权读取测试 README。记录版本、请求时间与脱敏错误，不把终端 API 成功写成客户端实测。常见原因
- 使用了过期 Claude 模型名
- 模型名里多了空格
- 工具配置覆盖了环境变量
- 项目级 settings.json 写了旧模型
怎么确认已经修好
- 新会话只问“只回复 OK”，确认平台收到对应 Messages 请求；再授权读取测试 README。记录版本、请求时间与脱敏错误，不把终端 API 成功写成客户端实测。
- 记录客户端版本、请求时间、模型 ID、HTTP 状态和请求 ID。文字成功后再测试所需工具、图片或长上下文功能。
- 页面提供配置核对与复测步骤，没有连接你的客户端；本页未提供该客户端的真实付费调用验证结果。
避免下次再报错
- 团队内统一一份 Base URL 和模型名，不要让每个人从不同教程复制配置。
- 给生产任务和个人调试任务分开 API Key，方便定位是谁触发了限流或余额消耗。
- 工具升级后先保留旧配置备份，再用一个短 prompt 验证连通性。
- 把正确配置写进团队文档，尤其标明 Claude Code 和 OpenAI 兼容工具的 Base URL 差异。
仍未解决？这样提供排查信息
记录报错时间、工具版本、模型 ID 和 HTTP 状态码，附上脱敏后的错误正文。
说明问题是否稳定复现，以及同一配置的最小请求是否成功。
可以提供请求 ID 或控制台日志编号，不要发送完整 API Key、密码或个人业务数据。
先区分配置、权限、额度与上游服务问题；不要通过重复充值或高频重试来排查。
排查完成后，再开始接入
先按上文检查地址、鉴权与协议，并完成复测。确认要使用 apizt 后，再创建 API Key、选择模型并配置工具；充值不能修复配置错误。
创建 API Key
在控制台创建令牌，选择需要使用的模型权限。
填写接入配置
按工具要求填写 API Key、接口地址与模型 ID。
发起第一次调用
确认收到有效结果，再到控制台查看用量与费用。
FAQ
Claude Code model not found 是 API Key 无效吗？
两者需分开判断。有效令牌仍可能没有目标模型权限，或配置了错误 ID；查看错误正文与令牌分组目录，确认该路由支持 Messages。
Claude Code 模型名改了仍报 model not found 怎么查？
检查用户 settings、项目配置和当前会话选中的模型是否覆盖了新值。保留原配置备份并只修改相关字段，重启后查看实际发出的模型 ID。
Claude Code 应该填写哪个 API 地址？
apizt 的 ANTHROPIC_BASE_URL 使用 https://api.apizt.com，模型调用应到 /v1/messages。不能把 Chat Completions 或 Responses 地址当作 Claude Code 接口。
终端请求成功，为什么客户端仍然失败？
仅改 Base URL 不代表已更换登录凭据。遇到 401 应核对当前有效认证方式；403 则结合正文查权限或访问限制。 CC Switch 显示切换完成不等于模型调用已成功。文字、工具调用及其他高级能力要分别验证。 终端结果只有在同一 Key、模型、端点和实际运行网络下才具有可比性。
本页是否代表已经实测全部功能？
不是。本页为配置核对与排错指南，依据官方文档及现有教程整理。客户端版本和真实调用结果需要按步骤记录；网页检查通过不能替代客户端实测。
2026 年 11 月 5 日补测
Claude Code model not found：核对请求中的准确 ID
同一个模拟路由提交可用和不可用 ID，检查状态码和请求模型。
- 本地 HTTP 故障复现（固定回包）。
- 准备独立样例。安装文章所用客户端，或用 Python 3.11+ 运行标注为本地 HTTP/TOML 的样例。
- 本例操作：同一个模拟路由提交可用和不可用 ID，检查状态码和请求模型。
- 解压练习包，执行 python3 lab.py --output ./result u08。完整命令、样例输入和输出保存在回执。
- 打开 result/u08.json，对照实际退出码、请求路径或产物字段。
- 逐项确认下方通过条件。本例的测试范围以运行回执为准。
- 通过：错误与正确模型使用同一请求路径
先下载样例，再完成自己的首次调用
示例不含密钥。API 按实际用量计费；下载和点击不代表调用成功。