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

终端级 AI 编程工具已成为开发者的核心生产力。本文系统整理 Claude Code 和 OpenAI Codex 的实战技巧，帮你少踩坑、省 Token、提效率。

一、Claude Code 使用技巧#

基础篇#

1. 把需求说具体#

AI 上下文有限制，代码量太长可能输出不全甚至被截断。

1
❌ 差：帮我写一个用户管理系统
2
✅ 好：帮我写一个用户注册接口，使用 Express + TypeScript，
3
       包含邮箱验证、密码哈希（bcrypt）、JWT 返回，
4
       错误统一用 ApiError 类抛出

2. 先理解项目再开动#

在修改代码之前，先让 Claude 理解你的代码：

1
> 阅读这个项目的代码结构，理解各模块的职责和依赖关系
2
> 这个项目的数据流是怎样的？从请求到响应经过哪些层？
3
> src/services/ 目录下的服务之间有什么依赖关系？

3. 分步执行复杂任务#

每一步完成后你都可以先 review/测试，再让 AI 执行下一步：

1
# 第一步
2
> 先帮我分析当前支付模块的问题
3

4
# 确认后
5
> 好的，按照你的分析，先重构 PaymentService 类
6

7
# 验证后
8
> 通过了，接下来处理 OrderService 的适配

4. 善用深度思考模式#

在 Claude Code 中使用 “think” 关键词激活深度思考：

1
> think about how to refactor this authentication module
2
> think harder about the race condition in this code
3
> ultrathink about the architecture for this distributed system

级别	关键词	适用场景
普通思考	`think`	一般分析
深度思考	`think harder`	复杂逻辑
超级思考	`ultrathink`	架构级决策

进阶篇#

5. 配置 CLAUDE.md 记忆文件#

CLAUDE.md 是 Claude Code 自动读取的记忆文件，类似 Cursor 的 rules，但更强大：

1
## 项目概述
2
这是一个基于 Next.js 14 的电商平台，使用 App Router。
3

4
## 技术栈
5
- Frontend: React 18 + TypeScript + Tailwind CSS
6
- Backend: Next.js API Routes + Prisma + PostgreSQL
7
- Auth: NextAuth.js v5
8

9
## 代码规范
10
- 使用 Conventional Commits
11
- 组件使用 PascalCase，工具函数使用 camelCase
12
- 所有 API 返回统一格式：`{ success, data, error }`
13

14
## 重要约束
15
- 不要修改 /src/core/ 下的文件
16
- 数据库迁移必须向后兼容
17
- 所有新接口必须有单元测试

可以在多个位置放置 CLAUDE.md 文件，Claude Code 会递归读取：

1
~/CLAUDE.md                    # 全局（所有项目生效）
2
./CLAUDE.md                    # 项目根目录
3
./src/CLAUDE.md                # 子目录（更具体的规则）
4
./src/components/CLAUDE.md     # 更深层级

6. 跳过权限确认（Bypass Mode）#

每次都要点确认太烦了：

1
# 单次启动
2
claude --dangerously-skip-permissions
3

4
# 设置别名（推荐）
5
alias cc='claude --dangerously-skip-permissions'
6
echo "alias cc='claude --dangerously-skip-permissions'" >> ~/.zshrc

⚠️ 注意：这相当于 Cursor 的老 YOLO 模式。理论上有风险，但实际使用中极少出问题。

7. 模型切换#

Claude Code 支持模型灵活切换：

1
/model              # 查看当前模型
2
/model opus         # 切换到 Claude Opus（Max 用户）
3
/model sonnet       # 切换回 Claude Sonnet（推荐）

💡 强烈推荐 Sonnet：体验与 Opus 差别不大，但计费仅为 1/5。

8. 对话式 Git 操作#

不用记繁琐的 Git 命令：

1
> 帮我把这次改动提交，用 conventional commit 格式
2
> 创建一个新分支 feature/payment-refactor，把最近3次提交 cherry-pick 过去
3
> 帮我 rebase 到 main，有冲突的话保留我的改动

