Codex 完全指南:安装配置 + Codex++ 进阶解锁

Codex 完全指南：安装配置 + Codex++ 进阶解锁

OpenAI 在 2025 年开源了一个让程序员直呼「职业危机」的东西：Codex CLI。它跑在你的终端里，能自己读代码、改代码、跑命令——你只需要告诉它要做什么。本文手把手带你从安装到玩转进阶，包括国内免翻墙用法，以及解锁原版限制的 Codex++ 工具。

一、Codex 是什么？

Codex CLI 是 OpenAI 于 2025 年发布的终端 AI 编程智能体，用 Rust 编写，Apache-2.0 开源（GitHub 83,000+ ⭐）。

它不是一个聊天框，是一个真正跑在你本地的「AI 程序员」：

📁 读取并修改代码文件：理解项目结构，跨文件重构
⚙️ 执行终端命令：跑测试、git 操作、构建脚本
🔁 多步骤自主完成任务：自动拆解任务逐步执行，不确定时暂停等你确认
🔌 接入任意兼容 OpenAI 协议的 API：国内 DeepSeek、Kimi、Claude 全部支持

用一句话描述：你说目标，它自己想方案、改代码、跑验证，出问题再来问你。

二、安装 Codex CLI

Windows

npm install -g @openai/codex

需要提前安装 Node.js 18+（推荐到 nodejs.org 下载）。

macOS

方式一：Homebrew（推荐）

brew install --cask codex

方式二：npm

npm install -g @openai/codex

方式三：直接下载二进制（网络受限时用）

# Apple Silicon (M 系列) curl -L https://github.com/openai/codex/releases/download/rust-v0.131.0/codex-aarch64-apple-darwin.tar.gz | tar -xz sudo mv codex /usr/local/bin/  # Intel Mac curl -L https://github.com/openai/codex/releases/download/rust-v0.131.0/codex-x86_64-apple-darwin.tar.gz | tar -xz sudo mv codex /usr/local/bin/

Linux

# 静态链接，不依赖系统 glibc，兼容性最强 curl -L https://github.com/openai/codex/releases/download/rust-v0.131.0/codex-x86_64-unknown-linux-musl.tar.gz | tar -xz sudo mv codex /usr/local/bin/

验证安装

codex --version # 输出：codex 0.131.0

三、国内配置：3 分钟跑通（无需翻墙）

Codex 默认调用 api.openai.com，国内无法直连。解法很简单——改一行配置文件，指向国内兼容端点。

第一步：创建配置文件

mkdir -p ~/.codex

创建 ~/.codex/config.toml，内容如下：

# 国内兼容端点（以 DeepSeek 官方为例） openai_base_url = "https://api.deepseek.com/v1"  # 选择模型 model = "deepseek-chat"  # 沙盒模式：只能修改当前项目目录，不乱动其他文件 sandbox_mode = "workspace-write"  # 遇到不确定操作暂停等你确认（安全） approval_policy = "on-request"  # 中文回复 developer_instructions = "始终用中文回复，代码注释保持英文"

第二步：设置 API Key

# zsh 用户 echo 'export OPENAI_API_KEY="你的API Key"' >> ~/.zshrc source ~/.zshrc  # bash 用户 echo 'export OPENAI_API_KEY="你的API Key"' >> ~/.bashrc source ~/.bashrc

国内推荐 API 端点：

服务商	Base URL	特点
DeepSeek 官方	`https://api.deepseek.com/v1`	代码能力强，价格低
七牛云 AI	`https://api.qnaigc.com/v1`	聚合多模型，一个 Key 用多个
Kimi	`https://api.moonshot.cn/v1`	长上下文，适合大代码库

第三步：验证配置

codex doctor

这个命令会自动检查运行环境、API Key、网络连通性、配置文件格式。全部绿色才开始用。

四、基本用法：你的第一个 Codex 任务

进入你的项目目录，启动 Codex：

cd ~/your-project codex

几个实用示例：

代码审查

> 检查这个项目里有没有明显的 Bug 或安全问题，列出 Top 5

添加功能

> 给 src/auth.py 的 login() 函数添加速率限制，每个 IP 每分钟最多 10 次请求

指定文件操作（用 @ 提及）

> 对比 @src/old_parser.py 和 @src/new_parser.py 的性能差异，给出优化建议

非交互式单次执行（适合脚本）

codex -q "为所有 Python 文件的公开函数添加类型注解" codex -z "列出这个项目的所有 TODO 注释" > todos.txt

会话内常用命令：

命令	作用
`/model`	查看 / 切换当前模型
`/clear`	清空当前上下文
`/status`	查看 token 使用量
`/help`	查看所有命令
`Ctrl+C`	退出

五、Codex++ 是什么？为什么要用它？

Codex CLI 是命令行工具，但 OpenAI 同时还有一个桌面客户端 Codex App。

Codex App 的问题：在 API Key 模式下（不登录 OpenAI 账号），插件市场无法使用、会话无法删除、很多功能直接锁死。

