# Codex 安装与使用核心精简内容
## 一、五大安装渠道（场景+推荐星级）
1. Codex网页应用 ⭐⭐⭐⭐
入口：chatgpt.com/codex，登录ChatGPT即用，适合快速轻度使用，国内访问存在网络阻碍，替代：字节Trae、阿里Qoder
2. Codex CLI（终端，首选）⭐⭐⭐⭐⭐
本地运行，仅上传指令，源码保存在本地，支持读写代码、执行Shell、自动修Bug
3. IDE插件（VS Code/Cursor/Windsurf）⭐⭐⭐⭐
编辑器内直接调用，写代码、重构、修复一键完成
4. Homebrew（Mac专属）⭐⭐⭐⭐
无需装Node，一键安装：brew install --cask codex
5. GitHub二进制包（离线/无npm）⭐⭐⭐
github.com/openai/codex/releases，对应系统压缩包手动解压配置环境变量

## 二、CLI完整安装流程（国内加速）
1. 全局安装
```bash
# 官方源
sudo npm install -g @openai/codex
# 国内镜像加速
sudo npm install -g @openai/codex --registry=https://registry.npmmirror.com
```
2. 启动命令
```bash
codex
```

## 三、3种登录认证方式
1. 网页登录（推荐）：运行codex，选择ChatGPT网页授权登录
2. API Key环境变量
```bash
# Mac/Linux临时
export OPENAI_API_KEY="sk-xxx"
# 永久写入zsh
echo 'export OPENAI_API_KEY="sk-xxx"' >> ~/.zshrc && source ~/.zshrc
# Windows PowerShell
$env:OPENAI_API_KEY="sk-xxx"
```
3. auth.json配置文件
```bash
mkdir -p ~/.codex
cat > ~/.codex/auth.json << 'EOF'
{"OPENAI_API_KEY":"sk-xxx"}
EOF
```

## 四、CLI三种运行安全模式
1. Suggest（默认）：仅输出修改建议，不改动文件
2. Auto Edit：自动修改本地代码文件
```bash
codex --auto-edit
```
3. Full Auto：自动执行命令+改代码，高风险
```bash
codex --full-auto
```

## 五、升级&卸载命令
### 更新
```bash
codex --upgrade
npm update -g @openai/codex
# 强制重装最新
npm install -g @openai/codex@latest
```
### 卸载
```bash
# npm卸载
npm uninstall -g @openai/codex
# Mac Homebrew卸载
brew uninstall --cask codex
```

## 六、GitHub二进制手动安装步骤
1. 对应系统下载压缩包：aarch64苹果硅、x86英特尔、Linux
2. 解压，重命名为codex
3. 移入全局命令目录
`sudo mv codex /usr/local/bin
4. 终端直接输入codex启动

## 七、IDE插件安装步骤
1. VS Code/Cursor打开插件市场
2. 搜索Codex安装
3. 登录ChatGPT账号，编辑器内直接使用代码生成、重构、bug修复

## 八、系统兼容说明
- macOS / Linux：完整全功能支持
- Windows：实验性功能，推荐搭配WSL终端使用

## 九、首次使用标准流程
1. 进入项目文件夹：cd 项目名`
2. 执行codex启动
3. 输入指令：分析项目结构/生成函数/修复报错等
4. 根据需求切换Suggest/Auto/Full Auto模式