9. 非交互模式（单次执行）#

适合脚本化和 CI/CD 集成：

1
# 单次执行后退出
2
claude -p "列出 src/ 下所有超过 200 行的 TypeScript 文件"
3

4
# 管道模式
5
cat error.log | claude -p "分析这个错误日志，找出根因"
6

7
# 结合其他工具
8
git diff HEAD~3 | claude -p "总结这3次提交的改动，写成 changelog"

高级篇#

10. 配置 Hooks（生命周期钩子）#

Hooks 是在特定事件中自动运行的 shell 命令：

1
{
2
  "hooks": {
3
    "PostToolUse": [
4
      {
5
        "matcher": "Write|Edit",
6
        "hooks": [
7
          {
8
            "type": "command",
9
            "command": "npx prettier --write $CLAUDE_FILE_PATH"
10
          }
11
        ]
12
      }
13
    ],
14
    "Stop": [
15
      {
16
        "matcher": "",
17
        "hooks": [
18
          {
19
            "type": "command",
20
            "command": "say \"job's done!\""
21
          }
22
        ]
23
      }
24
    ],
25
    "Notification": [
26
      {
27
        "matcher": "",
28
        "hooks": [
29
          {
30
            "type": "command",
31
            "command": "terminal-notifier -message 'Claude needs input' -title 'Claude Code'"
32
          }
33
        ]
34
      }
35
    ]
36
  }
37
}

实用 Hook 场景：

Hook 事件	用途示例
`PreToolUse`	拦截敏感文件操作（`.env`、secrets）
`PostToolUse` (Write)	自动格式化、自动运行测试
`Stop`	任务完成后系统通知
`Notification`	Claude 需要输入时弹窗提醒

11. 自定义命令（Slash Commands）#

创建项目级快捷命令：

1
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
2
description: Create a conventional commit from current changes
3

4
分析当前 git diff，写一个 Conventional Commit：
5
- subject <= 72 chars
6
- 简洁的 body 描述为什么改
7
- Stage 相关文件并提交

1
description: Generate a React component with tests
2

3
创建一个 React 组件：
4
- 使用 TypeScript + Tailwind CSS
5
- 包含 Props 接口定义
6
- 生成对应的 .test.tsx 文件
7
- 导出到 index.ts barrel file

使用方式：

1
/commit
2
/frontend/component UserProfile

12. 配置项目级 Agent#

定义具有特定角色的智能体：

1
# Code Reviewer Agent
2

3
## 角色
4
你是一个严格的代码审查员。
5

6
## 工具限制
7
仅允许：Read, Search, Grep
8
禁止：Write, Edit, Bash
9

10
## 审查标准
11
- 安全漏洞（SQL注入、XSS、SSRF）
12
- 性能问题（N+1查询、内存泄漏）
13
- 类型安全（any 的使用）
14
- 错误处理（未捕获的 Promise）

13. MCP 连接外部服务#

使 Claude 能连接 Jira、GitHub、Notion、Sentry 等：

1
# 连接后可以直接说：
2
> 实现 JIRA-ENG-4521 中描述的功能
3
> 查看 Sentry 上最近的报错，分析根因
4
> 把这个方案同步到 Notion 的技术文档中

14. 安全防护 Hook#

防止 AI 误操作敏感文件：

1
{
2
  "hooks": {
3
    "PreToolUse": [
4
      {
5
        "matcher": "Write|Edit",
6
        "hooks": [
7
          {
8
            "type": "command",
9
            "command": "python3 - <<'PY'\nimport json,sys\np=json.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"
10
          }
11
        ]
12
      }
13
    ]
14
  }
15
}

15. 状态栏自定义#

在终端显示项目状态信息：

1
{
2
  "statusLine": {
3
    "type": "command",
4
    "command": "~/.claude/statusline.sh"
5
  }
6
}

二、Codex 使用技巧#

