# Claude Code Guide

> 为 Claude Code（智能体编码工具）的配置和使用提供全面参考，充分发挥其潜力。本技能综合最佳实践、配置模板和高级使用模式。当用户要求配置 Claude Code、使用 Claude Code 最佳实践、Claude Code 高级功能时使用。

- Skill: `kscz0000/claude-code-guide` (Agent Skill)
- Install (CLI): `npx skillmds@latest add kscz0000/claude-code-guide`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kscz0000/claude-code-guide/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: kscz0000 (https://skillmd.com/u/kscz0000)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/kscz0000/claude-code-guide

---


# Claude Code 指南

## 目的

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

## 配置（`CLAUDE.md`）

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

### 模板（通用）

```markdown
# 项目指南

## 命令

- 运行应用：`npm run dev`
- 测试：`npm test`
- 构建：`npm run build`

## 代码风格

- 所有新代码使用 TypeScript。
- React 使用函数组件和 Hooks。
- 样式使用 Tailwind CSS。
- 错误处理使用提前返回。

## 工作流程

- 先阅读 `README.md` 了解项目上下文。
- 编辑前先读取文件内容。
- 编辑后运行测试验证。
```

## 高级功能

### 思考关键词

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

- "逐步思考"
- "分析根本原因"
- "执行前先规划"
- "验证你的假设"

### 调试

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

1. **清除上下文**：开始新会话，或要求智能体"忘记之前的指令"（如果混乱）。
2. **明确指令**：对路径、文件名和预期结果要极其具体。
3. **日志**：要求智能体"检查日志"或"以详细输出模式运行命令"。

## 最佳实践

1. **小上下文**：不要把整个代码库塞进上下文。先用 `grep` 或 `find` 定位相关文件。
2. **迭代开发**：要求小改动，验证后再继续。
3. **反馈循环**：如果智能体犯错，立即纠正并要求它"记录教训"到记忆中（如果支持）或 `CLAUDE.md`。

## 参考

基于 [Claude Code Guide by zebbern](https://github.com/zebbern/claude-code-guide)。

## 何时使用
本技能适用于执行概述中描述的工作流程或操作。

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