chill/chill_notes

Fork 0

Files

FNS Service 4d5e8bbe10 Update from Sync Service

2026-04-23 21:34:27 +08:00

5.1 KiB

Executable File

Raw Blame History

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 模板

🚀 安装与配置

一键安装

curl -fsSL https://claude.ai/install.sh | bash

快速验证

claude --version
claude doctor

选择模型

/model claude-sonnet-4-20260620

💡 核心使用技巧

1. 编写优秀的 CLAUDE.md

CLAUDE.md 是提升 Claude Code 效果的最重要因素！

结构建议：

# 项目名称

## 概述
简短描述项目做什么。

## 技术栈
- 语言/框架/工具

## 项目结构

src/ ├── components/ ├── utils/ └── types/


## 开发规范
- 代码风格
- 命名约定
- 测试要求

## 常用命令
- `npm run dev` - 开发服务器
- `npm test` - 运行测试

2. 使用 ClaudeForge 自动生成

# 安装 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 获取真实项目的优秀示例。

🎯 高效工作流

日常开发

# 1. 启动会话
cd project && claude

# 2. 描述任务
帮我实现用户认证功能，包括登录、注册和 JWT

# 3. 代码审查
/review

# 4. 测试
运行测试并修复失败的用例

# 5. 提交
git add . && git commit -m "feat: 添加用户认证"

大型重构

# 使用 batch 命令
/batch migrate src/ from JavaScript to TypeScript

# 自动分解任务 → 并行执行 → 创建 PR

调试模式

# 启用调试
/debug

# 或者使用调试技能
/debug 分析这个错误：TypeError: Cannot read property 'x' of undefined

🔧 关键命令速查

命令	用途
`/compact`	压缩上下文（节省 token）
`/context`	查看上下文使用
`/cost`	查看费用统计
`/agents`	管理子代理
`/batch`	大规模并行修改
`/diff`	查看变更
`/undo`	撤销修改
`/copy`	复制回复
`/model`	切换模型
`/config`	设置面板

🤖 子代理最佳实践

何时使用子代理？

场景	子代理类型	说明
代码探索	`Explore`	只读，快速搜索
代码修改	`general-purpose`	读写，复杂任务
代码审查	自定义	只读，反馈
测试运行	自定义	隔离执行

创建自定义子代理

# .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 自动化

// .claude/hooks/session-start.json
{
  "hook": "SessionStart",
  "handler": "check-claude-md.sh"
}

2. 权限管理

// .claude/settings.local.json
{
  "permissions": {
    "allow": ["Read", "Write", "Edit", "Bash"],
    "ask": ["WebFetch"],
    "deny": ["WebSearch"]
  }
}

3. 多项目共享

# 全局 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

5.1 KiB Executable File Raw Blame History Unescape Escape