返回博客

让 Codex 和 Claude Code 走本地可验证入口

保留熟悉的编码工具,把 API 接入、身份核验和内容加密交给本地客户端。

对日常编码来说,工具的交互方式不必因为使用 PrimeRouter 而改变。需要改变的是请求离开电脑之前的那一段链路:工具连接本地开源客户端,由客户端完成远端身份核验和内容加密。

不替换工具,调整入口

本地客户端提供兼容 OpenAI 和 Claude API 的入口。能够配置自定义 API 地址的工具,可以继续使用自己熟悉的工作流:

Codex / Claude Code
        -> 本地 PrimeRouter 客户端
        -> 已验证的加密会话
        -> 可信执行环境中的 PrimeRouter 程序
        -> 选定的上游模型

兼容入口并不意味着所有工具使用同一个地址或同一种请求格式。应按工具支持的协议,在客户端界面复制相应的本地地址;端口和模型名称以你当前客户端与账号显示的信息为准。

一个稳妥的接入顺序

  1. 登录 PrimeRouter,获取并启动配套的开源客户端。
  2. 在客户端创建供本机工具使用的 API Key。
  3. 在工具中配置客户端显示的兼容 API 地址和这把本地密钥。
  4. 选择账号与密钥策略允许的模型,发起一个最小请求。
  5. 确认客户端的远程验证成功,且工具收到了模型响应。

不要把平台密钥或上游账号凭证直接写进第三方工具的项目配置。工具应连接本地入口,并使用客户端签发的本地密钥。

遇到失败,先分清是哪一层

检查位置先看什么
工具配置API 地址是否指向本机客户端,所选协议是否匹配。
本地客户端客户端是否运行、验证是否通过、本地密钥是否可用。
模型策略当前账号和密钥是否允许所选模型与渠道。
上游调用若前三项正常,再查看客户端展示的上游错误。

这四层分开看,比反复更换模型名或复制别人的端口更容易定位问题。具体操作步骤见连接你的工具。