跳转到主要内容
任何允许你设置自定义 API base URL 的工具都能调用 OrcaRouter。 本节为常见的成品工具提供可复制粘贴的配置方法——CLI 编码 agent、通用 agent 和桌面客户端。如果你想用 SDK(LangChain、Vercel AI SDK……) 把 OrcaRouter 接入你自己的代码,请改看 框架与集成

适用于每个工具的两条规则

1. 模型名称使用 vendor/model 格式——例如 anthropic/claude-opus-4.8google/gemini-2.5-flash。最简单的选择是 orcarouter/auto,它会让 OrcaRouter 为你挑选一个在线模型。用下面的命令列出所有可用项:
curl https://api.orcarouter.ai/v1/models -H "Authorization: Bearer sk-orca-..."
2. base URL 是否保留 /v1 取决于协议:
  • OpenAI 兼容工具 → https://api.orcarouter.ai/v1(带 /v1)。
  • Anthropic 协议工具(Claude Code、Copilot CLI)→ https://api.orcarouter.ai (不带 /v1——工具会自己追加 /v1/messages)。
每个工具的页面会告诉你它需要哪一种。
在 OrcaRouter 控制台的 API Keys 页面创建一个 API 密钥;密钥 以 sk-orca- 开头。

CLI / 编码 agent

Claude Code

Anthropic 的终端编码 agent。Anthropic 协议(base URL 不带 /v1)。

Codex CLI

OpenAI 的终端编码 agent。使用 OpenAI Responses API。

GitHub Copilot CLI

GitHub 的终端助手,通过 BYOK 接入。Anthropic 协议。

Crush

Charm 的开源编码 agent。OpenAI 兼容。

OpenCode

开源终端 agent。OpenAI 兼容(注意:推理模型有注意事项)。

Factory Droid CLI

Factory 的终端软件工程师。OpenAI 兼容。

oh-my-pi / pi-mono

极简、可扩展的终端 agent(omp)。OpenAI 兼容。

Kilo Code

Kilo Code 的 CLI(@kilocode/cli)。OpenAI 兼容。

通用 agent

nanobot

轻量级 AI agent。通过 custom provider 实现 OpenAI 兼容。

OpenClaw

自托管的个人 AI 助手。OpenAI 兼容。

Hermes Agent

Nous Research 的终端 agent。OpenAI 兼容(Linux / macOS / WSL2)。

桌面客户端(GUI)

Cherry Studio

免费桌面 AI 客户端。用裸 base URL 添加一个 OpenAI provider。

AionUi

免费开源桌面 agent。使用 /v1 base URL。

CC Switch

配置切换器——为 Claude Code / Codex / Gemini 写入 OrcaRouter 配置。