快速入门

本指南将在一分钟内让 BitRouter 为你的 Agent 提供路由。BitRouter 有两种部署模式，每种模式都有两种接入方式：

• BitRouter Cloud（默认）。 托管端点 cloud.bitrouter.ai。无需管理密钥；支持 Agent 原生 x402/MPP 按请求付费，也可叠加 BYOK 使用。
• 本地代理。 单一二进制运行于本机，BYOK 使用你自己的提供商密钥。零基础设施依赖。

两种模式都可通过 Agent Skills（让你的 Agent 自行安装与配置）或 BitRouter CLI / TUI（交互式向导）完成接入。两者均默认使用 Cloud；按一个键即可切换为本地模式。

Agent Skills

适用于支持 skills 的 Agent 运行时（Claude Code、Cursor、Codex、Copilot 等）。一次安装：

npx skills add BitRouterAI/agent-skills

然后告诉你的 Agent："帮我设置好 BitRouter。"——Agent 会运行向导、默认选择 Cloud，并自动完成连接验证。

BitRouter CLI

适用于命令行优先的接入。安装二进制：

curl -fsSL https://install.bitrouter.ai | sh

npm install -g bitrouter

brew install bitrouter/tap/bitrouter

cargo install bitrouter

启动 TUI 向导：

bitrouter

向导会询问 Cloud 还是本地？（默认 Cloud），如果选择本地则提示输入密钥，随后在 http://localhost:8787 启动代理。

发送请求验证：

curl http://localhost:8787/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

将任意 OpenAI 兼容的运行时指向 http://localhost:8787/v1 即可通过 BitRouter 路由。

下一步

具体 Agent 运行时（Claude Code、OpenClaw、Codex CLI、OpenCode、Kilo Code 等）的接入方法详见 Cookbook。