2026Codex国内安装与使用小白教程

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

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

接下来分别介绍。

1、Codex 应用

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

访问：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 安装：

bash 复制代码

sudo npm install -g @openai/codex

# 使用国内镜像安装更快
sudo npm install -g @openai/codex --registry=https://registry.npmmirror.com

安装完成后运行：

bash 复制代码

codex

即可启动 Codex。

登录 Codex

首次运行需要登录。

有两种方式：

方法一：ChatGPT 登录（推荐）

bash 复制代码

codex

选择：

bash 复制代码

Sign in with ChatGPT

然后浏览器会打开登录页面。

登录完成即可使用。

方法二：API Key 登录

配置URL：code.ai80.vip

如果是开发者模式，可以使用 API Key：

bash 复制代码

# 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

然后运行：

bash 复制代码

codex

方式三：auth.json 文件配置

手动编辑认证文件, 创建目录:

bash 复制代码

mkdir -p ~/.codex

写入 API key:

bash 复制代码

cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "sk-你的API密钥"
}
EOF

第一次运行 Codex

进入项目目录：

bash 复制代码

cd my-project

启动 Codex：

bash 复制代码

codex

然后输入：

bash 复制代码

分析下当前的项目结构

Codex 会自动：

扫描代码库
分析项目结构
输出系统架构说明

例如，我们创建一个目录：

bash 复制代码

mkdir codex-runoob-test

进入目录：

bash 复制代码

cd codex-runoob-test

新建 test.py 文件，代码如下：

bash 复制代码

print("Hello Runoob!")

启动 Codex：

bash 复制代码

codex

选第一个 Yes, continue 回车，这样就可以开始使用 Codex Cli 开始写代码了:

Codex 的三种运行模式

Codex CLI 提供三种安全模式。

模式	功能
Suggest	只建议修改
Auto Edit	自动修改文件
Full Auto	自动执行所有操作

默认模式：

bash 复制代码

Suggest

切换模式：

bash 复制代码

codex --auto-edit

或者：

bash 复制代码

codex --full-auto

Full Auto 模式可以自动执行代码修复和任务。

更新与卸载

bash 复制代码

# 更新到最新版本
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 安装。

bash 复制代码

brew install --cask codex

安装完成后运行：

bash 复制代码

codex

即可启动。

这种方式适合：

Mac 开发者
不想安装 Node.js 的用户。

GitHub Release 安装（二进制）

如果不想使用 npm，也可以直接下载二进制版本。

下载地址：github.com/openai/code...

常见版本：

Mac Apple Silicon：

bash 复制代码

codex-aarch64-apple-darwin.tar.gz

Mac Intel：

bash 复制代码

codex-x86_64-apple-darwin.tar.gz

Linux：

bash 复制代码

codex-x86_64-unknown-linux-musl.tar.gz

下载后解压：

bash 复制代码

tar -xzf codex-xxx.tar.gz

重命名：

bash 复制代码

mv codex-x86_64-unknown-linux-musl codex

加入 PATH：

bash 复制代码

sudo mv codex /usr/local/bin

然后运行：

bash 复制代码

codex

即可使用。

5、IDE 插件安装

Codex 还可以在 IDE 中使用，例如：

VS Code
Cursor
Windsurf
VS Code forks

安装方式：

这样可以在 IDE 内直接使用 Codex。

例如：

自动修复代码
自动生成函数
自动重构代码

6、更新 Codex

Codex CLI 更新非常简单：

bash 复制代码

codex --upgrade

或者：

bash 复制代码

npm update -g @openai/codex

bash 复制代码

codex --version

Codex CLI 目前支持：

系统	支持情况
macOS	完整支持
Linux	完整支持
Windows	实验支持（建议 WSL）