CoreRouter API 文档AI 编程工具接入
CoreRouter 可以接入 Cline、Claude Code、Codex 等编程工具。和普通聊天客户端不同，编程工具通常需要模型支持工具调用、流式输出、多轮对话和较长上下文。
工具选择
| 工具 | 推荐程度 | API 格式 | Base URL | 适合场景 |
|---|---|---|---|---|
| Cline | 入门首选 | OpenAI Compatible | https://api.corerouter.tech/v1 | 配置简单，适合大多数用户 |
| Claude Code | 条件支持 | Anthropic Messages | https://api.corerouter.tech | 要求 Anthropic-compatible 接口和适合工具调用的模型 |
| Codex | 条件支持 | OpenAI Responses API | https://api.corerouter.tech/v1 | 要求模型支持 Responses |
不建议直接承诺支持的工具
| 工具 | 结论 | 原因 |
|---|---|---|
| Cursor | 暂不作为正式支持项 | 自定义 API Key / Base URL 主要面向聊天模型，Tab、内置 Agent、模型路由和部分高级能力不一定走自定义接口。 |
| 只支持官方登录的 IDE 插件 | 不支持 | 不能填写自定义 Base URL、API Key 和 Model ID。 |
| 强制 Responses API 的 Agent | 条件支持 | 只有支持 Responses 的 Model ID 才能接入，普通 Chat Completions 模型不可直接复用。 |
| 强制 Anthropic 原生全部端点的工具 | 条件支持 | 如果工具依赖未开放的 Anthropic 辅助端点，可能无法完整工作。 |
| 强制 Assistants、Threads、Files 或 Batches 的 Agent | 不支持对应功能 | 文档提供的是 Chat、Responses、Anthropic Messages 等模型调用入口，不包含这些资源管理接口。 |
模型要求
建议优先选择控制台中标记支持以下能力的模型：
- Tool Calling / Tool Use
- Streaming
- Coding Agent
- 长上下文
- Responses API 或对应工具要求的协议
普通聊天可用，不代表一定适合编程 Agent。如果工具能聊天但无法读文件、改文件或执行多步任务，优先检查模型能力。
配置前先做协议验证
| 工具 | 建议先验证 |
|---|---|
| Cline | /v1/chat/completions 和工具调用 |
| Claude Code | /v1/messages |
| Codex | /v1/responses，并使用支持 Responses 的 Model ID |
如果对应接口的 curl 都失败，先不要继续调工具配置。请先修正 API Key、Base URL、模型 ID 或模型能力。
推荐测试流程
配置完成后按顺序测试：
- 基础对话：
请介绍一下你自己。 - 项目分析：
请分析当前项目的目录结构。 - 文件读取：
请查看 package.json 并总结主要依赖。 - Agent 任务：
请创建一个 hello.ts 文件，实现 hello 函数，然后运行测试。
前一步失败时，先不要继续复杂任务，先检查 Base URL、API Key、Model ID 和模型能力。
常见问题
普通聊天正常，但无法执行任务
通常是模型没有稳定支持 Tool Calling、流式输出或多轮 Agent 格式。换用明确支持 Coding Agent 的模型后再测。
工具提示连接失败
检查三项：
- API Key 是否完整且未带多余空格。
- Base URL 是否符合该工具要求。
- Model ID 是否来自 CoreRouter 控制台。
- 当前工具需要的接口是否可用，例如 Codex 需要所选 Model ID 支持
/v1/responses。
不同工具的 Base URL 不一样
| 工具 | Base URL |
|---|---|
| Cline | https://api.corerouter.tech/v1 |
| Claude Code | https://api.corerouter.tech |
| Codex | https://api.corerouter.tech/v1 |
Claude Code 使用 Anthropic API 风格，Base URL 不带 /v1。Cline 和 Codex 使用 OpenAI 风格，一般使用带 /v1 的地址。
安全建议
- 为编程工具创建独立 API Key。
- 给该 API Key 设置合理额度上限。
- 不要把 API Key 写入项目源码或提交到 Git。
- API Key 泄露后立即禁用或删除。