Codex++ 就是来解决这些痛点的。

Codex++
是一个开源增强启动器，通过 Chromium DevTools Protocol 向 Codex App 注入增强脚本。不修改原始安装文件，安全、干净、可随时移除。

六、安装 Codex++

前往 GitHub Releases 下载最新版安装包：

Windows
：CodexPlusPlus-*-windows-x64-setup.exe
macOS Apple Silicon
：CodexPlusPlus-*-macos-arm64.dmg
macOS Intel
：CodexPlusPlus-*-macos-x64.dmg

安装完成后，你会得到两个入口：

入口	作用
Codex++	静默启动，直接启动 Codex 并注入增强功能
Codex++ 管理工具	Tauri 控制面板，用于配置、诊断、更新

⚠️ macOS 提示「已损坏，无法打开」？ 执行以下命令解除隔离：
sudo xattr -rd com.apple.quarantine /Applications/Codex++.app sudo xattr -rd com.apple.quarantine "/Applications/Codex++ 管理工具.app" 

七、Codex++ 核心功能详解

① 中转注入：接入国内 API

这是 Codex++ 最核心的功能——让 Codex App 通过国内代理 API 运行，无需登录 OpenAI 账号。

配置步骤：

打开 Codex++ 管理工具
进入「中转注入」页面
点击「添加中转配置」，填写 Base URL 和 API Key
选择该配置并点击「应用中转注入」
之后用 Codex++ 入口（不是原版 Codex）启动

Codex++ 会自动在 ~/.codex/config.toml 写入以下内容：

model_provider = "CodexPlusPlus"  [model_providers.CodexPlusPlus] name = "CodexPlusPlus" wire_api = "responses" base_url = "https://你的API端点/v1" experimental_bearer_token = "sk-..."

② 插件市场解锁

原版 Codex App 在 API Key 模式下，插件市场显示「需要登录 ChatGPT」，插件入口直接消失。

Codex++ 注入后，插件市场请求会被增强处理，完整插件列表恢复显示，安装和使用不再受限。

③ 会话管理增强

原版 Codex 的会话列表没有删除按钮，只有归档。

Codex++ 注入后：

鼠标悬停在会话上，出现删除按钮
删除前弹出确认对话框
支持撤销（误删可以找回）

④ Markdown 导出

在管理工具里，可以把任意会话导出为带时间戳的 Markdown 文件——备份、整理、复用，一键搞定。

⑤ 对话时间线

右侧边栏显示当前会话的提问时间线，悬停可看摘要，点击直接跳转。长对话再也不怕翻不到历史了。

八、沙盒权限详解

Codex 的 sandbox_mode 控制它能操作哪些文件：

模式	权限	适合场景
`read-only`	只读，不能修改任何文件	代码审查、分析
`workspace-write` （推荐）	只能修改当前工作区目录	日常开发
`danger-full-access`	可读写系统任意路径	系统脚本，慎用

日常开发推荐配置：

sandbox_mode = "workspace-write" approval_policy = "on-request"

approval_policy = "on-request" 意味着遇到删文件、运行数据库迁移等破坏性操作，Codex 会暂停等你确认，不会自动乱来。

九、常用命令速查

codex                        # 进入交互模式（最常用） codex -q "任务描述"           # 单次任务，不进入交互界面 codex -z "任务描述"           # 纯净输出，适合管道/脚本 codex --model deepseek-r1 -q "分析算法复杂度"  # 临时切换模型 codex doctor                 # 诊断配置和网络 codex --help                 # 查看所有参数

十、常见问题

Q：Codex 会自己删文件吗？

不会。默认 approval_policy = "on-request" 下，破坏性操作会暂停等你确认。只有设置 approval_policy = "never" 才会全自动执行，日常别用这个。

Q：Codex 和 Claude Code 哪个更好用？

功能类似，都是终端 AI 编程智能体。Codex 完全开源（Apache-2.0），Claude Code 是 Anthropic 出品。国内两者都能通过 API 代理使用，选自己顺手的就行。

Q：npm 安装很慢怎么办？

切淘宝镜像：

npm install -g @openai/codex --registry https://registry.npmmirror.com

Q：Codex++ 安全吗？会不会被查？

Codex++ 不修改 Codex 原始文件，只是外部注入。代码完全开源，可以自己审查。如果担心，随时可以直接用原版 Codex。

写在最后

Codex CLI + Codex++ 这套组合，国内用户现在可以做到：

✅ 无需翻墙，接入 DeepSeek / Kimi / Claude 等国内可用模型 ✅ 无需 OpenAI 账号，用 API Key 模式运行 ✅ 插件市场完整解锁 ✅ 会话管理、导出、时间线一应俱全

开始用的门槛并不高。 5 分钟装完，5 分钟配好，然后让它帮你干活。

GitHub 地址：

Codex CLI：https://github.com/openai/codex
Codex++：https://github.com/xianyu110/CodexPlusPlus