基础篇#

1. 提供清晰的代码上下文#

在提示中加入函数名、类名或代码片段，帮助 Codex 快速定位：

1
codex "在 UserService.createUser() 方法中添加邮箱格式验证，
2
       验证失败抛出 ValidationError"

2. 设置高推理等级#

默认推理等级为中等，复杂任务建议提高：

1
# 单次使用
2
codex --model gpt-5-codex -c model_reasoning_effort="high"
3

4
# 别名（推荐）
5
alias codex='codex -m gpt-5-codex -c model_reasoning_effort="high" -c model_reasoning_summary_format=experimental --search --dangerously-bypass-approvals-and-sandbox'

3. 拆分大型任务#

将复杂任务分解为小步骤，让 Codex 更容易处理和测试：

1
# 不要这样
2
codex "重构整个项目的认证系统"
3

4
# 这样做
5
codex "第一步：分析当前 auth 模块的依赖关系"
6
codex "第二步：将 JWT 逻辑从 Controller 抽到 AuthService"
7
codex "第三步：添加 refresh token 机制"

4. 用于调试#

把详细日志或错误堆栈粘贴进去，让 Codex 并行分析：

1
codex "分析以下错误堆栈，找出根因并修复：
2
$(cat /tmp/error.log)"

进阶篇#

5. 初始化 AGENTS.md#

类似 Claude Code 的 CLAUDE.md，为 Codex 提供项目上下文：

1
codex /init    # 自动生成 AGENTS.md

AGENTS.md 示例：

1
## 项目信息
2
- 语言：TypeScript
3
- 框架：NestJS + Prisma
4
- 测试：Jest + Supertest
5

6
## 构建命令
7
- 安装依赖：pnpm install
8
- 运行测试：pnpm test
9
- 构建：pnpm build
10

11
## 代码风格
12
- 使用 ESLint + Prettier
13
- import 排序：内置 → 第三方 → 本地
14
- 每个模块一个目录，包含 controller/service/dto/entity
15

16
## 约束
17
- 不要使用 any 类型
18
- 所有数据库操作必须在 Service 层
19
- Controller 只做参数校验和响应格式化

6. 权限模式选择#

根据场景选择合适的安全级别：

模式	命令	适用场景
只读	`--sandbox read-only --ask-for-approval never`	代码审查、分析
自动编辑	`--sandbox workspace-write --ask-for-approval untrusted`	日常开发
全自动	`--dangerously-bypass-approvals-and-sandbox`	信任环境下的批量任务

7. 通过 API 使用（免费账户）#

没有订阅也能用：

1
# 切换为 API 认证方式
2
codex --config preferred_auth_method="apikey"
3

4
# 切换回 ChatGPT 订阅认证
5
codex --config preferred_auth_method="chatgpt"

8. 尝试开放式提示#

不仅限于具体编码任务：

1
codex "审查 src/services/ 下的所有文件，找出潜在的安全漏洞"
2
codex "为这个项目的 README 补充 API 文档"
3
codex "头脑风暴：这个模块有哪些性能优化空间？"
4
codex "清理 dead code，找出未使用的导出"

高级篇#

9. 配置 MCP 服务器#

在 Codex 中使用 MCP 扩展能力：

1
// codex 配置文件
2
{
3
  "mcpServers": {
4
    "context7": {
5
      "command": "npx",
6
      "args": ["-y", "@upstash/context7-mcp"]
7
    }
8
  }
9
}

10. 模型选择策略#

Codex 支持多种模型：

模型	适用场景	命令
`gpt-5-codex`	代码专用（默认，最强）	`-m gpt-5-codex`
`gpt-5`	通用任务	`-m gpt-5`
`o3`	长链推理	`-m o3`
`o4-mini`	轻量快速	`-m o4-mini`

1
# 高推理 + 高级模型
2
codex -m gpt-5-codex -c model_reasoning_effort="high"
3

4
# 快速简单任务
5
codex -m o4-mini -c model_reasoning_effort="low"

