Codex 安装与使用
Codex 可以通过多种方式使用，根据开发者的习惯，大致可以分为五种方式：
安装方式
使用场景
推荐程度
Codex 应用
直接下载 Codex 应用
⭐⭐⭐⭐
Codex CLI
在终端使用
⭐⭐⭐⭐⭐
IDE 插件
在 VS Code / Cursor 使用
⭐⭐⭐⭐
Homebrew 安装
Mac 用户
⭐⭐⭐⭐
GitHub Release 二进制
手动安装
⭐⭐⭐
接下来分别介绍。
1、Codex 应用
最简单的方式就是 直接使用 Codex 应用，需要好的网络连接。
访问：https://chatgpt.com/codex
下载应用：
登录 ChatGPT 账号即可使用。
界面说明：
然后可以输入框输入我们的需求：
Codex 访问及使用如果有障碍，国内阿里 Qoder Quest 与字节 Trae Solo 也是类似的产品。
2、Codex CLI
开发者最常用的方式是 Codex CLI。
CLI 是一个运行在终端中的 AI 编程代理，可以：
阅读代码
修改代码
执行 shell 命令
自动修复 bug
Codex CLI 在本地运行，因此代码不会被上传到云端，只有 prompt 和必要的上下文会发送给模型。
安装 Codex CLI
使用 npm 安装：
sudo npm install -g @openai/codex
# 使用国内镜像安装更快
sudo npm install -g @openai/codex --registry=https://registry.npmmirror.com
安装完成后运行：
codex
即可启动 Codex。
登录 Codex
首次运行需要登录。
有两种方式：
方法一：ChatGPT 登录（推荐）
codex
选择：
Sign in with ChatGPT
然后浏览器会打开登录页面。
登录完成即可使用。
方法二：API Key 登录
如果是开发者模式，可以使用 API Key：
# macOS / Linux - 临时设置（仅当前终端会话有效）
export OPENAI_API_KEY="sk-你的API密钥"
# 永久配置（添加到 ~/.bashrc 或 ~/.zshrc）
echo 'export OPENAI_API_KEY="sk-你的API密钥"' >> ~/.zshrc
source ~/.zshrc
# Windows PowerShell
$env:OPENAI_API_KEY="sk-你的API密钥"
# 配置后启动（指定模型）
codex --model gpt-5-codex
然后运行：
codex
方式三：auth.json 文件配置
手动编辑认证文件, 创建目录:
mkdir -p ~/.codex
写入 API key:
cat > ~/.codex/auth.json << 'EOF'
{
"OPENAI_API_KEY": "sk-你的API密钥"
}
EOF
第一次运行 Codex
进入项目目录：
cd my-project
启动 Codex：
codex
然后输入：
分析下当前的项目结构
Codex 会自动：
扫描代码库
分析项目结构
输出系统架构说明
例如，我们创建一个目录：
mkdir codex-runoob-test
进入目录：
cd codex-runoob-test
新建 test.py 文件，代码如下：
print("Hello Runoob!")
启动 Codex：
codex
选第一个 Yes, continue 回车，这样就可以开始使用 Codex Cli 开始写代码了:
Codex 的三种运行模式
Codex CLI 提供三种安全模式。
模式
功能
Suggest
只建议修改
Auto Edit
自动修改文件
Full Auto
自动执行所有操作
默认模式：
Suggest
切换模式：
codex --auto-edit
或者：
codex --full-auto
Full Auto 模式可以自动执行代码修复和任务。
更新与卸载
# 更新到最新版本
npm update -g @openai/codex
# 或强制重装最新版
npm install -g @openai/codex@latest
# 卸载
npm uninstall -g @openai/codex
# Homebrew 卸载
brew uninstall --cask codex
3、Homebrew 安装（Mac 推荐）
Mac 用户可以使用 Homebrew 安装。
brew install --cask codex
安装完成后运行：
codex
即可启动。
这种方式适合：
Mac 开发者
不想安装 Node.js 的用户。
GitHub Release 安装（二进制）
如果不想使用 npm，也可以直接下载二进制版本。
下载地址：https://github.com/openai/codex/releases
常见版本：
Mac Apple Silicon：
codex-aarch64-apple-darwin.tar.gz
Mac Intel：
codex-x86_64-apple-darwin.tar.gz
Linux：
codex-x86_64-unknown-linux-musl.tar.gz
下载后解压：
tar -xzf codex-xxx.tar.gz
重命名：
mv codex-x86_64-unknown-linux-musl codex
加入 PATH：
sudo mv codex /usr/local/bin
然后运行：
codex
即可使用。
5、IDE 插件安装
Codex 还可以在 IDE 中使用，例如：
VS Code
Cursor
Windsurf
VS Code forks
安装方式：
1. 打开 IDE 插件市场
2. 搜索 Codex
3. 安装插件
4. 登录 ChatGPT 账号
这样可以在 IDE 内直接使用 Codex。
例如：
自动修复代码
自动生成函数
自动重构代码
6、更新 Codex
Codex CLI 更新非常简单：
codex --upgrade
或者：
npm update -g @openai/codex
codex --version
Codex CLI 目前支持：
系统
支持情况
macOS
完整支持
Linux
完整支持
Windows
实验支持（建议 WSL）