Claude Code / Codex / Cursor 统一 Base URL 怎么设置？

如果你正在配置 Continue.dev 的 OpenAI-compatible Provider，也可以直接看这篇独立配置页：/continue-openai-compatible-api/，其中整理了 Base URL 是否带 /v1、模型名、401/403/404、model not found、no available channel、tool_call 与扣费记录的排查清单。

统一 Base URL 是什么

Base URL 是客户端请求 OpenAI-compatible API 的入口地址，格式类似 https://api1.link-ai.cc/v1。

• 对 LinkAI，普通请求可使用 https://api1.link-ai.cc/v1
• 长请求、长上下文按客户端 API 模式区分：Claude Code / Anthropic Messages 原生模式用 https://api2.link-ai.cc；OpenAI-compatible 模式用 https://api2.link-ai.cc/v1
• Base URL 不等于控制台登录页，不等于注册链接，不等于根域名

哪些工具适合共用 Base URL

多数 OpenAI-compatible 客户端都需要 Base URL、API Key、模型名这三个要素，但字段名和配置位置不同。

Base URL 应该填什么

普通请求

https://api1.link-ai.cc/v1

长请求 / 长输出 / Claude Code 类任务

https://api2.link-ai.cc/v1

不能填哪些地址

• ❌ 注册页面（如 #/register）
• ❌ 登录页面（如 #/login）
• ❌ 控制台页面（如 #/console/token）
• ❌ docs 页面（如 docs.link-ai.cc）
• ❌ 根域名（如 link-ai.cc）
• ❌ 带 #/ 的前端路由
• ❌ 不带 /v1 的 API 域名

api1 和 api2 怎么选

api1.link-ai.cc/v1 适合普通请求、短请求、常规 Chat API。

api2.link-ai.cc/v1 更适合长请求、长上下文、长输出、Claude Code / Codex 类任务，可以减少边缘层超时风险。

两者是独立的服务器入口，选择哪个取决于任务类型。api2 适合长任务，但不代表永不超时。

不同工具配置字段对照表

curl 测试 Base URL 是否可用

用以下命令验证 Base URL 和 API Key 是否正确：

测试 /v1/models 接口

curl https://api1.link-ai.cc/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

如果返回模型列表，说明 Base URL 和 Key 正确。如果返回 401，检查 Key 是否正确。如果返回 404，检查 Base URL 是否带 /v1。

测试 /v1/chat/completions 接口

curl https://api1.link-ai.cc/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"MODEL_NAME","messages":[{"role":"user","content":"Say hello in one sentence."}]}'

把 YOUR_API_KEY 和 MODEL_NAME 替换为真实值。正常情况下会返回 JSON 响应。

常见错误码

FAQ