# 你的工具，一个 API Key。

> 规范页面: https://router.one/zh/integrations
> 最后更新: 2026-09-20

找到正在使用的工具，按指南完成配置，再验证第一次模型调用。Router One 处理模型请求，agent 与工作流仍由你的应用运行。

[发起第一次 API 调用](https://router.one/zh/docs/guides/quickstart)

## 找到你的接入方式

按工具或使用场景查找，再核对对应的 provider 配置与模型要求。

### 编程与 agent 工具

- [Claude Code](https://router.one/zh/claude-code-china) — 终端编程 agent · Anthropic Messages 配置
- [Codex CLI](https://router.one/zh/codex-china) — 终端编程 agent · Responses 与 config.toml
- [Cline](https://router.one/zh/integrations/cline) — VS Code agent · OpenAI 兼容 provider
- [Aider](https://router.one/zh/integrations/aider) — 终端结对编程 · 模型与端点配置
- [Roo Code](https://router.one/zh/integrations/roo-code) — VS Code agent · 自定义 provider 配置
- [OpenCode](https://router.one/zh/integrations/opencode) — 终端 agent · opencode.json provider 配置
- [Kilo Code](https://router.one/zh/integrations/kilo-code) — VS Code agent · provider 与模型选择
- [Cursor](https://router.one/zh/integrations/cursor) — 自带 API Key · 聊天配置与功能边界
- [OpenClaw](https://router.one/zh/integrations/openclaw) — Agent CLI · 自定义 provider 与消费上限
- [Zed](https://router.one/zh/integrations/zed) — Agent Panel · settings.json 模型配置
- [Continue](https://router.one/zh/integrations/continue) — IDE 助手 · config.yaml 与聊天角色
- [GitHub Copilot](https://router.one/zh/integrations/github-copilot) — VS Code Chat · 自定义端点与 BYOK 范围
- [OpenHands](https://router.one/zh/integrations/openhands) — 编程 agent · provider 与协议选择
- [Xcode](https://router.one/zh/integrations/xcode) — Xcode 26 聊天 provider · 主机根地址与模型列表
- [Qwen Code](https://router.one/zh/integrations/qwen-code) — 终端编程 agent · OPENAI_* 环境变量与 modelProviders
- [Goose](https://router.one/zh/integrations/goose) — 桌面与命令行 agent · OPENAI_HOST 或自定义 provider
- [Pi Agent](https://router.one/zh/integrations/pi) — 终端编程 Agent · models.json 与显式供应商选择

### SDK 与框架

- [LangChain](https://router.one/zh/integrations/langchain) — ChatOpenAI · 显式配置 Chat Completions
- [LlamaIndex](https://router.one/zh/integrations/llamaindex) — OpenAILike · 聊天模型与上下文设置
- [Vercel AI SDK](https://router.one/zh/integrations/vercel-ai-sdk) — TypeScript · provider 与聊天 API 选择
- [OpenAI SDK](https://router.one/zh/integrations/openai-sdk) — Python 与 TypeScript · 第一次聊天请求
- [Pydantic AI](https://router.one/zh/integrations/pydantic-ai) — Python agents · OpenAIChatModel 与 provider 配置
- [CrewAI](https://router.one/zh/integrations/crewai) — Python agents · 自定义 OpenAI 兼容 LLM
- [Spring AI](https://router.one/zh/integrations/spring-ai) — Java · 按版本核对 base URL
- [OpenAI Agents SDK](https://router.one/zh/integrations/openai-agents-sdk) — Python agents · 显式 Chat Completions 模型
- [Claude Agent SDK](https://router.one/zh/integrations/claude-agent-sdk) — Claude Code 运行时 · 环境变量与模型配置
- [Haystack](https://router.one/zh/integrations/haystack) — Python 管线 · 聊天生成器与 RAG 边界
- [Google ADK](https://router.one/zh/integrations/google-adk) — Python agents · 带 api_base 的 LiteLlm 模型
- [smolagents](https://router.one/zh/integrations/smolagents) — Hugging Face agents · 带 api_base 的 OpenAIModel
- [Mastra](https://router.one/zh/integrations/mastra) — TypeScript agents · 带 url 和 apiKey 的模型对象
- [DSPy](https://router.one/zh/integrations/dspy) — Python LM 程序框架 · 带 openai/ 前缀和 api_base 的 dspy.LM
- [Microsoft Agent Framework](https://router.one/zh/integrations/microsoft-agent-framework) — Python 与 .NET agents · 带 base_url 的 OpenAIChatCompletionClient
- [Agno](https://router.one/zh/integrations/agno) — Python Agent 框架 · OpenAILike 与精确模型 ID

### 聊天、知识库与翻译

- [Open WebUI](https://router.one/zh/integrations/open-webui) — 自托管聊天 · OpenAI API 连接
- [LibreChat](https://router.one/zh/integrations/librechat) — 自托管聊天 · librechat.yaml 自定义端点
- [Immersive Translate](https://router.one/zh/integrations/immersive-translate) — 浏览器翻译 · 完整 Chat Completions 地址
- [NextChat](https://router.one/zh/integrations/nextchat) — 聊天客户端 · BASE_URL 主机根地址配置
- [AnythingLLM](https://router.one/zh/integrations/anythingllm) — 知识库聊天 · Generic OpenAI 配置
- [Chatbox / Cherry Studio](https://router.one/zh/chatbox-cherry-studio) — 桌面聊天 · 自定义 provider 与模型配置

### 工作流与 API 工具

- [Dify](https://router.one/zh/integrations/dify) — 应用工作流 · OpenAI 兼容 provider
- [n8n](https://router.one/zh/integrations/n8n) — 工作流节点 · OpenAI 凭证与 API 核对
- [FastGPT](https://router.one/zh/integrations/fastgpt) — AI Proxy 渠道 · 模型 ID 与工作流调用
- [Flowise](https://router.one/zh/integrations/flowise) — 低代码 LLM 流程 · OpenAI Custom Model 节点与 Base Path
- [Langflow](https://router.one/zh/integrations/langflow) — 可视化流程与 Agent 搭建 · OpenAI Compatible 模型供应商
- [RAGFlow](https://router.one/zh/integrations/ragflow) — 自部署 RAG 引擎 · OpenAI-API-Compatible 提供商实例
- [MaxKB](https://router.one/zh/integrations/maxkb) — 知识库应用 · OpenAI 供应商与自定义基础模型
- [one-api / new-api](https://router.one/zh/llm-api-relay-station) — API 中转站 · OpenAI 上游渠道配置

## 第一次请求前，核对这三件事

### 地址与客户端字段对应

base URL 和完整请求端点不是同一个值。复制地址前，先确认客户端的配置字段与所选协议。

[检查连接配置](https://router.one/zh/api-connection-troubleshooting)

### 填写精确的模型 ID

从模型目录复制 ID，核对模型支持的端点与能力，是否满足客户端需要的功能。

[查看模型与能力](https://router.one/zh/models)

### 确认请求完成与结算

先发送纯文本请求，在日志里核对结果、请求 ID 和结算状态，再开启流式输出或工具调用。

[了解如何读请求日志](https://router.one/zh/llm-observability)

## 这里该填哪个 API 地址？

OpenAI 兼容 SDK 与 Codex 使用 /v1 base URL；Claude Code 使用主机根地址；沉浸式翻译需要完整 /v1/chat/completions 地址。还需核对配置所用协议与模型支持范围。

| 客户端 / 配置字段 | 应填写的值 | 使用的 API |
| --- | --- | --- |
| [SDK 的 Chat Completions 配置](https://router.one/zh/integrations/openai-sdk) — `base_url / baseURL / apiBase` | `https://api.router.one/v1` | Chat Completions — `POST /v1/chat/completions` |
| [Codex CLI](https://router.one/zh/codex-china) — `base_url; wire_api = "responses"` | `https://api.router.one/v1` | Responses — `POST /v1/responses` |
| [Claude Code](https://router.one/zh/claude-code-china) — `ANTHROPIC_BASE_URL` | `https://api.router.one` | Anthropic Messages — `POST /v1/messages` |
| [沉浸式翻译](https://router.one/zh/integrations/immersive-translate) — `自定义 API 接口地址` | `https://api.router.one/v1/chat/completions` | Chat Completions — `POST /v1/chat/completions` |
| [GitHub Copilot（VS Code）](https://router.one/zh/integrations/github-copilot) — `chatLanguageModels.json → models[].url; apiType: "chat-completions"` | `https://api.router.one/v1/chat/completions` | Chat Completions — `POST /v1/chat/completions` |
| [OpenHands](https://router.one/zh/integrations/openhands) — `Base URL（Advanced）/ LLM_BASE_URL（GPT-5 系列 ID 走 /v1/responses，见指南）` | `https://api.router.one/v1` | Chat Completions — `POST /v1/chat/completions` |
| [NextChat](https://router.one/zh/integrations/nextchat) — `BASE_URL / 接口地址` | `https://api.router.one` | Chat Completions — `POST /v1/chat/completions` |
| [CrewAI](https://router.one/zh/integrations/crewai) — `base_url; custom_openai=True (or OPENAI_API_BASE)` | `https://api.router.one/v1` | Chat Completions — `POST /v1/chat/completions` |
| [Spring AI](https://router.one/zh/integrations/spring-ai) — `spring.ai.openai.base-url (2.0.x; 1.x uses the host root)` | `https://api.router.one/v1` | Chat Completions — `POST /v1/chat/completions` |
| [OpenAI Agents SDK](https://router.one/zh/integrations/openai-agents-sdk) — `AsyncOpenAI(base_url=…) + OpenAIChatCompletionsModel (string model names default to /v1/responses)` | `https://api.router.one/v1` | Chat Completions — `POST /v1/chat/completions` |
| [Claude Agent SDK](https://router.one/zh/integrations/claude-agent-sdk) — `ClaudeAgentOptions(env={ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN})` | `https://api.router.one` | Anthropic Messages — `POST /v1/messages` |
| [Haystack](https://router.one/zh/integrations/haystack) — `OpenAIChatGenerator(api_base_url=…)` | `https://api.router.one/v1` | Chat Completions — `POST /v1/chat/completions` |
| [AnythingLLM](https://router.one/zh/integrations/anythingllm) — `Settings → LLM → Base URL / GENERIC_OPEN_AI_BASE_PATH` | `https://api.router.one/v1` | Chat Completions — `POST /v1/chat/completions` |
| [FastGPT](https://router.one/zh/integrations/fastgpt) — `AI Proxy channel → Base url (Protocol Type: OpenAI)` | `https://api.router.one/v1` | Chat Completions — `POST /v1/chat/completions` |
| [Xcode](https://router.one/zh/integrations/xcode) — `Settings → Intelligence → Add a Chat Provider → Internet Hosted → URL（Xcode 自行拼接 /v1/models 与 /v1/chat/completions）` | `https://api.router.one` | Chat Completions — `POST /v1/chat/completions` |
| [Qwen Code](https://router.one/zh/integrations/qwen-code) — `OPENAI_BASE_URL (.qwen/.env) / modelProviders.openai[].baseUrl` | `https://api.router.one/v1` | Chat Completions — `POST /v1/chat/completions` |
| [Google ADK](https://router.one/zh/integrations/google-adk) — `LiteLlm(model="openai/<id>", api_base=…, api_key=…)` | `https://api.router.one/v1` | Chat Completions — `POST /v1/chat/completions` |
| [smolagents](https://router.one/zh/integrations/smolagents) — `OpenAIModel(model_id=…, api_base=…, api_key=…)` | `https://api.router.one/v1` | Chat Completions — `POST /v1/chat/completions` |
| [Goose](https://router.one/zh/integrations/goose) — `OPENAI_HOST（OPENAI_BASE_PATH 保持默认 v1/chat/completions；gpt-5、gpt-6 与 o 系列名称走 /v1/responses，见指南）` | `https://api.router.one` | Chat Completions — `POST /v1/chat/completions` |
| [Mastra](https://router.one/zh/integrations/mastra) — `Agent model: { id: "custom/<model-id>", url: …, apiKey: … }` | `https://api.router.one/v1` | Chat Completions — `POST /v1/chat/completions` |
| [DSPy](https://router.one/zh/integrations/dspy) — `dspy.LM("openai/<model-id>", api_base=…, api_key=…)` | `https://api.router.one/v1` | Chat Completions — `POST /v1/chat/completions` |
| [Microsoft Agent Framework](https://router.one/zh/integrations/microsoft-agent-framework) — `OpenAIChatCompletionClient(model=…, api_key=…, base_url=…) / .NET OpenAIClientOptions.Endpoint` | `https://api.router.one/v1` | Chat Completions — `POST /v1/chat/completions` |
| [Flowise](https://router.one/zh/integrations/flowise) — `OpenAI Custom Model node → Additional Parameters → Base Path` | `https://api.router.one/v1` | Chat Completions — `POST /v1/chat/completions` |
| [Langflow](https://router.one/zh/integrations/langflow) — `Settings → Model Providers → OpenAI Compatible → Base URL (OPENAI_COMPATIBLE_BASE_URL)` | `https://api.router.one/v1` | Chat Completions — `POST /v1/chat/completions` |
| [RAGFlow](https://router.one/zh/integrations/ragflow) — `Model providers → OpenAI-API-Compatible → Base URL` | `https://api.router.one/v1` | Chat Completions — `POST /v1/chat/completions` |
| [Agno](https://router.one/zh/integrations/agno) — `OpenAILike(id=…, base_url=…, api_key=…)` | `https://api.router.one/v1` | Chat Completions — `POST /v1/chat/completions` |
| [MaxKB](https://router.one/zh/integrations/maxkb) — `OpenAI provider → API URL` | `https://api.router.one/v1` | Chat Completions — `POST /v1/chat/completions` |
| [Pi Agent](https://router.one/zh/integrations/pi) — `models.json → providers.router-one.baseUrl (api: openai-completions)` | `https://api.router.one/v1` | Chat Completions — `POST /v1/chat/completions` |

下表对应各链接指南中的配置。客户端可能还支持其他 provider 或 API，修改地址前先核对实际请求路径。

## 接入时的常见问题

### Router One 的 base URL 到底该填哪个？

按这些指南配置 OpenAI 兼容 SDK 时，填写 https://api.router.one/v1。Claude Code 与 Claude Agent SDK 使用主机根地址 https://api.router.one。需要完整 Chat Completions 端点的客户端应填写 https://api.router.one/v1/chat/completions。部分客户端会自行拼接 /v1，应以对应指南中的实际字段为准，避免重复添加。

### 列在这里的工具，能使用全部模型和功能吗？

每份指南对应一种具体的 provider 配置。API 协议、模型和客户端都要支持所需功能。请在模型详情页核对精确 ID、端点、上下文限制，以及工具调用或图片支持。纯文本请求成功，不代表已经验证流式输出、工具调用或图片输入。

### Router One 会运行 agent 或建立知识库索引吗？

agent 循环、工具执行和文档管理由客户端或框架完成，Router One 处理其中受支持的模型调用。知识库所需的 embeddings、rerank 和向量存储需要单独配置；接通聊天模型不等于接通这些服务。

### 如何确认接入成功？

先发送简单请求并检查最终结果，再到控制台的请求日志，按模型、时间和请求 ID 核对 token、延迟、状态与结算。HTTP 200 不足以证明流式输出完整结束，待结算也不表示免费。客户日志界面不展示供应商尝试记录或内部 fallback 链。

## 没找到正在使用的工具？

先确认它是否支持自定义 provider 地址和 API Key，再将请求协议与模型支持范围对应起来。API 文档列出了可用端点。

## 继续了解

- [API 文档](https://router.one/zh/docs)
- [OpenAI 兼容范围](https://router.one/zh/openai-compatible-api)
- [错误码速查](https://router.one/zh/llm-api-error-codes)
- [AI 编程工具概览](https://router.one/zh/use-cases/ai-coding-tools)