11. 自定义工作方式#

告诉 Codex 使用特定提交规范、遵循模板或避免某些命令：

1
codex "修复这个 bug，但是：
2
- 不要使用 git force push
3
- commit message 使用 fix: 前缀
4
- 修改后运行 pnpm test 确认通过
5
- 不要修改 package.json"

12. 启用搜索功能#

让 Codex 联网查找最新文档和解决方案：

1
codex --search "使用最新版 Prisma 5.x 的语法重写这个查询"

三、通用最佳实践#

1. Prompt 工程核心原则#

两个工具通用的提示技巧：

1
📌 一句话总结：
2
写提示时要「明确上下文 + 给出验证方法 + 合理拆解任务 + 灵活定制」

原则	Claude Code	Codex
明确上下文	CLAUDE.md + 对话开头	AGENTS.md + 提示内
给出验证方法	”运行 pnpm test 确认"	"通过现有测试套件”
合理拆解	分步对话	拆分多次调用
灵活定制	Hooks + Commands	Config + Flags

2. 工作循环认知#

两个工具的核心工作循环是相同的：

1
┌─────────────────────────────────────────┐
2
│  1. 收集上下文（看代码、文件、错误信息）   │
3
│           ↓                              │
4
│  2. 采取行动（编辑文件、运行命令、搜索）   │
5
│           ↓                              │
6
│  3. 验证结果（运行测试、检查输出）         │
7
│           ↓                              │
8
│  4. 循环直到完成                          │
9
└─────────────────────────────────────────┘

3. 省 Token 的通用技巧#

技巧	效果	适用工具
写好记忆文件	减少重复解释项目背景	两者
先 Plan 再执行	减少无效生成和回滚	两者
及时清理上下文	避免长对话 Token 爆炸	Claude Code
任务描述一次到位	减少 retry 和追问	Codex
用只读模式做分析	避免不必要的写操作	两者

4. 选择建议#

场景	推荐	原因
需要深度理解大项目	Claude Code	项目级上下文理解最强
批量自动化任务	Codex	异步执行 + 云端沙盒
需要联网搜索资料	Codex	内置搜索功能
代码审查	Claude Code	MCP + 自定义 Agent
调试复杂 bug	两者皆可	Claude Code 更擅长推理
CI/CD 集成	两者皆可	都支持非交互模式

四、速查对照表#

功能	Claude Code	Codex
记忆文件	`CLAUDE.md`	`AGENTS.md`
跳过确认	`--dangerously-skip-permissions`	`--dangerously-bypass-approvals-and-sandbox`
初始化配置	手动创建	`/init`
深度思考	`think` / `think harder`	`-c model_reasoning_effort="high"`
模型切换	`/model`	`--model` / `-m`
非交互模式	`claude -p "..."`	`codex "..."`
自定义命令	`.claude/commands/*.md`	AGENTS.md 内定义
外部服务	MCP 协议	MCP + 内置搜索
Hook 系统	`.claude/settings.json` hooks	暂无原生支持
上下文压缩	`/compact`	自动管理
会话恢复	`--resume`	线程持久化

五、总结#

Claude Code 像一个经验丰富的高级工程师——理解全局、善于重构、注重架构。

Codex 像一个高效的执行团队——批量处理、异步运行、自动验收。

两者并不冲突，最高效的方式是组合使用：

1
复杂设计 → Claude Code /plan
2
         ↓
3
执行重构 → Claude Code /goal 或 Codex 批量任务
4
         ↓
5
代码审查 → Claude Code Agent
6
         ↓
7
批量修复 → Codex 异步并行

核心心法#

上下文为王——写好 CLAUDE.md / AGENTS.md
分步为安——拆分任务，逐步验证
先理解后动手——让 AI 先读代码再改代码
验证闭环——每次改动都要有测试确认

AI 不会淘汰程序员，但不会用 AI 的除外。会用 AI 的程序员才有未来！