🎬 HoRain 云小助手：个人主页

⛺️生活的理想，就是为了理想的生活!

---

⛳️ 推荐

前些天发现了一个超棒的服务器购买网站，性价比超高，大内存超划算！忍不住分享一下给大家。点击跳转到网站。

目录

⛳️ 推荐

📦 安装

🔑 认证（二选一）

⚙️ config.toml 核心字段

🌏 国内场景：走中转 / 代理

✅ 验证

---

Codex CLI 是 OpenAI 出的终端 AI 编程 agent，配置这块比 Claude Code 简单点，一个 config.toml打天下。国内用户最大的坑是网络 + base_url + key 放哪儿，下面按"装 → 登 → 配 → 国内中转"四步拆。

📦 安装

前置：Node.js ≥ 18（LTS 20 最佳）

# npm（跨平台通用）
npm install -g @openai/codex

# macOS 也可 brew
brew install --cask codex

⚠️ 包名是 @openai/codex，裸装 codex会装到 2012 年一个无关旧包

验证：codex --version，能看到 codex 0.13x.x这种就算成功。

🔑 认证（二选一）

方式 A：ChatGPT 账号 OAuth（推荐个人）

codex

首次运行会交互提示 Sign in with ChatGPT，浏览器跳过去授权就行。Plus/Pro/Team/Edu 都能用，有周额度 。

方式 B：API Key（CI / 自动化场景）

# macOS/Linux
export OPENAI_API_KEY="sk-xxxxxxxx"
# Windows PowerShell
$env:OPENAI_API_KEY="sk-xxxxxxxx"

也可以写进 ~/.codex/auth.json（不用 export 了）：

{ "OPENAI_API_KEY": "sk-xxxxxxxx" }

查状态：codex login status

⚙️ config.toml 核心字段

位置：~/.codex/config.toml（Win 是 %USERPROFILE%\.codex\config.toml）

最小可用：

model = "gpt-5.3-codex"
model_reasoning_effort = "high"

approval_policy = "on-request"      # 非破坏性命令自动，不确定时问你
sandbox_mode = "workspace-write"   # 允许改当前项目文件
web_search = "cached"

三个新手必调字段的含义 ：

字段	可选值	说人话
approval_policy	on-request/ never/ untrusted/ reject	on-request是默认，改代码前问你；CI 用 never
sandbox_mode	read-only/ workspace-write/ danger-full-access	新手 workspace-write够用，只读怕 agent 改不动文件
web_search	disabled/ cached/ live	国内建议 cached或直接 disabled，Bing 不稳定

优先级：CLI 参数（--model xxx/ -c key=val）> 项目级 .codex/config.toml> ~/.codex/config.toml> 默认值

🌏 国内场景：走中转 / 代理

国内直连 api.openai.com基本不行，两种改法：

方案 A：最简，只改 base_url（适合单中转）

model = "gpt-5.4"
model_provider = "openai"
openai_base_url = "https://your-proxy.example.com/v1"

然后 export OPENAI_API_KEY=你的中转key，config.toml 优先级高于环境变量，两者共存时以 toml 为准 。

方案 B：自定义 provider（多套切换推荐）

model = "gpt-5.4"
model_provider = "myproxy"

[model_providers.myproxy]
name = "My Proxy"
base_url = "https://your-proxy.example.com/v1"
wire_api = "responses"
env_key = "MY_PROXY_API_KEY"

export MY_PROXY_API_KEY="sk-xxxx"

💡 model_provider的值和 [model_providers.xxx]的 key 必须一字不差（含大小写），否则 Codex 识别不到直接回落官方地址

如果终端本身要挂代理（比如中转也要过本地梯子）：

export HTTPS_PROXY="http://127.0.0.1:7890"
export HTTP_PROXY="http://127.0.0.1:7890"

注意 Codex 不吃 socks5，要转成 http。

✅ 验证

v0.131.0+ 有个诊断命令很好用 ：

codex doctor

会查 Node 版本、key 是否存在、网络能不能通 openai_base_url、toml 格式合不合法，全绿就能跑。

---

装好配好后直接 codex进 TUI，或者 codex exec " refactoring auth module"单次执行。项目根放个 AGENTS.md当项目级指令（类似 Claude Code 的 CLAUDE.md），Codex 会自动读 。

要不要再拆一块？比如 approval_policy+ sandbox_mode在不同场景怎么配（日常开发 / CI / 一次性重构），或者 codex-proxy把 DeepSeek/Claude 接到 Codex CLI 的玩法。

❤️❤️❤️本人水平有限，如有纰漏，欢迎各位大佬评论批评指正！😄😄😄

💘💘💘如果觉得这篇文对你有帮助的话，也请给个点赞、收藏下吧，非常感谢!👍 👍 👍

🔥🔥🔥Stay Hungry Stay Foolish 道阻且长,行则将至,让我们一起加油吧！🌙🌙🌙