接入 AI 编程工具

把 PrimeRouter 当成"自家的 OpenAI / Anthropic API"接进任何 AI 编程工具。本节为每个工具提供独立配置页（含 macOS / Linux / Windows 命令）。

工具一览

工具	形态	协议	文档
Claude Code	CLI	Anthropic Messages	配置 →
OpenClaw	CLI / Gateway / Agent	Anthropic Compatible	配置 →
OpenCode	CLI / TUI	OpenAI Compatible	配置 →
Cursor	IDE	OpenAI Compatible	配置 →
Cline	VS Code / Cursor 扩展	OpenAI Compatible	配置 →
Crush	CLI / TUI	OpenAI Compatible	配置 →
Codex 配置教程	Windows / macOS	OpenAI Responses / Chat	配置 →
Codex CLI	CLI	OpenAI Responses / Chat	配置 →
Vibecode	Web / Desktop	OpenAI Compatible	配置 →

协议兼容性

PrimeRouter 同时暴露两套协议：

协议	Endpoint
OpenAI Compatible	`https://primerouter.ai/v1`
Anthropic Messages	`https://primerouter.ai`（工具自动追加 `/v1/messages`）

绝大多数工具走 OpenAI 协议；Claude Code 走 Anthropic 协议。

通用准备（一次性）

1. 注册 + 拿到 API Key

打开 primerouter.ai → 注册账号
控制台 → 令牌 → 添加令牌 → 分组选 default 或你已订阅的分组 → 保存
复制 sk-xxx（本节统一记作 sk-你的primerouter-key）

2. 三个核心参数

参数	值
Base URL	`https://primerouter.ai/v1`
API Key	上一步的 `sk-xxx`
Model ID	如 `claude-sonnet-4-6`、`claude-opus-4-7`

3. 推荐的 Claude 模型 ID

Model ID	适合
`claude-sonnet-4-6`	日常代码助手，默认推荐
`claude-opus-4-6`	复杂任务的稳定档 Opus
`claude-opus-4-7`	最新 Opus，最强推理 / 长上下文重构

完整模型列表见可用模型。

自检：连通性测试

任何工具配好后，先用一条 curl 验证你的 Key 和 Base URL：

macOS / LinuxWindows PowerShell

bash

curl https://primerouter.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-你的primerouter-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role":"user","content":"ping"}],
    "max_tokens": 10
  }'

powershell

curl.exe https://primerouter.ai/v1/chat/completions `
  -H "Authorization: Bearer sk-你的primerouter-key" `
  -H "Content-Type: application/json" `
  -d '{\"model\":\"claude-sonnet-4-6\",\"messages\":[{\"role\":\"user\",\"content\":\"ping\"}],\"max_tokens\":10}'

期望响应包含 choices[0].message.content。如果返回 4xx，先看这几点：

错误	原因	处理
`401 invalid_api_key`	Key 拼错或令牌被禁用	控制台 → 令牌 → 检查状态
`403 no_permission`	令牌分组和渠道分组不匹配	编辑令牌，加入对应分组
`404 model_not_found`	model id 拼错或该分组未启用该模型	可用模型查正确 ID
`429 too_many_requests`	超出当前分组速率限制	升级订阅或换 group
`500/502`	上游临时不可用	检查 primerouter.ai 状态

流式 vs 非流式

所有上述工具默认都用流式（SSE）。如果某个工具加载慢或挂死：

先在工具设置里关闭 streaming 排除流式分发的问题
再回到 PrimeRouter 控制台 → 日志，看请求是否真的到了 prime-router
如果没到，是工具到 PrimeRouter 之间的网络问题；如果到了但响应慢，可能是上游 cooldown，换个 model 试试

费用与计费

PrimeRouter 按实际 token 用量计费，每次调用扣费在控制台 → 日志可见
使用 Claude 系列时，Prompt Cache 自动生效（同 prompt 第二次调用自动 90% 折扣，cache_ratio=0.1）— 对 IDE/Agent 类工具特别友好
长 context 工具（Cline / Codex / Claude Code）建议用 Sonnet 4.5 作为默认，省钱又稳

详细计费规则见计费规则。

接入 AI 编程工具 ​

工具一览 ​

通用准备（一次性） ​

1. 注册 + 拿到 API Key ​

2. 三个核心参数 ​

3. 推荐的 Claude 模型 ID ​

自检：连通性测试 ​

流式 vs 非流式 ​

费用与计费 ​