Claude Code Guide

Claude Code 指南

目的

提供一份全面的参考，帮助你充分配置和使用 Claude Code（Agent 编码工具），发挥其全部潜力。本技能综合了最佳实践、配置模板和高级用法模式。

配置（CLAUDE.md）

开始一个新项目时，在根目录创建 CLAUDE.md 文件，以指导 Agent。

模板（通用）

# Project Guidelines

## Commands

- Run app: `npm run dev`
- Test: `npm test`
- Build: `npm run build`

## Code Style

- Use TypeScript for all new code.
- Functional components with Hooks for React.
- Tailwind CSS for styling.
- Early returns for error handling.

## Workflow

- Read `README.md` first to understand project context.
- Before editing, read the file content.
- After editing, run tests to verify.

高级功能

思考关键词

在提示词中使用这些关键词，可触发 Agent 进行更深入的推理：

• “逐步思考”
• “分析根本原因”
• “先规划再执行”
• “验证你的假设”

调试

如果 Agent 卡住或行为异常：

1. 清空上下文：开启新会话，或在 Agent 困惑时让它“忘记之前的指令”。
2. 明确指令：对路径、文件名和期望结果给出极其具体的说明。
3. 日志：让 Agent “检查日志”或“以详细输出模式运行该命令”。

最佳实践

1. 上下文要小：不要将整个代码库都塞进上下文。先用 grep 或 find 定位相关文件。
2. 迭代开发：先要求做小的修改，验证后再继续。
3. 反馈闭环：如果 Agent 出错，立即纠正，并让它“添加一条经验教训”到其记忆（如果支持）或 CLAUDE.md 中。

参考

基于 Claude Code Guide by zebbern。