Claude 官方AI编程教程：最低级设计和最高级的技巧

推荐语

深入探索AI编程的底层逻辑和高级技巧，Claude Code官方教程带你领略AI编程的魅力。

核心内容：
1. Claude Code的原始模型能力和AI编程最佳实践
2. CLAUDE.md文件的创建和优化项目环境理解
3. Claude Code与GitHub的深度整合和AI编程工作流

杨芳贤

53A创始人/腾讯云(TVP)最具价值专家

来自Claude 官方的这个《Claude Code: Best practices for Agentic coding》文章开篇就是王炸。

Claude秉承了一贯的特色，从来不玩那些虚的！

明明白白告知Claude Code这个AI命令行工具使用了最基本最low-level最无主见的最原始模型能力。

然后就是直入主题：AI编程最有效的提示和技巧。

虽然是讲Claude Code，但是对于所有AI编程的思考和思想都是一致的，摘录其中部分我认为比较有用比较普适的内容。

CLAUDE.md 是 Claude 在开始对话时自动提取到上下文中的特殊文件，这个类似于Cursor Rule。

类似于昨天讲的Cursor Rules 原理和最佳实践

CLAUDE.md 文件没有必需的格式。官方建议保持它们简洁易读。例如：

# Bash commands
- npm run build: Build the project
- npm run typecheck: Run the typechecker

# Code style
- Use ES modules (import/export) syntax, not CommonJS (require)
- Destructure imports when possible (eg. import { foo } from 'bar')

# Workflow
- Be sure to typecheck when you’re done making a series of code changes
- Prefer running single tests, and not the whole test suite, for performance

上面就是一个 Claude.md 文件的模板, 用来帮助 Claude 更好地理解项目环境、代码风格和工作习惯, 从而在对话中提供更准确、更有上下文感知的建议。

当然它并不是固定的，可以根据项目实际情况进行修改和拓展。

具体应该填哪些内容呢？Claude官方给出了如下的方向。

官方最推荐的做法是：把 CLAUDE.md 放在代码仓库根目录, 并提交到 Git。这样Claude 每次运行时都能自动加载你设定的上下文, 同时团队成员也能共享这份配置。

接下来是一个Claude Code 与 GitHub 的深度整合，主要通过 ‎⁠gh CLI⁠ 实现。

可以对 Claude 说：“请为这个更改创建一个 PR，并写一个合适的提交信息。”

Claude 会读取 diff，生成 commit message，推送代码，并通过 ‎⁠gh⁠ 创建 PR。

GH CLI详细的安装操作请点击这里：gh安装和使用

下面是重头戏，Claude的AI编程工作流。

1. 通览项目

让 Claude 读取相关文件、图像或 URL，提供通用指针（“读取处理日志记录的文件”）或特定文件名（“读取 logging.py”），但明确告诉它暂时不要编写任何代码。

换句话说：你可以让Claude 先了解问题背景, 比如让它读取代码、图片或网页； 可以用模糊描述, 也可以直接给文件名。

但重点是：你要明确告诉 Claude“现在不要写代码”, 先让它只做阅读和理解。

这是 Claude Code 推荐的第一步, 用来建立上下文、避免它过早进入编码阶段。 尤其在处理复杂问题时, 这种做法能提高 Claude 的准确性和效率。

2. 深度思考

这个文章官方主要针对Claude Code来讲的，而且很绕。

其实说白了，就是让你在正式入编写前代码前，来制定和评估各种方案,分析利弊, 最后给出一份详细的执行计划。并且在这一步就开始建立git版本控制检查点。

3. 方案制定

让Claude 在代码中实现其解决方案。这也是要求它在实现解决方案的各个部分时 显式验证其解决方案的合理性的好地方。

4. 测试驱动开发

通过单元、集成或端到端测试，测试驱动开发 (TDD) 通过代理编码变得更加强大。

很不巧，本人正好也写过这种文章：

营销号都在教你写贪吃蛇2048,我却要和你聊一聊真正的编程实践,在Cursor中践行TDD

这是 Anthropic 官方非常推荐的一种工作方式, 适用于可以通过测试轻松验证 的更改 (如单元测试、集成测试、端到端测试) 。它的流程如下：

1.让 Claude 根据预期输入/输出编写测试 ，明确告诉 Claude：你正在进行测试驱动开发 (TDD)， 这样 Claude 就不会提前写出“假实现”或“模拟代码”, 即使功能还不存在也不会乱写。

2.运行测试并确认失败，告诉 Claude 运行测试, 并确认它们失败，明确指示它：此阶段不要写任何实现代码，样可以确保测试是有效的, 且尚未被实现代码“误通过”。

3.编写实现代码, 直到测试通过 告诉 Claude：现在写实现代码, 但不要修改测试。

4.Claude 会开始迭代开发：写代码 ＞运行测试-修复错误＞再次测试。

一般需要几轮迭代, 直到所有测试通过。

如果你对测试逻辑满意, 可以让 Claude把测试代码提交到版本库。

Claude 在有明确目标 (如测试用例) 时表现最佳。通过测试驱动开发, 你能让 Claude更稳定地输出正确代码。这个流程尤其适合那些“改动小但要确保正确性”的任务, 比如修 bug、加小功能、重构等。

优化工作流程

最后，官方给出了使用 Claude Code 时，通过明确指令、合理利用图像、文件和 URL、及时纠正方向以及使用清单和暂存区等方式。

具体来说，越具体的指令越能帮助 Claude 精准理解任务；提供截图、文件路径或链接能增强上下文理解

通过这些方法，用户不仅能更高效地完成任务，还能更好地引导 Claude 成为真正的协作伙伴。

双语对照翻译全文：VibeCode