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=5 和 OPENAI_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 实战指南。