​
codex / 使用

​
获取中转站 API Key

Wanlai Codex 的中转站 API Key 需要在软件端获取，不是在文档页或下载页申请。请按下面步骤操作：
  1. 打开 Wanlai Codex，点击窗口右上角的用户图标，进入 个人中心。
  2. 使用万来账号完成网页登录授权。生成或轮换 Key 需要 OAuth 授权，API Key 登录只能查看和复制当前 Key。
  3. 打开 Api密钥 页面。账号需要有可用的软件套餐，才能读取软件权益并生成 Key。
  4. 如果显示 暂无 Key，点击 生成密钥；如果已经有 Key，点击 复制 Key。
  5. 将复制的内容作为中转站的 OPENAI_API_KEY 使用。Key 属于软件专用凭据，不要提交到代码仓库或公开聊天中。

​
推荐导入方式

在 个人中心 > Api密钥 页面，找到 导入到 Codex，点击 导入。软件会把当前软件 Key 写入本机 Codex 配置，并设置万来中转站地址；如果按钮显示 已存在，说明已经完成导入。 需要恢复官方 Codex 配置时，在同一页面点击 恢复官方。如果轮换了 Key，软件会在已安装 Codex 集成的情况下同步更新本机配置。

​
手动接入其他客户端

如果使用 OpenAI 兼容客户端，在 个人中心 > Api密钥 > 使用密钥 > 查看 中复制环境变量。万来中转站的兼容地址是： 
export OPENAI_API_KEY="软件端复制的中转站 API Key"
export OPENAI_BASE_URL="https://api.wanlai.ai/v1"
Windows PowerShell： 
$env:OPENAI_API_KEY = "软件端复制的中转站 API Key"
$env:OPENAI_BASE_URL = "https://api.wanlai.ai/v1"
如果客户端要求填写完整接口地址，使用 https://api.wanlai.ai/v1；不要再额外拼接一个 /v1。请求会使用 Authorization: Bearer <OPENAI_API_KEY>。
如果你使用软件端的 导入到 Codex 或复制 Codex config.toml，请以软件生成的内容为准，不要再套用下面的手写示例。软件生成配置会使用它返回的 https://api.wanlai.ai/v1 和 wanlai-codex-token 认证命令；手写配置与软件配置不要混用。

​
日常启动

建议进入你的项目目录后再启动： 
codex
这样它会直接读取当前代码库上下文。

​
常用理解方式

  • config.toml 负责模型、路由和请求方式
  • auth.json 只负责放从软件端复制的中转站 OPENAI_API_KEY
  • 想切模型时，优先修改 model 和 review_model

​
最常见的两个检查点

如果请求没有走到万来接口，优先检查： 
base_url = "https://api.wanlai.ai"
wire_api = "responses"

​
常见问题

​
手写配置的 base_url 要不要写成 /v1？

如果你按本文手写 [model_providers.OpenAI] 配置，这里填写服务根地址： 
https://api.wanlai.ai
真正的请求路径会由 wire_api = "responses" 自动补成： 
https://api.wanlai.ai/v1/responses
如果配置是软件端复制或导入的，请保留软件生成的 base_url，不要按本节手写规则改动。

​
密钥应该放在哪里？

放在： 
~/.codex/auth.json
或者 Windows 的： 
%userprofile%\.codex\auth.json
字段名固定是： 
{
  "OPENAI_API_KEY": "从 Wanlai Codex 个人中心 > Api密钥复制的 Key"
}
如果使用软件端的 导入到 Codex，不需要手动编辑这些文件；软件会同时写入认证信息和对应的万来 provider 配置。

​
图形化配置

如果你更习惯图形化方式，也可以通过 CCSwitch 来维护 Codex 配置，但最终仍然要保证：
  • base_url = "https://api.wanlai.ai"
  • 请求走 responses

​
兼容旧页面

如果你需要看旧的整页说明和截图，也可以继续查看： Codex 安装与使用