Codex Base URL
填写 https://api.linktoagi.com/v1，客户端继续追加 /responses。
先把三个关键变量分开
同一个错误可能由不同层级触发。按地址、认证、模型或并发逐层验证，比同时修改所有配置更容易定位原因。
不要填完整端点
不要把 /v1/responses 直接填入 base_url，否则客户端可能再次追加。
确认协议
wire_api 使用 responses，避免按旧版 chat completions 配置理解路径。
三步完成最小验证
保留一个可复现的短请求，每次只修改一个变量，并记录返回状态。
展开最终 URL
把 Base URL 与客户端追加路径写在一行，确认结果是 /v1/responses。
删除重复片段
检查代理、环境变量和配置文件是否分别添加了一次 /v1。
用 401 验证路由
不带 Key 的最小请求若返回 401，说明已到认证层；这仍不代表模型可用。
正确与错误路径对照
正确：
https://api.linktoagi.com/v1 + /responses
= https://api.linktoagi.com/v1/responses
错误一：缺少 /v1
https://api.linktoagi.com/responses
错误二：Base URL 已填完整端点
https://api.linktoagi.com/v1/responses/responsesAPI Key 只放在环境变量或客户端密钥字段中，不要写进公开仓库、截图或前端代码。模型名与价格请从 LinkAGI 实时模型广场复制。
结果出现后，下一步看什么
不要把所有失败都归因到“中转站不稳定”。先判断请求停在路径、认证、模型、速率还是超时层。
404 Invalid URL
优先检查最终路径，不要先换 API Key 或模型。
网页能打开但接口 404
首页可达只证明域名和 TLS 正常，API 路由仍可能拼错。
配置看似正确仍 404
检查是否还有系统环境变量、CC Switch 或旧配置覆盖当前 base_url。
修正后返回 401
路径已到认证层，下一步检查 API Key；这是排错进展。
LinkAGI 场景
使用 api.linktoagi.com 接入后，可以在控制台调用日志中核对模型、Token、状态和扣费；遇到持续异常可携带时间与请求信息联系支持，但不要发送完整 API Key。
常见问题
Codex 能不能使用根地址？
按当前 LinkAGI Responses 路由，Codex Base URL 应保留 /v1。
为什么 Claude Code 正好相反？
Claude Code 会自己追加 /v1/messages，因此使用根地址，不能机械照抄 Codex。
401 和 404 哪个更接近成功？
就路由排错而言，401 说明到达认证层；404 通常仍停在路径匹配之前。
继续排查相关问题
Codex 401 Invalid token
Codex 返回 401：先别改模型，认证链路才是第一现场
401 通常说明域名、HTTPS 和接口路由已经可达，请求停在认证阶段。它不能证明模型可用，但能帮助你把排查范围缩小到 API Key、环境变量和令牌状态。
CC Switch API 中转站CC Switch 配置 LinkAGI：两种工具的地址不要填成一样
CC Switch 适合需要在多个 API 提供方之间切换的用户。最常见的失败原因，是把 Codex 与 Claude Code 都填成同一个 Base URL，导致一个缺少 /v1，另一个重复 /v1。
AI API 504 Gateway TimeoutAI API 返回 504：上游没坏，也可能卡在首字节和代理超时
504 表示某一层网关没有在规定时间内拿到下游响应。上游控制台显示正常，并不能排除单请求首字节过慢、边缘代理超时、非流式长任务或客户端提前断开。
先用短请求验证 LinkAGI
注册赠送 ¥0.2 试用额度；模型、号池和价格以实时页面为准。