PrimeRouter
文档中心
阅读博客
文档中心使用者指南

接入 Codex：桌面导入与手动配置

让 Codex 使用本地 Responses 入口，并避免覆盖用于供号的官方登录环境。

接入前先确认

User Client 正在运行，本地 Key 可用，这把 Key 的目录包含你要用的模型。Codex 工具本身已经安装并能启动。

如果你同时通过 Partner Client 售卖本机官方 Codex 账号，消费端网关配置与供号用的官方登录要分开。Partner 会检查是不是官方提供商；把同一份官方配置改成 PrimeRouter 提供商，可能使它不再作为官方登录来源同步。

推荐：从桌面 Client 导入

  1. 在“本地 Key”找到给 Codex 的 Key。
  2. 打开“导入本机 Agent”，选择 Codex。
  3. 检查目标配置文件、当前模型、Local Base URL 和将修改的字段。
  4. 确认后应用。Client 会保存原配置的备份。
  5. 重新启动 Codex，或创建新会话，让新配置生效。
  6. 用一句短问题，再用一个临时项目的小编码任务确认。

本地 Key 的配置与导入入口

浏览器页面不具备所有桌面文件权限；看不到导入入口时可以用下面的手动方法。导入文件前不要同时在另一个程序里改相同文件。

手动配置的结构

Codex 通常从其配置目录读取 config.toml。默认目录是 ~/.codex，也可能由 CODEX_HOME 指定。先备份原文件，只合并需要的字段，不要删除已有的权限、工具和项目设置。

下面的字段结构对应 PrimeRouter 的 Codex 连接方式。模型和 Key 是占位符，地址要换成自己的本地入口：

model_provider = "primerouter"
model = "YOUR_AVAILABLE_MODEL"

[model_providers.primerouter]
name = "PrimeRouter"
base_url = "http://127.0.0.1:18000/v1"
wire_api = "responses"
experimental_bearer_token = "YOUR_LOCAL_KEY"
requires_openai_auth = false

这份文件含密钥，不能提交到仓库。不同 Codex 版本可能调整配置字段；优先使用当前 Client 的“查看配置”输出。不要把 Chat Completions 端点填成 Codex 的 Responses Base URL。

双角色建议使用独立目录

希望保留官方登录供号时，可以让消费端 Codex 使用独立配置目录。例如在 Bash 中设置 CODEX_HOME="$HOME/.codex-primerouter"，再为该目录建立消费端配置。这个设置只影响相应启动环境，已经运行的官方 CLI 不会自动切换。

Windows 使用该终端对应的环境变量语法和真实用户目录。Partner 的检测目录也要保持与你想同步的官方 CLI 一致。

确认与回退

查看使用记录里的 Agent 来源、模型和渠道；测试工具是否能读写临时项目。需要恢复时，使用桌面配置恢复能力，或恢复你自己保存的原文件；再重启工具。

上下文太长时检查渠道输入上限和压缩过程；出现路径或 Shell 问题时见协议与 Agent 环境。