Claude Code 和 OpenAI Codex 命令行命令大全

1. Claude Code 命令行指南

1.1 基础命令

命令格式 功能描述 使用示例 版本支持
claude 启动交互式 REPL 会话 claude 所有版本
claude "query" 带初始提示启动 REPL claude "解释当前项目结构" 所有版本
claude -p "query" 非交互模式执行查询后退出 claude -p "用 Python 写快速排序算法" 所有版本
cat file.txt | claude -p "query" 处理管道输入内容 cat error.log | claude -p "分析错误原因" 所有版本
claude -c 继续最近一次会话 claude -c v1.0.80+
claude -r <session-id> 恢复指定 ID 的会话 claude -r "abc123" "完成未提交的 PR" v1.0.85+
claude update 更新到最新版本 claude update 所有版本

核心特性:Claude Code 基于 Claude Opus 4.1 和 Sonnet 4 模型,支持通过 --model 参数切换,例如 claude --model claude-opus-4-20250215 启用 Opus 4.1 模型以处理复杂代码重构任务。

1.2 高级操作命令

参数配置

参数 描述 示例
--add-dir <path> 添加额外工作目录 claude --add-dir ../utils ../config
--allowedTools 配置无需提示的工具列表 claude --allowedTools "Bash(git:*)" "Edit"
--output-format 指定输出格式(text/json/stream-json) claude -p "查询" --output-format json
--dangerously-skip-permissions 跳过权限提示(危险模式) claude --dangerously-skip-permissions

批量处理与自动化

  • 自定义命令:在 .claude/commands 目录创建 Markdown 文件定义批量任务,例如 test.md 包含:

    # 批量测试命令
    为 $ARGUMENTS 生成 Jest 测试用例,要求覆盖边界条件和错误处理。

    使用:/test UserService 自动生成测试文件。

  • MCP 服务器配置:通过 claude mcp 启动模型上下文协议服务器,集成外部工具如 Playwright 进行浏览器自动化:

    {
      "mcpServers": {
        "playwright": {
          "type""stdio",
          "command""npx",
          "args": ["-y""@playwright/mcp@latest"]
        }
      }
    }

1.3 常用快捷键及效率技巧

