把 Reconnecting 变成 ● connected
从安装、登录到配置 config.toml，再到国内使用最头疼的「一直重连」——这里把 Codex CLI 新手会踩的坑，一个个讲清楚、给出可复制的命令。
按问题找答案
新手最常搜索的 8 个主题，每一篇都从「为什么会这样」讲到「怎么一步步解决」。
安装 Codex CLI
npm / 官方脚本 / Homebrew 三种安装方式，Node 版本要求与最常见的装错包问题。
阅读教程 → ▸02 · USAGE登录与上手
ChatGPT 登录 vs API Key、第一条指令、审批与沙箱模式、AGENTS.md 项目记忆。
阅读教程 → ⚙03 · CONFIG配置 config.toml
模型、提供商、第三方 API 接入、上下文窗口等核心配置项详解与完整示例。
阅读教程 → ↻04 · 高频问题一直 Reconnecting
逐条排查重连循环：代理、socks5、认证冲突、VS Code 插件、WSL2 与版本 Bug。
立即排查 → ⚑05 · 国内使用国内代理配置
为什么国内必须配代理、终端与 VS Code 各自怎么设、镜像加速 npm 安装。
查看方案 → ⚠06 · 报错排查常见报错速查
401 认证失败、429 限流、port 1455 占用、headless 登录失败等错误对照表。
对照排查 → ⌘07 · COMMANDS命令与斜杠指令
codex / exec 命令行参数，/model、/approvals、/init 等斜杠命令与权限模式。
阅读教程 → ⚖08 · COMPARE对比 Claude Code
2026 价格、上下文、SWE-bench 跑分与适用场景：到底该用哪个、怎么搭配。
查看对比 →Codex 是什么
核心功能、与 ChatGPT 的区别、典型使用场景一览。
价格与收费
免费额度、API 计费详情、省钱技巧全解析。
Codex vs Cursor
两款 AI 编程工具深度对比，选最适合你的那个。
直接搜你的报错
把终端里的英文报错粘到搜索引擎 + "codex"，再回来对照「报错排查」表。
为什么 Codex 一直 Reconnecting？
八成不是 Codex 坏了，而是网络连不上 OpenAI。重连失败通常来自这几类原因，按优先级逐一排除即可：
- 代理没配 / 配错：国内直连不通，需设置
HTTPS_PROXY。 - 用了 socks5 代理：Codex 不识别 socks5，要转成 http。
- OAuth 与 API Key 冲突：两种认证同时存在会不稳定。
- VS Code 插件 / WSL2 网络：插件单独的代理、WSL 不继承 Windows 代理。
- 版本 Bug：个别版本已知问题，升级到最新版。
# 1) 终端临时生效（最常用）
export HTTPS_PROXY="http://127.0.0.1:7890"
export HTTP_PROXY="http://127.0.0.1:7890"
export ALL_PROXY="http://127.0.0.1:7890"
# 2) 验证是否走代理
$ curl -I https://api.openai.com/v1
# 3) 重新连接
$ codex最短路径：装好 → 登录 → 跑起来
安装
$ npm i -g @openai/codex需要 Node ≥ 18。包名带 @openai/。
登录
$ codex
# 浏览器用 ChatGPT 登录或 codex login --with-api-key。
开跑
› 帮我修复登录页的报错直接用自然语言下指令。
新手最常问的几个问题
Codex CLI 怎么安装？
装好 Node.js 18+ 后运行 npm install -g @openai/codex；macOS/Linux 也可用 curl -fsSL https://chatgpt.com/codex/install.sh | sh。然后 codex --version 验证。务必是 @openai/codex——直接装 codex 会装到一个 2012 年的无关旧包。
为什么一直显示 Reconnecting？
大概率是网络/代理问题。国内无法直连 OpenAI，需要给 Codex 配置 HTTPS_PROXY 等环境变量指向本地代理，且不能用 socks5（要转 http）。详见 Reconnecting 排查清单。
使用 Codex 一定要花钱吗？
CLI 本身免费开源，但调用模型需要 ChatGPT 订阅（Plus 起）或 OpenAI API Key。用 ChatGPT 账号登录复用订阅额度；用 API Key 按 token 计费。
配置文件 config.toml 在哪？怎么改模型？
在 ~/.codex/config.toml（Windows 为 %USERPROFILE%\.codex\config.toml）。用 model = "gpt-5.3-codex" 设默认模型，或会话内用 /model 切换。详见 配置详解。
Codex 和 Claude Code 选哪个？
简单说：Codex 性价比高、跑分略领先、适合高频自动化；Claude Code 在高质量、上下文敏感、安全相关任务上口碑更好。很多团队两个都用。详见 对比。