把 Reconnecting 变成 ● connected
从安装、登录到配置 config.toml，再到国内使用最头疼的「一直重连」——这里把 Codex CLI 新手会踩的坑，一个个讲清楚、给出可复制的命令。
按问题找答案
从安装、配置、AGENTS.md、CI/CD 集成到进阶技巧——每篇都从「为什么会这样」讲到「怎么一步步解决」，覆盖 Codex CLI 全使用周期。
安装 Codex CLI
npm / 官方脚本 / Homebrew 三种安装方式，Node 版本要求与最常见的装错包问题。
阅读教程 →Windows 安装指南
WSL2（推荐）、PowerShell、Git Bash 三种方式，WSL2 代理穿透、脚本执行权限与 EPERM 报错。
Windows 专项 →更新到最新版
一行命令升级 Codex CLI，查看版本号、锁定 CI 版本、2026 配置迁移注意事项。
▸02 · USAGE登录与上手
ChatGPT 登录 vs API Key、第一条指令、审批与沙箱模式、AGENTS.md 项目记忆。
阅读教程 →API Key 配置指南
在哪里获取 Key、codex login 与环境变量两种方式、多账号 direnv 管理、Key 泄露紧急处理。
配置认证 → ⚙03 · CONFIG配置 config.toml
模型、提供商、第三方 API 接入、上下文窗口等核心配置项详解与完整示例。
阅读教程 →沙箱与审批模式
suggest、auto-edit、full-auto 三种模式的区别和适用场景，CI/CD 安全配置指南。
↻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 跑分与适用场景：到底该用哪个、怎么搭配。
查看对比 →对比 GitHub Copilot
功能差异、价格对比、自主任务 vs 行内补全：两款工具各自适合哪类开发者。
查看对比 →Codex 是什么
核心功能、与 ChatGPT 的区别、典型使用场景一览。
深度评测（2026）
真实使用体验、优缺点、性能基准与竞品对比——帮你判断是否值得用。评分 4.1 / 5。
价格与收费
免费额度、API 计费详情、省钱技巧全解析。
模型选择指南
o4-mini vs GPT-4.1 vs o3 全面对比——按任务类型选对模型，成本降低 80%。
Codex vs Cursor
两款 AI 编程工具深度对比，选最适合你的那个。
Codex vs Aider
开源 vs 官方，模型灵活性与 Git 自动提交行为深度对比。
AGENTS.md 指南
用 AGENTS.md 让 Codex 记住你的项目规范。/init 生成草稿、推荐结构、Monorepo 嵌套用法。
CI/CD 集成
用 codex exec 驱动 GitHub Actions：自动生成 Changelog、AI 代码审查、单元测试补全。
codex exec 完整指南
非交互模式详解：语法、退出码、批准模式、GitHub Actions / GitLab CI 完整示例。
实用技巧与进阶用法
高效 Prompt 写法、模型选择策略、上下文管理、日常工作流与常见坑规避。
接入 Ollama 本地模型
配置 Codex CLI 使用 Qwen2.5-Coder、DeepSeek-Coder 等本地模型，离线开发、零成本、数据不出本地。
50+ 实用提示词示例
代码重构、测试生成、Bug 修复、文档编写、CI/CD 自动化……经过验证的提示词模板，复制即用。
Git 工作流自动化
自动生成规范 Commit Message、起草 PR 描述、AI 代码审查，打造端到端的智能 Git 流程。
Python 开发指南
为 Python 项目配置 AGENTS.md，自动生成 pytest 测试、修复 mypy 错误，Django/FastAPI 场景全覆盖。
JavaScript/TypeScript 指南
React 组件生成、TypeScript 类型修复、Vitest 测试自动化、Next.js App Router、Node.js/Bun 后端全覆盖。
多文件与大型代码库
上下文窗口管理、.codexignore 配置、Monorepo 支持（Turborepo/Nx）、增量重构策略与实战案例。
安全性与隐私指南
代码是否上传到 OpenAI？沙箱机制解析、API Key 安全管理、企业隐私配置、Ollama 本地化方案。
调试指南
--verbose 模式、CODEX_LOG_LEVEL 日志级别、--dry-run 预演，以及 5 种常见失败模式逐步排查。
代码重构指南
安全重构五步工作流、函数提取/重命名/文件拆分、TypeScript 迁移、测试驱动重构，附提示词模板。
Go 开发指南
Go 项目 AGENTS.md 配置、表格驱动测试生成、go vet 错误修复、接口重构、并发模式与 GitHub Actions CI。
⚡TOOL · 在线工具网络封号风险检测
一键评估当前 IP 风险等级、WebRTC 泄露、OpenAI 节点可达性，每项给出可复制修复命令。
立即检测 →直接搜你的报错
把终端里的英文报错粘到搜索引擎 + "codex"，再回来对照「报错排查」表。
⚡ 使用前先检测网络封号风险
很多 Codex 问题根源是网络环境不对。出口 IP 在大陆、数据中心或共享 VPN，都可能导致账号被限制。这个工具帮你 30 秒摸清现状：
- IP 风险评分：住宅 / 数据中心 / 大陆直连，三档评级
- WebRTC 真实 IP 泄露：代理挂了也可能被识别
- OpenAI API 节点可达性：直接测试连通性与延迟
- 针对性修复命令：每项问题给出可复制的 shell 命令
为什么 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 在高质量、上下文敏感、安全相关任务上口碑更好。很多团队两个都用。详见 对比。