← 返回Claude Code
Claude Code / 第 03 课

用 CLAUDE.md 保存项目约定

将构建命令、规范与任务背景放在代码附近。

开始之前

准备带 README 和已知测试命令的练习仓库。CLAUDE.md 用于提供上下文,不能代替权限控制。

1. 找出真正有用的信息

让 Claude 检查项目脚本、测试与现有写法,结合真实文件核实建议命令。约定应简短可审阅,不放密钥、令牌或整站复制的文档。

2. 创建并审阅 CLAUDE.md

在 Claude Code 中用 /init 辅助生成项目说明,再逐项审阅,只保留已确认的事实。仓库根目录 CLAUDE.md 可与团队共享;个人说明位于 ~/.claude/CLAUDE.md。局部规则放在相关代码附近。

markdown
# Project instructions
- Read README.md before changing build behavior.
- Follow the existing component patterns.
- Find the real test command in the project scripts.
- Explain behavior changes and report checks run.
- Never include secrets in generated examples.

3. 带着足够的背景继续工作

用 claude -c 继续当前目录最近的会话,或 claude -r 选择历史会话。上下文过长时用 /compact 压缩。另留一份包含决策、修改文件、验证与下一步的任务记录,压缩后的历史可能遗漏细节。

shell
claude -c
claude -r

练习与自检

YOUR TURN / 动手练习

用真实项目命令编写简短的 CLAUDE.md,新开会话后让 Claude 概述相关约定。

完成后,花一点时间检查:

阅读官方原始资料

CLI 操作已对照官方文档核查;API 示例通过模拟响应测试。未登录产品账户进行完整实机演示。

从一个问题开始