一、Codex教程

2301_80122345

3060人浏览 · 2026-07-16 22:44:54

2301_80122345 · 2026-07-16 22:44:54 发布

OpenAI Codex 是一个AI编程代理，不是帮助补全代码，而是直接参与并完成整个开发任务（写代码、修改bug、测试等等）

一、使用方式

ChatGPT 网页端：侧边栏进入「Code」模式，输入指令即可发起任务。
Codex CLI：命令行直接调用，适合脚本与自动化流程。
IDE 插件：VS Code 等编辑器内直接交互，实时查看进度与结果。
桌面应用（macOS）：多智能体并行管理，可视化监控任务执行。

二、安装与使用

1、进入官网下载（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