对日常编码来说,工具的交互方式不必因为使用 PrimeRouter 而改变。需要改变的是请求离开电脑之前的那一段链路:工具连接本地开源客户端,由客户端完成远端身份核验和内容加密。
不替换工具,调整入口
本地客户端提供兼容 OpenAI 和 Claude API 的入口。能够配置自定义 API 地址的工具,可以继续使用自己熟悉的工作流:
Codex / Claude Code
-> 本地 PrimeRouter 客户端
-> 已验证的加密会话
-> 可信执行环境中的 PrimeRouter 程序
-> 选定的上游模型
兼容入口并不意味着所有工具使用同一个地址或同一种请求格式。应按工具支持的协议,在客户端界面复制相应的本地地址;端口和模型名称以你当前客户端与账号显示的信息为准。
一个稳妥的接入顺序
- 登录 PrimeRouter,获取并启动配套的开源客户端。
- 在客户端创建供本机工具使用的 API Key。
- 在工具中配置客户端显示的兼容 API 地址和这把本地密钥。
- 选择账号与密钥策略允许的模型,发起一个最小请求。
- 确认客户端的远程验证成功,且工具收到了模型响应。
不要把平台密钥或上游账号凭证直接写进第三方工具的项目配置。工具应连接本地入口,并使用客户端签发的本地密钥。
遇到失败,先分清是哪一层
| 检查位置 | 先看什么 |
|---|---|
| 工具配置 | API 地址是否指向本机客户端,所选协议是否匹配。 |
| 本地客户端 | 客户端是否运行、验证是否通过、本地密钥是否可用。 |
| 模型策略 | 当前账号和密钥是否允许所选模型与渠道。 |
| 上游调用 | 若前三项正常,再查看客户端展示的上游错误。 |
这四层分开看,比反复更换模型名或复制别人的端口更容易定位问题。具体操作步骤见连接你的工具。

