Codex Cli 配置教程

Codex 使用 Yuan API 的 OpenAI 兼容接口：

https://api.apixhm.com/v1

一、打开配置目录

Codex 的配置文件通常位于用户目录下的 .codex 目录中。请根据你的系统打开：

Windows

%userprofile%\.codex

macOS / Linux

~/.codex

如果目录或配置文件不存在，先运行一次 codex，再退出并检查目录是否已经生成。

二、编辑 config.toml

在 .codex 目录下创建或打开 config.toml，根据当前 Codex 版本支持的字段填写 Yuan API 地址和模型。通用示例：

model = "your-model-id"
model_provider = "yuan-api"

[model_providers.yuan-api]
name = "Yuan API"
base_url = "https://api.apixhm.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

模型 ID 请从 Yuan API 模型与价格页面复制，例如 claude-sonnet-4-5。如果当前 Codex 版本的配置字段名称不同，请以 codex --help 或配置提示为准，只替换供应商名、Base URL、变量名和模型。

三、编辑 auth.json

如果当前 Codex 版本使用 auth.json 保存 API Key，请在 .codex/auth.json 中按客户端要求写入凭证。不要把真实 Key 提交到 Git：

{
  "OPENAI_API_KEY": "你的 API Key"
}

也可以在启动 Codex 前设置环境变量：

export OPENAI_API_KEY="你的 API Key"
export OPENAI_BASE_URL="https://api.apixhm.com/v1"

启动：

codex

注意

如果最终请求地址出现 /v1/v1，说明 Base URL 被重复拼接。遇到 401、404 或模型错误，请查看 Codex CLI 专项问题。