常用编程工具配置入口
不要到处找配置。先选你实际在用的 coding 工具，再走对应入口。
对编码团队来说，TheRouter 的正确上手方式不是先读完所有能力页，而是先把你日常在用的 coding 工具接好，再验证第一条成功请求。这页把常见路径收拢在一起。
推荐先看的入口
需要更细步骤的工具，直接开独立导读；只需要简单替换 base URL + key 的工具，先看下面的速配模板。
Cursor 接入导读
中文导读把 Cursor 指向 TheRouter，先确认 OpenAI 兼容 base URL、模型别名和首个请求验证都正确。
打开入口Claude Code 接入导读
中文导读用 TheRouter 的 Anthropic 兼容入口接入 Claude Code，按环境变量覆盖和验证步骤快速跑通。
打开入口cc-switch 配置教程
新增把 TheRouter 预设接进 cc-switch，让 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 共用一把 key。
打开入口OpenClaw 接入指南
Agent 框架把 OpenClaw 配到 TheRouter 的 OpenAI 兼容入口，并用推荐模型快速部署你的 agent 工作流。
打开入口OpenAI 兼容工具速配模板
Windsurf、Cline、Continue、OpenCode 这类工具最重要的是：base URL 指向 TheRouter、key 用 tenant routing key、模型名严格跟 /v1/models 保持一致。
Windsurf
打开 Windsurf 设置 → AI → Custom API
Base URL: https://api.therouter.ai/v1
API Key: <THEROUTER_API_KEY>
Model: anthropic/claude-sonnet-4.6什么时候应该用 cc-switch
如果你需要在 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 之间切换 provider， 又不想手改每个工具的本地配置，cc-switch 是更合适的控制面。
text
1. 先在 TheRouter 控制台创建 tenant API key
2. 打开 cc-switch，选择目标客户端
3. Add Provider → 选择 TheRouter preset
4. 粘贴 key，启用 preset，必要时重启目标 CLI先验证，再排错
任何工具接不通时，都先回到模型列表验证。别先怀疑工具本身。
bash
curl https://api.therouter.ai/v1/models \
-H "Authorization: Bearer $THEROUTER_API_KEY" | head -c 400不要混用不同协议的 base URL
OpenAI 兼容工具通常应该用
https://api.therouter.ai/v1。 Claude Code 这类 Anthropic 原生客户端应该用根域名https://api.therouter.ai。Gemini 原生客户端则按 Gemini 入口规则走。