Claude Code 完全使用指南

技能概述

Claude Code Guide 是一份全面的配置与使用参考，帮助开发者掌握 Anthropic 官方 AI 编程代理的完整功能，包括项目配置模板、高效提示策略和调试技巧。

适用场景

1. 新项目初始化：当你启动一个新项目时，可以通过创建 CLAUDE.md 文件快速为 AI 代理设定项目规范、命令习惯和代码风格，避免重复解释项目上下文。

2. 处理复杂任务：当面对大型代码库或复杂需求时，本指南提供的"Thinking"关键词和提示策略能让代理进行更深层次的推理，输出更高质量的解决方案。

3. 调试与优化：当代理行为异常或陷入循环时，提供的调试三步法（清除上下文、明确指令、检查日志）能快速定位问题。

核心功能

1. CLAUDE.md 配置模板：提供标准化的项目配置文件模板，支持定义项目命令、代码风格、工作流程等关键信息，让代理快速理解项目规范。

2. Thinking 关键词触发：内置 4 个深度推理触发词（"Think step-by-step"、"Analyze the root cause"、"Plan before executing"、"Verify your assumptions"），可激活代理的分析能力。

3. 最佳实践集合：汇总上下文管理、迭代开发、反馈循环等实战经验，帮助用户更高效地与 AI 协作。

常见问题

Claude Code 是什么？如何开始使用？

Claude Code 是 Anthropic 官方提供的命令行 AI 编程代理，可以直接在终端中操作代码、运行命令、管理文件。开始使用只需安装 Claude Code CLI，然后在项目根目录创建 CLAUDE.md 文件配置项目规则即可。

CLAUDE.md 文件应该放在哪里？包含哪些内容？

CLAUDE.md 应放在项目根目录，与 README.md 同级。典型内容包括：项目运行命令（dev/test/build）、代码风格规范（语言偏好、框架选择）、工作流程约定（先读文档再修改、改后测试验证）等。模板可参考本指南提供的通用模板。

Claude Code 卡住或行为异常时如何调试？

调试三步法：1) 清除上下文——开启新会话或让代理"忘记之前的指令"；2) 明确指令——对文件路径、文件名、期望结果给出超具体的描述；3) 检查日志——让代理"查看日志"或"以详细输出运行命令"。多数情况可通过明确指令解决。