快捷键组合 功能描述 适用场景
Shift+Tab 切换模式(编辑/自动接受/计划) 任务执行阶段切换权限
Cmd/Ctrl+L 清屏 会话过长时保持界面整洁
Esc+Esc 跳转到上一条消息 回溯对话历史
Shift+Enter 多行输入(需先执行 /terminal-setup 输入复杂需求或代码块
Cmd/Ctrl+E 快速打开 Claude Code(IDE 集成) VS Code/JetBrains 中唤醒

效率技巧

  • 使用 /compact "保留未解决问题" 压缩对话上下文,减少 Token 消耗。
  • 通过 /memory 命令编辑 CLAUDE.md,固化项目知识(如架构、规范),避免重复解释。
  • 并行任务处理:claude --instance refactor 启动独立实例,多会话不干扰。

1.4 错误处理及调试命令

命令/错误码 描述与解决方案
/doctor 检查安装完整性,修复依赖缺失、权限问题(如 OAuth 认证失败)
/context 自助调试上下文问题,输出当前加载的文件和记忆内容
401 未授权 重新执行 claude auth login,检查 API 密钥有效性(参考 Anthropic 认证文档
Token 超限 执行 /cost 查看用量,使用 /clear 重置上下文或升级至 Opus 模型提升限额

调试示例

claude /doctor  # 检查并修复 MCP 连接问题
claude -p "分析错误" --verbose  #  verbose 模式输出推理过程

1.5 与其他开发工具的集成命令

IDE 集成

  • VS Code/JetBrains
    claude /ide  # 选择 IDE 并自动安装插件
    # 在 IDE 中通过 Cmd/Ctrl+E 唤醒,支持代码差异预览和文件引用(如 @src/main.js)

版本控制与 CI/CD

  • Git 集成
    claude /pr_comments  # 生成 PR 评审意见
    claude -p "解决合并冲突" --allowedTools "Bash(git merge:*)"
  • GitHub Actions
    - name: Claude Code 自动化测试
      run: |
        npm install -g @anthropic-ai/claude-code
        claude -p "运行测试并修复错误" --model opus

1.6 版本差异对比

版本 核心更新内容 命令变化示例
v1.0.69 升级 Opus 至 4.1 模型,支持子代理分工协作 claude /model opus 启用 Opus 4.1
v1.0.88 修复 OAuth 认证问题,新增 ANTHROPIC_DEFAULT_OPUS_MODEL 环境变量 export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-20250514
v1.0.93 支持剪贴板图片粘贴(Windows Alt+V),优化网络代理配置 claude --no-proxy localhost,127.0.0.1

模型差异

  • Sonnet 4:适合日常开发,响应速度快,claude --model sonnet
  • Opus 4.1:复杂任务(如多文件重构),claude --model opus,推理深度提升 40%

2. OpenAI Codex 命令行指南

2.1 基础命令

命令格式 功能描述 使用示例 版本支持
codex 启动交互式 REPL 会话 codex 所有版本
codex "query" 带初始提示启动 REPL codex "生成 Dockerfile 用于 Node.js 应用" 所有版本
codex -q "query" 非交互静默模式执行查询 codex -q --json "分析 utils.ts" v0.1.250422+
codex --approval-mode full-auto 全自动模式执行任务(沙箱隔离) codex --approval-mode full-auto "修复 lint 错误" v0.1.250421+

核心特性

  • 多模型支持:通过 --model 指定 gpt-5-codex(默认)、gpt-4.1 等,例如 codex --model gpt-4.1
  • 多模态输入:支持截图解析,如 codex -i error.png "解释此错误并修复"

2.2 高级操作命令

参数配置与批量处理

参数 描述 示例
--model 指定模型(gpt-5-codex/gpt-4.1 等) codex --model gpt-5-codex
--sandbox 配置沙箱模式(danger-full-access/readonly) codex --sandbox readonly
--batch 批量处理任务文件 codex --batch tasks.json

自动化与脚本集成

  • 任务模板:创建 tasks.json 批量生成代码:

    [
      {"prompt""写一个 Python 斐波那契函数""output""fib.py"},
      {"prompt""生成单元测试""output""fib.test.py"}
    ]

    执行:codex --batch tasks.json

  • CI/CD 集成:在 GitHub Actions 中自动修复构建错误:

    - name: Codex 自动修复
      run: |
        codex --approval-mode auto-edit "修复构建错误"
        git commit -am "fix: auto-resolved build errors"

2.3 常用快捷键及效率技巧

快捷键组合 功能描述 适用场景
Ctrl+/ 打开 Codex 面板(VS Code 插件) IDE 中快速唤醒
Tab 接受代码建议 补全函数或修复错误
Ctrl+Shift+Enter 生成多个解决方案 需求不明确时对比方案

效率技巧

  • 使用 codex snippet add "排序算法" ./sort.js 将常用代码片段保存为模板,通过 codex snippet get "排序算法" 快速调用。
  • 配置 ~/.codex/config.yaml 固化偏好:
    model: gpt-5-codex
    approval-mode: suggest
    reasoning-effort: high  # 复杂任务提升推理深度

2.4 错误处理及调试命令

错误码/命令 描述与解决方案
429 速率限制 配置环境变量 OPENAI_MAX_RETRIES=5OPENAI_MS_BETWEEN_RETRIES=1000 启用指数退避重试
400 无效请求 检查提示格式,确保未包含 reasoning 类型字段(参考 Codex GitHub Issues #1235
codex doctor 诊断 CLI 安装问题,如 Node.js 版本过低(需 ≥22.x)

调试示例

export OPENAI_API_KEY="sk-xxx"
export OPENAI_MAX_RETRIES=3  # 重试 3 次解决速率限制
codex --approval-mode auto-edit "修复 SQL 注入漏洞"

2.5 与其他开发工具的集成命令

版本控制与协作

  • GitHub 集成:自动生成 PR 描述:
    codex pr-description --branch feature/auth > PULL_REQUEST_TEMPLATE.md
  • Git 钩子:在 pre-commit 中运行 Codex 代码审查:
    #!/bin/sh
    codex review --staged  # 仅审查暂存文件

云服务集成

  • AWS 部署:通过 MCP 调用 AWS CLI 生成 CloudFormation 模板:
    codex --mcp aws "生成 S3 静态网站部署模板"

2.6 版本差异对比

版本 核心更新内容 命令变化示例
GPT-4 Codex 基础代码生成,支持 suggest/auto-edit 模式 codex --approval-mode auto-edit
GPT-5 Codex 长时任务处理(最长 7 小时连续运行),多模态输入,full-auto 沙箱模式 codex --full-auto --sandbox danger-full-access
v0.1.2504220136 修复 workdir 参数缺失问题,需显式指定工作目录 codex --workdir ./src "重构路由"

3. 工具对比与最佳实践

3.1 核心功能对比

维度 Claude Code OpenAI Codex
模型能力 Opus 4.1/Sonnet 4,擅长复杂重构与多文件协作 GPT-5-Codex,高效完成单任务与自动化脚本
权限控制 细粒度工具权限(--allowedTools),子代理分工 沙箱模式分级(只读/自动编辑/全自动)
集成深度 原生支持 MCP 扩展,与 IDE 无缝联动 侧重 CLI 与 GitHub 生态,云任务托管
成本效率 按 Token 计费,Opus 模型成本较高 包含于 ChatGPT Plus 订阅($20/月),性价比突出

3.2 最佳实践建议

  • 复杂项目重构:选择 Claude Code,通过 /init 生成 CLAUDE.md 固化项目知识,使用子代理分工处理前后端任务。
  • 快速原型开发:使用 OpenAI Codex --full-auto 模式,配合 codex scaffold react 生成项目框架,30 分钟内完成 MVP。
  • 企业级安全合规:Claude Code 支持 --disallowedTools "Bash(rm:*)" 禁用高危命令,符合 SOC2 认证要求。 注:本文 Claude Code 命令参考 Anthropic CLI 官方文档;OpenAI Codex 内容基于 OpenAI 博客CSDN 实战指南
阅读: 5 | 发布时间: 2025-09-23 16:15:52