Claude Code
CLIAPI Key:
登录后台 → API令牌 → 复制
Base URL:
https://api.quickrouter.ai
模型示例:
claude-sonnet-4-6
填写位置:
环境变量或 ~/.claude/settings.json
Answer
先给结论
Claude API 在国内通常无法直接稳定访问。使用 QuickRouter 后，注册获取 API Key，按工具填写对应 URL，就可以在国内调用 Claude 模型。Claude Code 使用 https://api.quickrouter.ai；Cursor、Codex、opencode 使用 https://api.quickrouter.ai/v1；Trae 按一般模型 URL 和 Claude 模型 URL 分开填写。
QuickRouter 的解决方式
QuickRouter 提供国内直连的 Claude API 中转服务。你只需要注册获取 QuickRouter API Key，然后按工具填写对应 URL。页面下方已经列出 Claude Code、Cursor、Codex、opencode、Trae、Cherry Studio 的具体配置入口，适合从搜索页直接开始配置。
直接访问为什么不稳定
Claude API 官方端点部署在海外，国内网络环境下容易出现连接超时、流式输出中断、工具无响应等问题。开发工具需要稳定的长连接，临时代理或 VPN 很容易影响编程体验。
工具配置最容易错在哪里
Claude Code、Cursor、Trae 填的地址并不完全一样。Claude Code 不加 /v1；Cursor、Codex、opencode 通常填 /v1；Trae 需要区分一般模型 URL 和 Claude 模型 URL。
为什么建议先免费试用
不同工具保存配置的位置不同。先免费试用跑通一次，可以确认 API Key、URL 和模型名都正确，再迁移到正式项目或团队环境。
不要填错 URL
Claude Code 填 https://api.quickrouter.ai；Cursor、Codex、opencode 填 https://api.quickrouter.ai/v1；Trae 按“一般模型 URL”和“Claude 模型 URL”分别填写。
配置速查
先按工具确认 URL、API Key 和模型名，再进入完整教程。这样从搜索页进来的用户可以直接完成第一次调用。
先确认你要填哪个地址
不同工具要填的位置不一样，最容易出错的是把 OpenAI 兼容地址填到 Claude Code，或者把 Claude 原生地址填到普通 OpenAI SDK。
Claude Code
https://api.quickrouter.ai
填到 ANTHROPIC_BASE_URL，API Key 使用 QuickRouter 后台的 API 令牌。
Cursor / Codex / opencode
https://api.quickrouter.ai/v1
这类工具通常走 OpenAI 兼容协议，模型名可先用 claude-sonnet-4-6 验证。
Trae 一般模型 URL
https://api.quickrouter.ai/v1/chat/completions
用于 GPT、Gemini、DeepSeek 等 OpenAI Chat Completions 兼容模型。
Trae Claude 模型 URL
https://api.quickrouter.ai/anthropic/v1/messages
Trae 里调用 Claude 模型时使用这个 Claude 专用地址。
首次调用失败，按这个顺序排查
不要一开始就改完整项目。先用一个简单对话确认请求能进入 QuickRouter，再排查具体工具配置。
1. 看后台是否有请求记录
控制台请求记录
没有记录，多半是 URL 没生效、工具仍在使用旧配置，或 API Key 没保存成功。
2. 检查 URL 是否匹配工具
Claude Code 不加 /v1
Cursor、Codex、opencode 用 /v1；Trae 按一般模型 URL 和 Claude 模型 URL 分开填。
3. 检查模型名
claude-sonnet-4-6
先用推荐模型跑通。出现 model not found、404 或无输出时，再去控制台确认模型 ID。
4. 检查 API Key
登录后台 → API令牌 → 复制
不要填 Anthropic 官方 Key，不要带空格，不要把旧 Key 留在工具配置里。
常见填错位置
Claude Code
环境变量或 ~/.claude/settings.json
重点检查 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL。
Cursor
Settings → Models
适合填 OpenAI 兼容 Base URL：https://api.quickrouter.ai/v1。
Trae
Settings → Models → Custom Model
一般模型和 Claude 模型 URL 要分开填。
适合的开发场景
✓
Claude Code 编程用 Claude 做代码生成、代码审查、重构和长任务分析
✓
Cursor 辅助开发在 IDE 里接入 Claude 模型，处理复杂代码上下文
✓
Trae / opencode / Codex按工具要求填写 URL，快速完成首次调用
✓
团队 API 集成统一 API Key 和模型入口，减少每个成员单独配置的成本
下一步配置
选择你的工具，完成第一次调用
如果你是从搜索进入本页，可以直接按正在使用的工具复制 API Key、Base URL、模型示例，并跳转到对应配置教程。
opencode
TerminalAPI Key:
登录后台 → API令牌 → 复制
Base URL:
https://api.quickrouter.ai/v1
模型示例:
claude-sonnet-4-6
填写位置:
~/.config/opencode/opencode.json+auth.json
Cursor
IDEAPI Key:
登录后台 → API令牌 → 复制
Base URL:
https://api.quickrouter.ai/v1
模型示例:
claude-sonnet-4-6
填写位置:
Settings → Models
Codex
AgentAPI Key:
登录后台 → API令牌 → 复制
Base URL:
https://api.quickrouter.ai/v1
模型示例:
gpt-5.5
填写位置:
~/.codex/config.toml + ~/.codex/auth.json
Cherry Studio
DesktopAPI Key:
登录后台 → API令牌 → 复制
Base URL:
https://api.quickrouter.ai
模型示例:
claude-sonnet-4-6
填写位置:
设置 → 添加 → 添加提供商
Trae
BuilderAPI Key:
登录后台 → API令牌 → 复制
一般模型 URL:
https://api.quickrouter.ai/v1/chat/completions
Claude 模型 URL:
https://api.quickrouter.ai/anthropic/v1/messages
模型示例:
gpt-5.5 / claude-sonnet-4-6
填写位置:
Settings → Models → Custom Model
常见问题
Claude Code 应该填 /v1 吗？▾
不应该。Claude Code 使用 https://api.quickrouter.ai，不要加 /v1。Cursor、Codex、opencode 这类 OpenAI 兼容工具才使用 https://api.quickrouter.ai/v1。
为什么后台没有请求记录？▾
通常是工具没有真正请求到 QuickRouter。优先检查 Base URL 是否填错、API Key 是否保存成功、工具是否仍在使用旧配置。
Cursor 填了 Base URL 但没生效怎么办？▾
先确认填的是 https://api.quickrouter.ai/v1，并检查模型配置是否启用自定义模型。保存后建议重启 Cursor 或重新打开会话，再看 QuickRouter 后台是否出现请求记录。
Trae 为什么有两个 URL？▾
Trae 的一般模型 URL 用于 OpenAI Chat Completions 兼容模型；Claude 模型 URL 用于 Claude 原生 messages 接口。调用 Claude 时不要混用。
可以先免费试用再充值吗？▾
可以。注册后即可免费试用，建议先用 claude-sonnet-4-6 跑通一次调用，再根据实际使用量充值。
模型名填错会怎样？▾
常见表现是 model not found、404 或工具里没有输出。先使用页面里的模型示例验证，完整模型列表和价格以控制台或价格页为准。
免费试用额度够不够完成测试？▾
够完成基础连通性测试。建议先用一个简单问题验证 API Key、URL 和模型名，再接入 Claude Code、Cursor 或 Trae 的真实开发场景。