Codex CLI生产环境实战：从安装到自动化代码审查

# 方式一：npm安装（推荐）
npm install -g @openai/codex

# 国内加速
npm install -g @openai/codex --registry=https://registry.npmmirror.com

# 方式二：Codex App（Windows用户）
# 从OpenAI官网下载Codex App

# 启动并登录
codex
# 系统自动唤起浏览器进行ChatGPT账号授权
# Token自动保存，无需每次输入API Key

# 配置默认模型
# ~/.codex/config.toml
[model]
default = "gpt-5-codex"
reasoning = "high"  # low/medium/high

$ codex
> 帮我审查src/auth目录下的代码，重点关注安全问题

# Codex会：
# 1. 读取src/auth/下所有文件
# 2. 分析代码逻辑和安全风险
# 3. 输出审查报告和修改建议
# 4. 可选择直接应用修改

# 直接执行任务
codex "创建一个Hello World的Python脚本"

# 指定目录
codex --dir /path/to/project "修复所有TypeScript错误"

# 管道输入
cat error.log | codex "分析这个错误日志，找出根本原因"

# .github/workflows/codex-review.yml
name: Codex Code Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      
      - name: Setup Node
        uses: actions/setup-node@v4
        with:
          node-version: '22'
      
      - name: Install Codex
        run: npm install -g @openai/codex
      
      - name: Run Review
        env:
          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
        run: |
          # 获取PR diff
          git diff origin/main...HEAD > pr.diff
          
          # Codex审查
          codex --non-interactive "审查以下PR diff，检查：
            1. 安全漏洞
            2. 性能问题
            3. 代码风格
            4. 潜在bug
            输出审查报告到 review.md" < pr.diff
      
      - name: Post Review
        uses: actions/github-script@v7
        with:
          script: |
            const fs = require('fs');
            const review = fs.readFileSync('review.md', 'utf8');
            github.rest.issues.createComment({
              ...context.repo,
              issue_number: context.issue.number,
              body: review
            });

📄 审查报告：PR #142 - 用户认证重构

🔴 严重问题 (2)
1. src/auth/login.ts:45
   密码比较使用了 == 而非 timingSafeEqual
   建议：使用crypto.timingSafeEqual防止时序攻击

2. src/auth/token.ts:78
   JWT secret硬编码在源码中
   建议：使用环境变量 JWT_SECRET

🟡 警告 (3)
1. src/auth/middleware.ts:23
   未对refresh token进行轮换
2. src/auth/session.ts:56
   session过期时间过长（30天）
3. src/auth/oauth.ts:89
   未验证state参数

✅ 良好实践 (5)
- 使用了bcrypt进行密码哈希
- 实现了rate limiting
- 错误信息不泄露内部状态
...

$ codex
> 为src/utils/validator.ts生成完整的单元测试，要求：
  - 行覆盖率 > 90%
  - 包含边界条件测试
  - 包含错误路径测试
  - 使用Jest框架

# Codex会：
# 1. 读取validator.ts
# 2. 分析所有函数和分支
# 3. 生成测试文件src/utils/validator.test.ts
# 4. 运行测试验证
# 5. 根据结果调整测试

$ codex
> 我要实现一个函数：验证中国身份证号码
  先写测试，再写实现

# Codex流程：
# 1. 生成测试用例（合法/非法/边界）
# 2. 运行测试（全部失败）
# 3. 实现函数
# 4. 运行测试（通过）
# 5. 优化边界处理

# .github/workflows/auto-fix.yml
name: Auto Fix Bugs
on:
  schedule:
    - cron: '0 2 * * *'  # 每天凌晨2点

jobs:
  auto-fix:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Install Codex
        run: npm install -g @openai/codex
      
      - name: Find and Fix Bugs
        env:
          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
        run: |
          # 扫描TypeScript错误
          npx tsc --noEmit > errors.log 2>&1
          
          if [ -s errors.log ]; then
            codex --non-interactive "修复errors.log中列出的所有TypeScript错误" < errors.log
            
            # 创建PR
            git checkout -b auto-fix/$(date +%Y%m%d)
            git add -A
            git commit -m "auto-fix: TypeScript errors"
            gh pr create --title "Auto-fix: TypeScript errors" --body "由Codex自动修复"
          fi

# AGENTS.md - 项目指南

## 项目概述
这是一个电商后台管理系统，使用React + TypeScript + Node.js。

## 代码规范
- 使用TypeScript strict模式
- 函数必须有JSDoc注释
- 禁止使用any类型
- 所有API调用必须经过src/api/client.ts

## 测试要求
- 核心逻辑必须有单元测试
- 测试覆盖率 > 80%
- 使用Jest + React Testing Library

## 禁止事项
- 不要修改src/legacy/目录（历史遗留代码）
- 不要使用class组件（只用函数组件）
- 不要直接操作DOM