🤖 Codex CLI 安装与入门

工具扩展篇 — OpenAI 出品的命令行 AI 编程助手

🎯 这篇讲什么

Codex CLI 是 OpenAI 推出的终端 AI 编程工具。和 Claude Code 类似，但用的是 OpenAI 的模型（GPT 系列）。这篇文章教你从零装好并用起来。

📊 Codex vs Claude Code 快速对比

	Codex CLI	Claude Code
开发者	OpenAI	Anthropic
安装方式	`npm install -g @openai/codex`	`npm install -g @anthropic-ai/claude-code`
默认模型	GPT-4o / o4-mini	Claude Sonnet
开源	否	否
必须 Git 仓库	✅ 必须在 Git 仓库内运行	❌ 无此限制
运行模式	`codex exec`（单次）	`claude -p`（单次）
全自动模式	`--full-auto`	`--dangerously-skip-permissions`
极限模式	`--yolo`	同上

📋 前置检查


# 1. Node.js ≥ 18
node --version

# 2. npm
npm --version

# 3. Git
git --version

🚀 安装


# 全局安装
npm install -g @openai/codex

# Linux 服务器权限不够加 sudo
sudo npm install -g @openai/codex

# 验证
codex --version

🔐 认证


# 方式一：环境变量（推荐）
export OPENAI_API_KEY="sk-你的OpenAI密钥"

# 写入 shell 配置永久生效
echo 'export OPENAI_API_KEY="sk-你的密钥"' >> ~/.bashrc
source ~/.bashrc

# 方式二：OAuth 登录
codex auth login

💡 OpenAI API Key 获取：https://platform.openai.com/api-keys

🎮 使用方式

模式 1：单次执行（`codex exec`）— 推荐


# 基本用法：必须在 Git 仓库内执行
cd ~/my-project
codex exec "添加一个深色模式切换按钮"

# 带上下文文件
codex exec "审查这个配置的安全性" -f config.yaml -f .env.example

模式 2：全自动模式（`--full-auto`）


# 自动批准沙箱内的文件更改
codex exec --full-auto "重构 auth 模块"

模式 3：极限模式（`--yolo`）⚠️


# 无沙箱、无批准，全部自动执行（危险！）
codex --yolo exec "修复所有 lint 错误"

🔑 关键特性

必须在 Git 仓库中运行

Codex 要求在有 .git 目录的项目里执行。如果只是想测试：


# 创建临时 Git 仓库
cd $(mktemp -d) && git init
codex exec "用 Python 写一个贪吃蛇游戏"

沙箱安全

模式	文件修改	Bash 执行	适合场景
`codex exec`	需确认	需确认	日常开发
`--full-auto`	自动批准	自动批准（沙箱内）	批量重构
`--yolo`	全部自动	全部自动	CI/自动化 ⚠️

📦 实战场景

PR 审查


# 克隆到临时目录审查
REVIEW=$(mktemp -d)
git clone https://github.com/user/repo.git $REVIEW
cd $REVIEW
gh pr checkout 42
codex exec "Review this PR vs main. 关注安全问题、逻辑错误和测试覆盖。"

批量修 Issue


# 为每个 Issue 创建独立 worktree
git worktree add -b fix/issue-78 /tmp/issue-78 main
git worktree add -b fix/issue-99 /tmp/issue-99 main

# 并行修复
cd /tmp/issue-78 && codex --yolo exec "修复 Issue #78 并提交" &
cd /tmp/issue-99 && codex --yolo exec "修复 Issue #99 并提交" &

# 完成后推送
cd /tmp/issue-78 && git push -u origin fix/issue-78

❓ 常见问题 (FAQ)

Q1: Codex 和 Claude Code 装哪个？

有 OpenAI Key 选 Codex，有 Anthropic/DeepSeek Key 选 Claude Code。功能相似，主要看你有哪个模型的 Key。

Q2: 为什么提示 "not a git repository"？

Codex 必须在 Git 仓库内运行。git init 创建一个新仓库即可。

Q3: `--full-auto` 和 `--yolo` 有什么区别？

--full-auto 有沙箱保护，--yolo 完全没有限制。日常用 --full-auto，CI 用 --yolo。

Q4: 需要什么 OpenAI 账号等级？

API Key 即可，不需要 ChatGPT Plus 订阅。按量付费。

Q5: 能和 Hermes 联动吗？

能。Hermes 可以安装 codex 技能，通过微信/TG 指挥 Codex 写代码。

⚠️ 避坑指南

坑	正确做法
不在 Git 仓库里执行	先用 `git init` 或 `cd` 到现有项目
`--yolo` 乱删文件	先用 `git commit` 备份，`--yolo` 只在 CI 中用
OpenAI API 余额不足	去 platform.openai.com 充值，最低 $5
`codex` 命令找不到	检查 npm 全局路径是否在 PATH

标签：#AI #Codex #OpenAI #安装 #编程助手