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

目录

• 1、Codex 应用
• 2、Codex CLI
• 安装 Codex CLI
• 登录 Codex
• 方法一：ChatGPT 登录（推荐）
• 方法二：API Key 登录
• 方式三：auth.json 文件配置
• 第一次运行 Codex
• Codex 的三种运行模式
• 更新与卸载
• 3、Homebrew 安装（Mac 推荐）
• GitHub Release 安装（二进制）
• 5、IDE 插件安装
• 6、更新 Codex

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

接下来分别介绍。

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

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

下载应用：

登录 ChatGPT 账号即可使用。

界面说明：

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

支持计划：

• ChatGPT Plus
• ChatGPT Pro
• ChatGPT Business
• ChatGPT Edu
• ChatGPT Enterprise

Web 版的特点：

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

适合：

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

开发者最常用的方式是 Codex CLI。

CLI 是一个运行在终端中的 AI 编程代理，可以：

• 阅读代码
• 修改代码
• 执行 shell 命令
• 自动修复 bug

Codex CLI 在本地运行，因此代码不会被上传到云端，只有 prompt 和必要的上下文会发送给模型。

使用 npm 安装：

sudo npm install -g @openai/codex

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

安装完成后运行：

codex

即可启动 Codex。

首次运行需要登录。

有两种方式：

codex

选择：

Sign in with ChatGPT

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

登录完成即可使用。

配置URL：https://code.ai80.vip

如果是开发者模式，可以使用 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

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

mkdir -p ~/.codex

写入 API key:

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

进入项目目录：

cd my-project

启动 Codex：

codex

然后输入：分析下当前的项目结构

Codex 会自动：

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

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

mkdir codex-runoob-test

进入目录：

cd codex-runoob-test

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

print("Hello Runoob!")

启动 Codex：

codex

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

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

Mac 用户可以使用 Homebrew 安装。

brew install --cask codex

安装完成后运行：

codex

即可启动。

这种方式适合：

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

如果不想使用 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

即可使用。

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

• VS Code
• Cursor
• Windsurf
• VS Code forks

安装方式：

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

例如：

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

Codex CLI 更新非常简单：

codex --upgrade

或者：

npm update -g @openai/codex

codex --version

Codex CLI 目前支持：

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

到此这篇关于2026Codex国内安装与使用小白教程的文章就介绍到这了,更多相关Codex国内安装与使用内容请搜索风君子博客以前的文章或继续浏览下面的相关文章，希望大家以后多多支持风君子博客！