Claude Code Codex 使用技巧大全：从入门到精通

终端级 AI 编程工具已成为开发者的核心生产力。本文系统整理 Claude Code 和 OpenAI Codex 的实战技巧帮你少踩坑、省 Token、提效率。一、Claude Code 使用技巧基础篇1. 把需求说具体AI 上下文有限制代码量太长可能输出不全甚至被截断。❌ 差帮我写一个用户管理系统 ✅ 好帮我写一个用户注册接口使用 Express TypeScript 包含邮箱验证、密码哈希bcrypt、JWT 返回 错误统一用 ApiError 类抛出2. 先理解项目再开动在修改代码之前先让 Claude 理解你的代码阅读这个项目的代码结构理解各模块的职责和依赖关系这个项目的数据流是怎样的从请求到响应经过哪些层src/services/ 目录下的服务之间有什么依赖关系3. 分步执行复杂任务每一步完成后你都可以先 review/测试再让 AI 执行下一步# 第一步先帮我分析当前支付模块的问题# 确认后好的按照你的分析先重构 PaymentService 类# 验证后通过了接下来处理 OrderService 的适配4. 善用深度思考模式在 Claude Code 中使用“think”关键词激活深度思考think about how to refactor this authentication modulethink harder about the race conditioninthis codeultrathink about the architectureforthis distributed system级别关键词适用场景普通思考think一般分析深度思考think harder复杂逻辑超级思考ultrathink架构级决策进阶篇5. 配置 CLAUDE.md 记忆文件CLAUDE.md是 Claude Code 自动读取的记忆文件类似 Cursor 的 rules但更强大# CLAUDE.md ## 项目概述 这是一个基于 Next.js 14 的电商平台使用 App Router。 ## 技术栈 - Frontend: React 18 TypeScript Tailwind CSS - Backend: Next.js API Routes Prisma PostgreSQL - Auth: NextAuth.js v5 ## 代码规范 - 使用 Conventional Commits - 组件使用 PascalCase工具函数使用 camelCase - 所有 API 返回统一格式{ success, data, error } ## 重要约束 - 不要修改 /src/core/ 下的文件 - 数据库迁移必须向后兼容 - 所有新接口必须有单元测试可以在多个位置放置CLAUDE.md文件Claude Code 会递归读取~/CLAUDE.md # 全局所有项目生效 ./CLAUDE.md # 项目根目录 ./src/CLAUDE.md # 子目录更具体的规则 ./src/components/CLAUDE.md # 更深层级6. 跳过权限确认Bypass Mode每次都要点确认太烦了# 单次启动claude --dangerously-skip-permissions# 设置别名推荐aliasccclaude --dangerously-skip-permissionsechoalias ccclaude --dangerously-skip-permissions~/.zshrc⚠️ 注意这相当于 Cursor 的老 YOLO 模式。理论上有风险但实际使用中极少出问题。7. 模型切换Claude Code 支持模型灵活切换/model# 查看当前模型/model opus# 切换到 Claude OpusMax 用户/model sonnet# 切换回 Claude Sonnet推荐强烈推荐 Sonnet体验与 Opus 差别不大但计费仅为 1/5。8. 对话式 Git 操作不用记繁琐的 Git 命令帮我把这次改动提交用 conventional commit 格式创建一个新分支 feature/payment-refactor把最近3次提交 cherry-pick 过去帮我 rebase 到 main有冲突的话保留我的改动9. 非交互模式单次执行适合脚本化和 CI/CD 集成# 单次执行后退出claude-p列出 src/ 下所有超过 200 行的 TypeScript 文件# 管道模式caterror.log|claude-p分析这个错误日志找出根因# 结合其他工具gitdiffHEAD~3|claude-p总结这3次提交的改动写成 changelog高级篇10. 配置 Hooks生命周期钩子Hooks 是在特定事件中自动运行的 shell 命令// .claude/settings.json{hooks:{PostToolUse:[{matcher:Write|Edit,hooks:[{type:command,command:npx prettier --write $CLAUDE_FILE_PATH}]}],Stop:[{matcher:,hooks:[{type:command,command:say \jobs done!\}]}],Notification:[{matcher:,hooks:[{type:command,command:terminal-notifier -message Claude needs input -title Claude Code}]}]}}实用 Hook 场景Hook 事件用途示例PreToolUse拦截敏感文件操作.env、secretsPostToolUse(Write)自动格式化、自动运行测试Stop任务完成后系统通知NotificationClaude 需要输入时弹窗提醒11. 自定义命令Slash Commands创建项目级快捷命令!-- .claude/commands/commit.md -- allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*) description: Create a conventional commit from current changes 分析当前 git diff写一个 Conventional Commit - subject 72 chars - 简洁的 body 描述为什么改 - Stage 相关文件并提交!-- .claude/commands/frontend/component.md -- description: Generate a React component with tests 创建一个 React 组件 - 使用 TypeScript Tailwind CSS - 包含 Props 接口定义 - 生成对应的 .test.tsx 文件 - 导出到 index.ts barrel file使用方式/commit /frontend/component UserProfile12. 配置项目级 Agent定义具有特定角色的智能体!-- .claude/agents/code-reviewer.md -- # Code Reviewer Agent ## 角色 你是一个严格的代码审查员。 ## 工具限制 仅允许Read, Search, Grep 禁止Write, Edit, Bash ## 审查标准 - 安全漏洞SQL注入、XSS、SSRF - 性能问题N1查询、内存泄漏 - 类型安全any 的使用 - 错误处理未捕获的 Promise13. MCP 连接外部服务使 Claude 能连接 Jira、GitHub、Notion、Sentry 等# 连接后可以直接说实现 JIRA-ENG-4521 中描述的功能查看 Sentry 上最近的报错分析根因把这个方案同步到 Notion 的技术文档中14. 安全防护 Hook防止 AI 误操作敏感文件{hooks:{PreToolUse:[{matcher:Write|Edit,hooks:[{type:command,command:python3 - PY\nimport json,sys\npjson.load(sys.stdin).get(tool_input,{}).get(file_path,)\nblock[.env,/secrets/,.git/]\nsys.exit(2 if any(b in p for b in block) else 0)\nPY}]}]}}15. 状态栏自定义在终端显示项目状态信息{statusLine:{type:command,command:~/.claude/statusline.sh}}二、Codex 使用技巧基础篇1. 提供清晰的代码上下文在提示中加入函数名、类名或代码片段帮助 Codex 快速定位codex在 UserService.createUser() 方法中添加邮箱格式验证 验证失败抛出 ValidationError2. 设置高推理等级默认推理等级为中等复杂任务建议提高# 单次使用codex--modelgpt-5-codex-cmodel_reasoning_efforthigh# 别名推荐aliascodexcodex -m gpt-5-codex -c model_reasoning_efforthigh -c model_reasoning_summary_formatexperimental --search --dangerously-bypass-approvals-and-sandbox3. 拆分大型任务将复杂任务分解为小步骤让 Codex 更容易处理和测试# 不要这样codex重构整个项目的认证系统# 这样做codex第一步分析当前 auth 模块的依赖关系codex第二步将 JWT 逻辑从 Controller 抽到 AuthServicecodex第三步添加 refresh token 机制4. 用于调试把详细日志或错误堆栈粘贴进去让 Codex 并行分析codex分析以下错误堆栈找出根因并修复$(cat/tmp/error.log)进阶篇5. 初始化 AGENTS.md类似 Claude Code 的 CLAUDE.md为 Codex 提供项目上下文codex /init# 自动生成 AGENTS.mdAGENTS.md示例# AGENTS.md ## 项目信息 - 语言TypeScript - 框架NestJS Prisma - 测试Jest Supertest ## 构建命令 - 安装依赖pnpm install - 运行测试pnpm test - 构建pnpm build ## 代码风格 - 使用 ESLint Prettier - import 排序内置 → 第三方 → 本地 - 每个模块一个目录包含 controller/service/dto/entity ## 约束 - 不要使用 any 类型 - 所有数据库操作必须在 Service 层 - Controller 只做参数校验和响应格式化6. 权限模式选择根据场景选择合适的安全级别模式命令适用场景只读--sandbox read-only --ask-for-approval never代码审查、分析自动编辑--sandbox workspace-write --ask-for-approval untrusted日常开发全自动--dangerously-bypass-approvals-and-sandbox信任环境下的批量任务7. 通过 API 使用免费账户没有订阅也能用# 切换为 API 认证方式codex--configpreferred_auth_methodapikey# 切换回 ChatGPT 订阅认证codex--configpreferred_auth_methodchatgpt8. 尝试开放式提示不仅限于具体编码任务codex审查 src/services/ 下的所有文件找出潜在的安全漏洞codex为这个项目的 README 补充 API 文档codex头脑风暴这个模块有哪些性能优化空间codex清理 dead code找出未使用的导出高级篇9. 配置 MCP 服务器在 Codex 中使用 MCP 扩展能力// codex 配置文件{mcpServers:{context7:{command:npx,args:[-y,upstash/context7-mcp]}}}10. 模型选择策略Codex 支持多种模型模型适用场景命令gpt-5-codex代码专用默认最强-m gpt-5-codexgpt-5通用任务-m gpt-5o3长链推理-m o3o4-mini轻量快速-m o4-mini# 高推理 高级模型codex-mgpt-5-codex-cmodel_reasoning_efforthigh# 快速简单任务codex-mo4-mini-cmodel_reasoning_effortlow11. 自定义工作方式告诉 Codex 使用特定提交规范、遵循模板或避免某些命令codex修复这个 bug但是 - 不要使用 git force push - commit message 使用 fix: 前缀 - 修改后运行 pnpm test 确认通过 - 不要修改 package.json12. 启用搜索功能让 Codex 联网查找最新文档和解决方案codex--search使用最新版 Prisma 5.x 的语法重写这个查询三、通用最佳实践1. Prompt 工程核心原则两个工具通用的提示技巧 一句话总结 写提示时要「明确上下文 给出验证方法 合理拆解任务 灵活定制」原则Claude CodeCodex明确上下文CLAUDE.md 对话开头AGENTS.md 提示内给出验证方法“运行 pnpm test 确认”“通过现有测试套件”合理拆解分步对话拆分多次调用灵活定制Hooks CommandsConfig Flags2. 工作循环认知两个工具的核心工作循环是相同的┌─────────────────────────────────────────┐ │ 1. 收集上下文看代码、文件、错误信息 │ │ ↓ │ │ 2. 采取行动编辑文件、运行命令、搜索 │ │ ↓ │ │ 3. 验证结果运行测试、检查输出 │ │ ↓ │ │ 4. 循环直到完成 │ └─────────────────────────────────────────┘3. 省 Token 的通用技巧技巧效果适用工具写好记忆文件减少重复解释项目背景两者先 Plan 再执行减少无效生成和回滚两者及时清理上下文避免长对话 Token 爆炸Claude Code任务描述一次到位减少 retry 和追问Codex用只读模式做分析避免不必要的写操作两者4. 选择建议场景推荐原因需要深度理解大项目Claude Code项目级上下文理解最强批量自动化任务Codex异步执行 云端沙盒需要联网搜索资料Codex内置搜索功能代码审查Claude CodeMCP 自定义 Agent调试复杂 bug两者皆可Claude Code 更擅长推理CI/CD 集成两者皆可都支持非交互模式四、速查对照表功能Claude CodeCodex记忆文件CLAUDE.mdAGENTS.md跳过确认--dangerously-skip-permissions--dangerously-bypass-approvals-and-sandbox初始化配置手动创建/init深度思考think/think harder-c model_reasoning_efforthigh模型切换/model--model/-m非交互模式claude -p ...codex ...自定义命令.claude/commands/*.mdAGENTS.md 内定义外部服务MCP 协议MCP 内置搜索Hook 系统.claude/settings.jsonhooks暂无原生支持上下文压缩/compact自动管理会话恢复--resume线程持久化五、总结Claude Code像一个经验丰富的高级工程师 —— 理解全局、善于重构、注重架构。Codex像一个高效的执行团队 —— 批量处理、异步运行、自动验收。两者并不冲突最高效的方式是组合使用复杂设计 → Claude Code /plan ↓ 执行重构 → Claude Code /goal 或 Codex 批量任务 ↓ 代码审查 → Claude Code Agent ↓ 批量修复 → Codex 异步并行核心心法上下文为王—— 写好 CLAUDE.md / AGENTS.md分步为安—— 拆分任务逐步验证先理解后动手—— 让 AI 先读代码再改代码验证闭环—— 每次改动都要有测试确认AI 不会淘汰程序员但不会用 AI 的除外。会用 AI 的程序员才有未来