win Codex配置三方api保姆级教程-春枫博客

1. 什么是 Codex & Base URL 三方 API

Codex CLI 是 OpenAI 官方的本地 AI 编码工具，它默认使用 OpenAI 的 API 服务。但在国内/特殊业务场景下，你可能需要使用第三方 API 代理/Base URL 对接你自己的服务或中转服务。

2. 环境准备

2.1 必备软件

软件	说明
Node.js ≥ 18	必需，用于安装 Codex CLI
npm	Node 自带
终端 / PowerShell	用于执行命令

3. 安装 Codex CLI

打开终端安装codex

npm install -g @openai/codex
# 检查安装是否成功
codex --version

如果显示版本号，说明安装成功。

4. 创建 Codex 配置文件

Codex 默认从用户目录下的 .codex 文件夹读取配置：

文件	作用
`auth.json`	放 API 密钥
`config.toml`	放模型与提供商配置

Windows 上路径为：

C:\Users\<你的用户名>\.codex

这是隐藏文件夹，需要开启“显示隐藏项目”。

5. 写入 API Key 和配置

没有两个配置文件要创建（如果有就打开覆盖文件）然后记事本打开

5.1 auth.json

在 .codex 下创建 auth.json，内容如下：

{  "OPENAI_API_KEY": "sk-你的第三方API密钥"}

注意不要写错空格或引号，否则会导致 401 错误。

5.2 config.toml 示例（接入第三方 Base URL）

model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "你自己的api地址"
wire_api = "responses"
requires_openai_auth = true