这些技巧来自社区、实际项目经验和开发者分享。它们不在官方文档的显眼位置,但使用后能明显提升效率。
技巧 1:用 --print 做批处理脚本
--print 参数让 Claude Code 以非交互模式运行,输出结果后退出。完美用于脚本化:
bash
# 批量为所有函数生成文档注释
for file in src/utils/*.ts; do
claude --print "为 $file 里的所有 public 函数生成 JSDoc 注释。
只输出更新后的文件内容,不要解释。" > "$file.tmp"
mv "$file.tmp" "$file"
done
# 批量翻译错误消息
claude --print "把 src/errors.ts 里所有英文错误消息翻译成中文,
保持变量名不变,只改字符串内容。" > src/errors.ts技巧 2:临时覆盖 CLAUDE.md 规则
有时需要临时打破 CLAUDE.md 里的规则(比如在调试时临时允许 console.log):
忽略 CLAUDE.md 里关于不使用 console.log 的规定,
在这个文件里添加详细的调试日志,帮我找出这个问题。
完成后我会手动清理这些 log。
Claude Code 会遵从显式指令覆盖文件规则。
技巧 3:给 Claude Code 一个"草稿本"
复杂任务时,让 Claude Code 先在临时文件里写想法,而不是直接修改代码:
在 .claude/scratchpad.md 里先写你的实现计划。
包含:架构图(ASCII)、每个文件的改动摘要、潜在风险。
写完后告诉我,我会 review 后再决定是否执行。
技巧 4:引用 GitHub Issue 作为上下文
bash
# 先用 GitHub CLI 获取 Issue 详情
gh issue view 234 --json title,body,comments > issue.json
# 然后传给 Claude Code
claude "读取 issue.json,实现这个 Issue 描述的功能。
参考所有评论里的讨论,特别是 @tech-lead 的建议。"技巧 5:让 Claude Code 给自己出题(自我测试)
写完这个功能后,列出 5 个我可以问你来验证实现是否正确的问题。
包括边界情况、错误场景和性能考量。
这能帮你发现 Claude Code 可能没有充分测试的边界情况。
技巧 6:分层的 CLAUDE.md(全局 + 项目 + 目录)
CLAUDE.md 支持分层配置:
~/.claude/CLAUDE.md # 全局规则(所有项目都应用)
/project/CLAUDE.md # 项目规则
/project/src/CLAUDE.md # src 目录的特定规则
/project/src/api/CLAUDE.md # API 目录的特定规则
用法:
markdown
# ~/.claude/CLAUDE.md(全局)
## 通用规范
- 所有代码注释用中文
- 错误消息对用户友好,对开发者有足够信息
- 不要在代码里放密钥
# /project/src/api/CLAUDE.md(API 特定)
## API 层规则
- 所有端点必须有认证检查
- 返回格式:{ success: boolean, data?: any, error?: string }
- 限流:敏感操作每分钟最多 10 次Claude Code 会合并所有层级的规则,更具体的层级优先。
技巧 7:用 "thinking out loud" 模式暴露推理
对于架构决策,要求 Claude Code 显示推理过程:
在回答之前,先列出你考虑的所有可能方案(至少 3 个),
以及你选择推荐方案的原因。
问题:我们的 WebSocket 服务在高并发时出现连接断开,
应该怎么优化?
这让你能发现 Claude Code 是否考虑了你认为重要的因素。
技巧 8:文件修改的"白名单"模式
当你只想让 Claude Code 改特定文件,其他文件只读:
只允许修改以下文件:
- src/api/users.ts
- tests/api/users.test.ts
可以读取其他文件了解上下文,但不要修改它们。
任务:为用户 API 添加分页功能。
技巧 9:用实验性 Flag 测试新功能
bash
# 开启 Agent Teams(实验性)
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude
# 开启 1M Token 上下文(Beta)
# 在 Claude.ai 账号设置里开启跟踪实验性功能:
bash
claude --version # 查看当前版本
# 关注 code.claude.com/docs/en/changelog 了解新的实验性标志技巧 10:Session 之间的"记忆桥"
Claude Code 每个 Session 都是独立的。用文件做 Session 之间的记忆桥:
bash
# Session 1 结束前
claude "把这次 Session 的关键决定、还未完成的 TODO
和下次需要继续的上下文写入 .claude/session-handoff.md"
# Session 2 开始时
claude "读取 .claude/session-handoff.md,了解上次 Session
留下的上下文,然后继续未完成的工作。"配合 Session Start Hook 自动化:
yaml
# .claude/hooks/session-start.yaml
hooks:
- name: "加载上次 Session 上下文"
trigger: session_start
command: |
if [ -f .claude/session-handoff.md ]; then
echo "=== 上次 Session 遗留上下文 ==="
cat .claude/session-handoff.md
fi
on_error: ignore来源:社区经验汇总 | r/ClaudeAI | incident.io 案例研究 | Boris Cherny 工作流 | 整理:ClaudeEagle