1
2
3
4
5
6
7
8

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

# macOS/Linux 也可以用 Homebrew
brew install codex

# 验证安装
codex --version

1
2

alias codex='codex -m gpt-5-codex -c model_reasoning_effort="high" --search'
source ~/.zshrc

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# 项目编码规范

- **语言**：TypeScript 优先
- **框架**：React 18 + Hooks
- **测试**：Jest + React Testing Library
- **格式**：ESLint + Prettier
- **风格指南**：Airbnb 约定
- **环境变量前缀**：REACT_APP_
- **提交规范**：Conventional Commits
- **禁区目录**：node_modules, dist, build, .next

1

codex "重构整个 src 目录，转换为 TypeScript，添加类型定义，生成测试，优化性能"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 第一步：完成类型定义
codex "分析 src/index.js，生成 TypeScript 类型定义"

# 第二步：转换代码
codex "将 src/index.js 从 JavaScript 转换为 TypeScript，使用刚生成的类型"

# 第三步：生成测试
codex "为转换后的 TypeScript 代码生成 Jest 单元测试"

# 第四步：性能优化
codex "分析代码性能问题，提出优化建议"

1
2
3
4
5
6
7
8

# 批量将 JavaScript 转换为 TypeScript
codex "将所有 .js 文件转换为 TypeScript，添加类型定义" --mode batch src/**/*.js

# 批量添加单元测试
codex "为所有函数生成 Jest 测试用例" --mode test src/**/*.ts

# 批量优化性能
codex "分析并优化所有 React 组件的渲染性能" --mode optimize components/

1
2
3
4
5
6
7
8

# 生成数据处理脚本
codex "创建一个 Python 脚本，读取 CSV 文件，清理数据，生成统计报告"

# 生成部署脚本
codex "创建一个 Shell 脚本，自动化部署 Node.js 应用到 AWS Lambda"

# 生成数据库迁移脚本
codex "生成 SQL 迁移脚本，将 MySQL 数据库转换为 PostgreSQL"

1
2
3
4
5
6
7
8

# 查看 Git diff
/diff

# 仅修改特定文件
codex "只修改 src/app.js，不要改其他文件"

# 自动生成提交信息
codex git "Generate a commit message for adding user authentication feature"

1
2

git diff  # 审查变更
git checkout .  # 需要时撤销所有改动

1
2
3
4
5
6
7
8

# suggest 模式（最安全）：每一步都询问你
codex --approval-mode suggest "重构代码"

# auto-edit 模式（平衡）：自动修改文件，但提前显示 diff
codex --approval-mode auto-edit "重构代码"

# full-auto 模式（最快）：完全自动，不需要确认
codex --approval-mode full-auto "重构代码"

1
2
3
4
5
6
7
8

# 快速任务用 o4-mini
codex --model o4-mini "生成 CRUD API"

# 复杂逻辑用 o3
codex --model o3 "重构认证系统架构"

# 大文件用 gpt-4.1
codex --model gpt-4.1 "分析整个项目结构"

1
2
3
4
5
6
7
8

# 查看当前会话的 token 用量
/status

# 在长会话中压缩上下文
/compact

# 避免重复输入长代码，用文件引用
codex "分析 @src/app.js 的性能瓶颈"  # @ 符号引用文件

1
2
3
4
5
6

# 启动交互模式
codex

# 创建多个独立会话
/new  # 启动第二个 Agent 处理测试
/new  # 启动第三个 Agent 处理文档

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

# .github/workflows/codex-quality.yml
name: Codex Auto-Optimize

on: [pull_request]

jobs:
  optimize:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      
      - name: Install Codex CLI
        run: npm install -g @openai/codex
      
      - name: Auto-optimize changed files
        env:
          CODEX_API_KEY: ${{ secrets.CODEX_API_KEY }}
        run: |
          codex --approval-mode full-auto "Optimize all changed files following our style guide" --mode batch          
      
      - name: Create PR with improvements
        if: github.event_name == 'pull_request'
        run: |
          git config user.name "Codex Bot"
          git config user.email "codex@openai.com"
          git add -A
          git commit -m "chore: optimize code with Codex" || true
          git push          

1
2

# 一次性引用多个文件
codex "分析这些文件间的依赖关系，优化导入顺序" @src/app.js @src/utils/*.ts @src/hooks/useAuth.ts

1
2
3
4
5
6
7
8
9

# ~/.codex/config.toml
[mcp_servers]
enabled = true
server_url = "http://localhost:8080"

[model]
default_model = "gpt-5-codex"
max_tokens = 8192
temperature = 0.7

1
2
3
4
5
6
7
8

# 第一步：生成类型定义
codex "分析所有 src 目录的 .js 文件，生成对应的 TypeScript 类型定义" --mode batch

# 第二步：转换代码
codex "将所有 .js 文件转换为 TypeScript，使用刚生成的类型" --mode batch src/**/*.js

# 第三步：生成测试
codex "为所有组件生成 Jest 单元测试" --mode test src/**/*.tsx

1
2
3
4
5
6

codex "Create a comprehensive shell script to:
1. Build Docker image
2. Push to ECR
3. Deploy to Lambda
4. Run health checks
5. Rollback on failure"