281 lines
5.1 KiB
Markdown
Executable File
281 lines
5.1 KiB
Markdown
Executable File
# Claude Code 使用技巧与最佳实践
|
||
|
||
> 全面指南：从入门到精通
|
||
>
|
||
> 归档：2026-04-23
|
||
|
||
---
|
||
|
||
## 📊 核心资源
|
||
|
||
| 项目 | Stars | 用途 |
|
||
|------|-------|------|
|
||
| **claude-code-best-practice** | ⭐ 47,397 | 最佳实践百科 |
|
||
| **ClaudeForge** | ⭐ 353 | CLAUDE.md 自动生成工具 |
|
||
| **awesome-claude-md** | ⭐ 242 | 优秀 CLAUDE.md 集合 |
|
||
| **claude-md-templates** | ⭐ 156 | CLAUDE.md 模板 |
|
||
|
||
---
|
||
|
||
## 🚀 安装与配置
|
||
|
||
### 一键安装
|
||
```bash
|
||
curl -fsSL https://claude.ai/install.sh | bash
|
||
```
|
||
|
||
### 快速验证
|
||
```bash
|
||
claude --version
|
||
claude doctor
|
||
```
|
||
|
||
### 选择模型
|
||
```bash
|
||
/model claude-sonnet-4-20260620
|
||
```
|
||
|
||
---
|
||
|
||
## 💡 核心使用技巧
|
||
|
||
### 1. 编写优秀的 CLAUDE.md
|
||
|
||
**CLAUDE.md 是提升 Claude Code 效果的最重要因素！**
|
||
|
||
**结构建议**：
|
||
```markdown
|
||
# 项目名称
|
||
|
||
## 概述
|
||
简短描述项目做什么。
|
||
|
||
## 技术栈
|
||
- 语言/框架/工具
|
||
|
||
## 项目结构
|
||
```
|
||
src/
|
||
├── components/
|
||
├── utils/
|
||
└── types/
|
||
```
|
||
|
||
## 开发规范
|
||
- 代码风格
|
||
- 命名约定
|
||
- 测试要求
|
||
|
||
## 常用命令
|
||
- `npm run dev` - 开发服务器
|
||
- `npm test` - 运行测试
|
||
```
|
||
|
||
### 2. 使用 ClaudeForge 自动生成
|
||
|
||
```bash
|
||
# 安装 ClaudeForge
|
||
curl -fsSL https://raw.githubusercontent.com/alirezarezvani/ClaudeForge/main/install.sh | bash
|
||
|
||
# 重启 Claude Code 后运行
|
||
/enhance-claude-md
|
||
```
|
||
|
||
**功能**：
|
||
- 自动扫描项目结构
|
||
- 检测技术栈
|
||
- 生成高质量 CLAUDE.md
|
||
- 质量评分 (0-100)
|
||
- 后台自动维护
|
||
|
||
### 3. 参考优秀案例
|
||
|
||
查看 [awesome-claude-md](https://josix.github.io/awesome-claude-md/) 获取真实项目的优秀示例。
|
||
|
||
---
|
||
|
||
## 🎯 高效工作流
|
||
|
||
### 日常开发
|
||
|
||
```bash
|
||
# 1. 启动会话
|
||
cd project && claude
|
||
|
||
# 2. 描述任务
|
||
帮我实现用户认证功能，包括登录、注册和 JWT
|
||
|
||
# 3. 代码审查
|
||
/review
|
||
|
||
# 4. 测试
|
||
运行测试并修复失败的用例
|
||
|
||
# 5. 提交
|
||
git add . && git commit -m "feat: 添加用户认证"
|
||
```
|
||
|
||
### 大型重构
|
||
|
||
```bash
|
||
# 使用 batch 命令
|
||
/batch migrate src/ from JavaScript to TypeScript
|
||
|
||
# 自动分解任务 → 并行执行 → 创建 PR
|
||
```
|
||
|
||
### 调试模式
|
||
|
||
```bash
|
||
# 启用调试
|
||
/debug
|
||
|
||
# 或者使用调试技能
|
||
/debug 分析这个错误：TypeError: Cannot read property 'x' of undefined
|
||
```
|
||
|
||
---
|
||
|
||
## 🔧 关键命令速查
|
||
|
||
| 命令 | 用途 |
|
||
|------|------|
|
||
| `/compact` | 压缩上下文（节省 token） |
|
||
| `/context` | 查看上下文使用 |
|
||
| `/cost` | 查看费用统计 |
|
||
| `/agents` | 管理子代理 |
|
||
| `/batch` | 大规模并行修改 |
|
||
| `/diff` | 查看变更 |
|
||
| `/undo` | 撤销修改 |
|
||
| `/copy` | 复制回复 |
|
||
| `/model` | 切换模型 |
|
||
| `/config` | 设置面板 |
|
||
|
||
---
|
||
|
||
## 🤖 子代理最佳实践
|
||
|
||
### 何时使用子代理？
|
||
|
||
| 场景 | 子代理类型 | 说明 |
|
||
|------|-----------|------|
|
||
| 代码探索 | `Explore` | 只读，快速搜索 |
|
||
| 代码修改 | `general-purpose` | 读写，复杂任务 |
|
||
| 代码审查 | 自定义 | 只读，反馈 |
|
||
| 测试运行 | 自定义 | 隔离执行 |
|
||
|
||
### 创建自定义子代理
|
||
|
||
```markdown
|
||
# .claude/agents/code-reviewer.md
|
||
---
|
||
name: code-reviewer
|
||
description: 代码审查助手
|
||
tools: Read, Grep, Glob
|
||
model: sonnet
|
||
---
|
||
|
||
你是一个高级代码审查员。审查代码时：
|
||
1. 检查代码质量
|
||
2. 指出安全隐患
|
||
3. 建议性能优化
|
||
4. 保持 constructive 反馈
|
||
```
|
||
|
||
---
|
||
|
||
## 📋 CLAUDE.md 质量评分标准
|
||
|
||
| 维度 | 分值 | 说明 |
|
||
|------|------|------|
|
||
| 长度适当 | 25 | 不过长不过短 |
|
||
| 章节完整 | 25 | 包含关键章节 |
|
||
| 格式质量 | 20 | 清晰的 Markdown |
|
||
| 内容具体 | 15 | 有针对性 |
|
||
| 模块化 | 15 | 分文件组织 |
|
||
|
||
**及格线**：65/100
|
||
**优秀线**：85/100
|
||
|
||
---
|
||
|
||
## ⚡ 高级技巧
|
||
|
||
### 1. 使用 Hooks 自动化
|
||
|
||
```json
|
||
// .claude/hooks/session-start.json
|
||
{
|
||
"hook": "SessionStart",
|
||
"handler": "check-claude-md.sh"
|
||
}
|
||
```
|
||
|
||
### 2. 权限管理
|
||
|
||
```json
|
||
// .claude/settings.local.json
|
||
{
|
||
"permissions": {
|
||
"allow": ["Read", "Write", "Edit", "Bash"],
|
||
"ask": ["WebFetch"],
|
||
"deny": ["WebSearch"]
|
||
}
|
||
}
|
||
```
|
||
|
||
### 3. 多项目共享
|
||
|
||
```bash
|
||
# 全局 CLAUDE.md（所有项目生效）
|
||
~/.claude/CLAUDE.md
|
||
|
||
# 项目级 CLAUDE.md
|
||
project/CLAUDE.md
|
||
|
||
# 组件级 CLAUDE.md
|
||
project/frontend/CLAUDE.md
|
||
```
|
||
|
||
### 4. 上下文优化
|
||
|
||
- 定期使用 `/compact` 压缩上下文
|
||
- 保持 CLAUDE.md 简洁（100-200 行）
|
||
- 使用模块化文件（backend/CLAUDE.md, frontend/CLAUDE.md）
|
||
|
||
---
|
||
|
||
## 📚 学习路径
|
||
|
||
```
|
||
入门 → 安装 → 基础对话 → CLAUDE.md
|
||
↓
|
||
进阶 → 子代理 → Skills → Hooks
|
||
↓
|
||
高级 → batch 命令 → Agent Teams → 自动化
|
||
```
|
||
|
||
---
|
||
|
||
## 🔗 相关资源
|
||
|
||
| 资源 | 链接 |
|
||
|------|------|
|
||
| 官方文档 | https://code.claude.com/docs |
|
||
| 最佳实践 | https://github.com/shanraisshan/claude-code-best-practice |
|
||
| ClaudeForge | https://github.com/alirezarezvani/ClaudeForge |
|
||
| awesome-claude-md | https://github.com/josix/awesome-claude-md |
|
||
| CLAUDE.md 模板 | https://github.com/abhishekray07/claude-md-templates |
|
||
|
||
---
|
||
|
||
## AI工程索引
|
||
|
||
相关笔记：
|
||
- [[INDEX_AI工程]] - AI工程知识索引
|
||
- [[ClaudeCode完全研究]] - Claude Code 完整指南
|
||
- [[claude-code-best-practice详解]] - 最佳实践详解
|
||
|
||
---
|
||
|
||
*整理：知识库管理员 | 归档：2026-04-23* |