Claude Code 使用技巧与最佳实践

Claude Code 是一个用于智能体编程的命令行工具。
这篇文章涵盖了在各种代码库、语言和环境中使用 Claude Code 的有效技巧和窍门。

简介

我们最近发布了 Claude Code，一个用于智能体编程的命令行工具。
作为一个内部实验性项目，Claude Code 为 Anthropic 的工程师和研究人员提供了一种更原生的方式，将 Claude 集成到他们的编程工作流程中。

Claude Code 被有意设计为 low-level（低级别） 且 unopinionated（无特定偏好），提供接近原始模型的访问权限，而不强制使用特定的工作流程。
这种设计哲学创造了一个灵活、可定制、可脚本化且安全的强大工具。
但这种灵活性也带来学习曲线，尤其是对智能体编程新手而言。

这篇文章概述了已被证明有效的通用模式。
无论是 Anthropic 内部团队，还是在各种代码库、语言和环境中使用 Claude Code 的外部工程师，都可以从中受益。
请将这些建议视为 起点 —— 我们鼓励您进行实验，找到最适合您的方法！

📖 更详细的信息，请参见 claude.ai/code 的综合文档。

1. 自定义您的设置

Claude Code 会自动将上下文拉入提示中，但这会消耗时间和令牌。通过环境调优可以优化。

a. 创建 CLAUDE.md 文件

CLAUDE.md 是一个特殊文件，Claude 在开始对话时会自动加载。适合记录：

  • 常用 bash 命令
  • 核心文件和函数
  • 代码风格指南
  • 测试说明
  • 代码库规范（分支命名、合并/变基）
  • 开发环境设置（如 pyenv、编译器说明）
  • 项目特有的意外行为或警告
  • 其他需共享的信息

示例：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# Bash命令
- npm run build: 构建项目
- npm run typecheck: 运行类型检查器

# 代码风格
- 使用 ES 模块 (import/export)
- 尽可能使用解构导入

# 工作流程
- 每次更改后运行类型检查
- 优先运行单个测试，而非整个套件

文件放置位置：

  • 代码库根目录（推荐检入 git）
  • 父目录/子目录（适用于 monorepo）
  • 主目录（~/.claude/CLAUDE.md，全局生效）

运行 /init 时，Claude 会自动生成一个 CLAUDE.md 文件。

b. 调优 CLAUDE.md

  • CLAUDE.md 会成为 Claude 提示的一部分，需要不断调优
  • 使用 # 给 Claude 指令时，可直接写入 CLAUDE.md
  • 建议定期优化，强调“重要”或“必须”以提高遵循度

c. 管理允许工具列表

Claude Code 默认对可能修改系统的操作请求权限。
可通过以下方式管理：

  1. 会话提示选择 “始终允许”
  2. 使用 /permissions 命令
  3. 编辑 .claude/settings.json 或 ~/.claude.json
  4. 使用 --allowedTools CLI 标志

d. GitHub 集成

Claude 可通过 gh CLI 与 GitHub 交互（创建 PR、读取评论等）。
若未安装 gh，仍可使用 GitHub API 或 MCP。

2. 为 Claude 提供更多工具

Claude 可利用 shell 环境、MCP 和 REST API。

a. 与 bash 工具一起使用

  • Claude 继承 bash 环境
  • 需要明确告知自定义工具的用法（如 --help）
  • 在 CLAUDE.md 中记录常用工具

b. 与 MCP 一起使用

Claude Code 同时是 MCP 服务器和客户端。
配置方式：

  • 项目配置
  • 全局配置
  • .mcp.json（共享给团队成员）

调试：使用 --mcp-debug 启动。

c. 使用自定义斜杠命令

在 .claude/commands 内存放 Markdown 模板，可快速调用。
支持 $ARGUMENTS 参数替换。

示例：修复 GitHub issue

1
2

请分析并修复 GitHub 问题：$ARGUMENTS。
...

保存为 .claude/commands/fix-github-issue.md，即可通过 /project:fix-github-issue 1234 调用。

3. 尝试常见工作流程

Claude Code 不强制工作流，但有几种成功模式：

a. 探索 → 规划 → 编码 → 提交

b. 测试驱动开发（TDD）

c. 代码 + 截图结果 → 迭代

d. 安全 YOLO 模式（--dangerously-skip-permissions）

e. 代码库问答

f. 使用 git 交互

g. 使用 GitHub 交互

h. 处理 Jupyter 笔记本

4. 优化您的工作流程

建议：

  • 指令具体化（减少歧义）
  • 给 Claude 提供图像（UI/调试）
  • 指定文件（快速定位资源）
  • 提供网址（自动获取文档）
  • 经常修正方向（使用 Escape、撤销、/clear）
  • 检查清单与草稿板（适合大任务）
  • 向 Claude 传递数据（复制粘贴、管道输入、文件/URL）

5. 使用无头模式自动化基础设施

无头模式（-p）可用于 CI、预提交钩子、自动化脚本。
支持 --output-format stream-json。

a. 问题分类

b. 代码检查

6. 多 Claude 协作

可同时运行多个 Claude 实例：

  • 一个编写代码，另一个验证
  • 多个 git checkout / 工作树并行开发
  • 使用无头模式集成到脚本或管道

致谢

作者：Boris Cherny
特别感谢：Daisy Hollman、Ashwin Bhat、Cat Wu、Sid Bidasaria、Cal Rueb、Nodir Turakulov、Barry Zhang、Drew Hodun，以及其他 Anthropic 工程师的实践经验与见解。