Codex
Base URL 填 https://api.linktoagi.com/v1，并使用 Responses 协议。
先把三个关键变量分开
同一个错误可能由不同层级触发。按地址、认证、模型或并发逐层验证，比同时修改所有配置更容易定位原因。
Claude Code
ANTHROPIC_BASE_URL 填 https://api.linktoagi.com，不在末尾添加 /v1。
API Key
两个客户端都使用控制台创建的 Key；建议按项目或工具分别创建。
三步完成最小验证
保留一个可复现的短请求，每次只修改一个变量，并记录返回状态。
添加供应商
在 CC Switch 中新增自定义供应商，名称填写 LinkAGI。
按工具填地址
Codex 与 Claude Code 分别使用对应地址，不复制同一套 URL。
启用并验证
切换到 LinkAGI 配置后启动工具，用短提示验证，再打开使用日志核对。
两种工具的地址速查
Codex / OpenAI Responses
https://api.linktoagi.com/v1
Claude Code / Anthropic Messages
https://api.linktoagi.com
API Key
sk-从 LinkAGI 控制台创建API Key 只放在环境变量或客户端密钥字段中，不要写进公开仓库、截图或前端代码。模型名与价格请从 LinkAGI 实时模型广场复制。
结果出现后，下一步看什么
不要把所有失败都归因到“中转站不稳定”。先判断请求停在路径、认证、模型、速率还是超时层。
切换后仍走旧地址
确认 CC Switch 已启用新供应商，并完全重启对应 CLI 或桌面客户端。
Codex 返回 404
检查 base_url 是否缺少 /v1，以及协议是否为 Responses。
Claude Code 返回 404
检查根地址末尾是否错误添加 /v1，形成 /v1/v1/messages。
能连接但模型报错
从模型广场复制当前模型名，并确认 Key 的分组允许访问该模型。
LinkAGI 场景
使用 api.linktoagi.com 接入后，可以在控制台调用日志中核对模型、Token、状态和扣费；遇到持续异常可携带时间与请求信息联系支持，但不要发送完整 API Key。
常见问题
CC Switch 是必须的吗？
不是。它只是图形化管理和切换配置的工具，也可以直接编辑 Codex config.toml 或 Claude Code settings.json。
一个 Key 能不能给两个工具用？
技术上可以，但为便于撤销、限额和排错，建议不同工具或项目使用独立 Key。
切换配置后为什么没有生效？
部分客户端只在启动时读取环境变量，需要完全退出后重新启动。
继续排查相关问题
Codex 404 Invalid URL
Codex 返回 404：Base URL 不是最终请求地址
Codex 会在 Base URL 后继续追加 /responses。根地址少一层 /v1 会得到错误路径；反过来，Claude Code 如果也照抄 /v1，则可能拼成 /v1/v1/messages。
Claude Code model not foundClaude Code 提示 Model Not Found：模型名正确还不够
模型不存在可能是拼写或版本后缀错误，也可能是令牌分组没有该模型、号池临时不可用，或者客户端仍在读取旧环境变量。排查时不要只反复改名字。
OpenAI API 中转站OpenAI API 国内接入：Base URL、Key 与首次请求一次配置
如果现有代码已经使用 OpenAI SDK，迁移到 LinkAGI 通常只需要替换 Base URL 与 API Key。真正容易出错的不是代码主体，而是地址层级、模型名和密钥分组。
先用短请求验证 LinkAGI
注册赠送 ¥0.2 试用额度；模型、号池和价格以实时页面为准。