Codex 安装与使用

Codex 可以通过多种方式使用，根据开发者的习惯，大致可以分为五种方式：

安装方式	使用场景	推荐程度
Codex 应用	直接下载 Codex 应用	⭐⭐⭐⭐
Codex CLI	在终端使用	⭐⭐⭐⭐⭐
IDE 插件	在 VS Code / Cursor 使用	⭐⭐⭐⭐
Homebrew 安装	Mac 用户	⭐⭐⭐⭐
GitHub Release 二进制	手动安装	⭐⭐⭐

接下来分别介绍。

1、Codex 应用

最简单的方式就是 直接使用 Codex 应用，需要好的网络连接。

访问：https://chatgpt.com/codex

下载应用：

界面说明：

然后可以输入框输入我们的需求：

支持计划：

ChatGPT Plus
ChatGPT Pro
ChatGPT Business
ChatGPT Edu
ChatGPT Enterprise

Web 版的特点：

不需要本地环境
直接连接 GitHub
任务在云端运行
可以自动创建 PR

适合：

快速体验 Codex
代码审查
代码库分析

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）

返回顶部

菜鸟教程