---

name: claude-code-guide description: "提供配置和使用Claude Code（智能编程工具）的全面参考，充分发挥其潜力。本技能整合了最佳实践、配置模板和高级使用模式。" risk: unknown source: community date_added: "2026-02-27"

Claude Code 指南

用途

提供配置和使用Claude Code（智能编程工具）的全面参考，充分发挥其潜力。本技能整合了最佳实践、配置模板和高级使用模式。

配置（CLAUDE.md）

启动新项目时，在根目录创建 CLAUDE.md 文件来引导智能体。

模板（通用）

# 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.

高级功能

思维关键词

在提示中使用这些关键词来触发智能体的深度推理：

• "Think step-by-step"（逐步思考）
• "Analyze the root cause"（分析根本原因）
• "Plan before executing"（执行前先规划）
• "Verify your assumptions"（验证你的假设）

调试

如果智能体卡住或行为异常：

1. 清除上下文：开始新会话，或在智能体混乱时要求它"忘记之前的指令"。
2. 明确指令：对路径、文件名和期望结果要非常具体。
3. 日志：要求智能体"检查日志"或"使用详细输出运行命令"。

最佳实践

1. 小上下文：不要将整个代码库倒入上下文中。先使用 grep 或 find 定位相关文件。
2. 迭代开发：请求小的更改，验证后再继续。
3. 反馈循环：如果智能体犯了错误，立即纠正并要求它将"经验教训"添加到记忆（如果支持）或 CLAUDE.md 中。

参考

基于 Claude Code Guide by zebbern。

何时使用

当任务明确匹配上述概述中描述的工作流程或操作时，适用本技能。

局限性

• 仅在任务明确匹配上述描述的范围时使用本技能。
• 不要将输出视为特定环境验证、测试或专家审查的替代品。
• 如果缺少所需的输入、权限、安全边界或成功标准，请停下来寻求澄清。