模型名
完整复制大小写、数字和版本后缀，不根据旧文章手写。
先把三个关键变量分开
同一个错误可能由不同层级触发。按地址、认证、模型或并发逐层验证，比同时修改所有配置更容易定位原因。
令牌分组
同一模型可能只在特定分组可用，Key 必须允许对应分组。
配置生效
修改环境变量或 settings.json 后，完全退出并重新启动 Claude Code。
三步完成最小验证
保留一个可复现的短请求，每次只修改一个变量，并记录返回状态。
打开实时模型广场
确认目标模型当前存在，并复制页面显示的完整模型名。
检查 Key 与分组
为 Claude Code 创建单独 Key，明确选择允许该模型的分组。
用短提示验证
重启客户端后发送短请求，再从使用日志确认实际命中的模型。
Claude Code 基础环境变量
export ANTHROPIC_BASE_URL="https://api.linktoagi.com"
export ANTHROPIC_AUTH_TOKEN="sk-替换成你的Key"
export ANTHROPIC_MODEL="从控制台复制当前模型名"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1API Key 只放在环境变量或客户端密钥字段中，不要写进公开仓库、截图或前端代码。模型名与价格请从 LinkAGI 实时模型广场复制。
结果出现后，下一步看什么
不要把所有失败都归因到“中转站不稳定”。先判断请求停在路径、认证、模型、速率还是超时层。
名称存在但仍报错
检查 Key 分组、令牌状态和模型当前号池，不要只比较字符串。
改名后客户端没变化
确认配置文件位置，并完全退出旧进程后重新启动。
根地址写成 /v1
Claude Code 会继续追加 /v1/messages，重复路径通常先表现为 404。
某个模型临时不可用
查看站点公告和模型广场，先用经过验证的替代模型完成连通测试。
LinkAGI 场景
使用 api.linktoagi.com 接入后，可以在控制台调用日志中核对模型、Token、状态和扣费；遇到持续异常可携带时间与请求信息联系支持，但不要发送完整 API Key。
常见问题
可以直接写 claude-sonnet-latest 吗？
应以控制台实际提供的模型名为准；别名是否存在取决于当前配置。
模型广场能看到就一定能调用吗？
还要看令牌分组、余额、模型号池和实时状态，页面可见不是单次请求成功承诺。
为什么需要重启 Claude Code？
部分环境变量只在进程启动时读取，旧进程不会自动获得新值。
继续排查相关问题
CC Switch API 中转站
CC Switch 配置 LinkAGI：两种工具的地址不要填成一样
CC Switch 适合需要在多个 API 提供方之间切换的用户。最常见的失败原因，是把 Codex 与 Claude Code 都填成同一个 Base URL，导致一个缺少 /v1，另一个重复 /v1。
Codex 401 Invalid tokenCodex 返回 401：先别改模型，认证链路才是第一现场
401 通常说明域名、HTTPS 和接口路由已经可达，请求停在认证阶段。它不能证明模型可用，但能帮助你把排查范围缩小到 API Key、环境变量和令牌状态。
AI API 504 Gateway TimeoutAI API 返回 504：上游没坏，也可能卡在首字节和代理超时
504 表示某一层网关没有在规定时间内拿到下游响应。上游控制台显示正常，并不能排除单请求首字节过慢、边缘代理超时、非流式长任务或客户端提前断开。
先用短请求验证 LinkAGI
注册赠送 ¥0.2 试用额度；模型、号池和价格以实时页面为准。