Claude Code 完整教学指南：从小白到高手

# 传统方式 git checkout -b feature-auth mkdir src/auth touch src/auth/login.js src/auth/register.js # ... 更多手动步骤 
Claude Code 方式
 claude "创建一个用户认证功能，包括登录和注册"

# macOS/Linux curl -fsSL https://claude.ai/install.sh | sh 
验证安装
 claude --version

# macOS (Homebrew) brew install anthropic/tap/claude-code 
Linux (APT)
 curl -fsSL https://claude.ai/keys/ pubkey.asc | sudo apt-key add - echo "deb https://claude.ai/repos/ apt stable main" | sudo tee /etc/ apt/sources.list.d/claude.list sudo apt update claude code 教程&& sudo apt install claude-code 
Windows (Chocolatey)
 choco install claude-code

# 第一次运行会自动引导配置 claude 
手动配置
 claude config set api-key YOUR_API_KEY 
验证配置
 claude config list

# 查看可用模型 claude models list 
设置默认模型（推荐 Sonnet 4 平衡性能和成本）
 claude config set default-model claude-sonnet-4 
为特定任务设置模型
 claude config set model-for-complex-tasks claude-opus-4

# 设置默认编辑器 claude config set editor code # VS Code claude config set editor vim # Vim 
配置 Git 集成
 claude config set git-auto-commit true claude config set git-commit-style conventional 
设置工作目录偏好
 claude config set workspace-detection auto

# 安装官方扩展 code --install-extension anthropic.claude-code 
配置扩展设置
 { "claude-code.autoStart": true, "claude-code.showInlineCompletion": true, "claude-code.enableGitIntegration": true }

# 步骤1：探索和理解 
   
 
    请阅读 src/ 目录下的所有文件，了解 项目结构，但暂时不要写代码 
   
 
步骤2：制定计划
 
   
 
    think: 基于现有代码结构，制定添加用 户认证功能的详细计划 
   
 
步骤3：文档化计划
 
   
 
    将这个计划保存到 docs/auth-implementation-plan.md 
   
 
步骤4：实施代码
 
   
 
    现在按照计划开始实现用户认证功能 
   
 
步骤5：提交结果
 
   
 
    提交所有更改并创建 pull request，标题为 "feat: 添加用户认证功能" 
   

# 步骤1：编写测试 基于以下需求编写测试用例： 输入：用户名和密码 输出：认证成功返回 JWT token，失败返回错误信息 
步骤2：验证测试失败
 
   
 
    运行刚才编写的测试，确认它们按预期失败 
   
 
步骤3：提交测试
 
   
 
    提交测试文件，消息为 "test: 添加用户认证测试用例" 
   
 
步骤4：实现功能
 
   
 
    现在编写能够通过这些测试的代码 
   
 
步骤5：迭代优化
 
   
 
    运行测试，如果有失败的测试，继续修改代码直到全部通过 
   
 
步骤6：最终提交
 
   
 
    提交实现代码，消息为 "feat: 实现用户认证功能" 
   

# 步骤1：提供视觉参考 我上传了一个登录页面的设计图，请分析其布局和样式要求 
步骤2：实现初版
 
   
 
    根据设计图创建 HTML 和 CSS 代码 
   
 
步骤3：生成预览
 
   
 
    在浏览器中打开页面并截图，让我看看当前效果 
   
 
步骤4：迭代改进
 
   
 
    对比设计图，调整以下问题： 
    
 
     
按钮颜色应该更深一些
 
     
输入框间距需要增加
 
     
标题字体需要加粗
 
    
 
   
 
步骤5：满意后提交
 
   
 
    效果符合预期，请提交代码 
   

# Max 用户（直接使用 Claude Code） claude 我想开发一个任务管理应用，有什么好的技术方案？ 
Pro 用户（可以先在网页端讨论）
 
在 claude.ai 网页版进行详细的需求分析和技术选型讨论
 
也可以使用 ChatGPT 或 Gemini 进行前期规划
 
讨论内容要点：
 
   
 
    
用户需求和使用场景
 
    
产品功能和界面设计
 
    
技术架构和实现方法
 
    
开发时间和资源预估 
 
   

# 1. 创建项目结构 mkdir my-task-manager cd my-task-manager mkdir docs 
2. 将需求文档放入 docs 文件夹
 
创建 docs/requirements.md
 
创建 docs/user-stories.md
 
创建 docs/technical-specs.md
 
3. 初始化项目
 claude 
   
 
    /init 请依据 docs 文件夹的内容构建项目，分析需求文档并生成对应的 CLAUDE.md 
   

# 进入计划模式 现在进入 plan mode。请仔细阅读 docs 文件夹中的所有需求文档， 根据这些要求规划详细的技术实现路径和功能需求分解。 重要：现在只进行规划，不要编写任何代码！ 请输出： 
   
 
    
技术架构设计
 
    
功能模块分解
 
    
开发优先级排序
 
    
预估开发时间
 
    
潜在风险识别
 
   
 
Claude 的规划输出示例：
 
技术架构：React + Node.js + MongoDB
 
功能模块：用户管理、任务CRUD、分类标签、搜索过滤
 
开发顺序：基础框架 → 用户认证 → 任务管理 → 高级功能
 

# 生成详细的任务文件 
   
 
    请将刚才的规划保存为 docs/implementation-tasks.md， 按照以下格式组织： 
    里程碑1：项目基础框架 
    
 
     
[ ] 搭建 React 项目
 
     
[ ] 配置开发环境
 
     
[ ] 设计基础路由
 
    
 
    里程碑2：用户认证系统 
    
 
     
[ ] 实现用户注册
 
     
[ ] 实现用户登录
 
     
[ ] JWT token 管理
 
    
 
    每个任务包含： 
    
 
     
具体描述
 
     
预估时间
 
     
依赖关系
 
     
验收标准
 
    
 
   
 
提交规划文档
 
   
 
    提交 docs 文件夹的所有更新，消息为 "docs: 添加项目规划和任务分解" 
   

# 明确当前实现范围 现在开始实现 "里程碑1：项目基础框架" 中的任务。 请再次进入 plan mode，详细规划这个里程碑的实现步骤。 
开始实现
 
   
 
    plan mode 结束，现在开始执行实现： 
    
 
     
搭建 React 项目框架
 
     
配置 ESLint 和 Prettier
 
     
设置基础路由结构
 
     
创建主要页面组件
 
    
 
   
 
验证实现
 
   
 
    启动开发服务器，确保项目能正常运行 测试路由跳转是否正常 检查代码格式是否符合规范 
   
 
提交里程碑
 
   
 
    里程碑1 完成，提交所有更改，消息为 "feat: 完成项目基础框架搭建" 
   

# 继续下一个里程碑 现在开始 "里程碑2：用户认证系统" 请先制定详细的实现计划，然后逐步执行 
业务场景验证
 
   
 
    实现用户注册功能后，请： 
    
 
     
创建一个测试用户
 
     
验证邮箱格式检查
 
     
测试密码强度验证
 
     
确认数据正确保存到数据库
 
    
 
   
 
迭代提交
 
   
 
    每完成一个主要功能就提交一次，保持 Git 历史清晰 
   

# 项目完成后的最终步骤 所有功能开发完成，现在请： 
   
 
    
运行完整的测试套件
 
    
更新 README.md 文档
 
    
生成 API 文档
 
    
创建部署配置文件
 
   
 
上传到 GitHub
 
   
 
    创建 GitHub 仓库并推送代码： 
    
 
     
初始化 Git 仓库
 
     
添加 .gitignore 文件
 
     
创建详细的 README
 
     
推送到 GitHub
 
     
设置 GitHub Pages（如果适用） 
 
    
 
   

{ "需求阶段": [ "我想要[具体功能]，但不知道从哪里开始", "这个想法可行吗？大概需要什么技术？", "我想做一个电商网站，主要功能是商品展示和购买，类似淘宝的简化版" ], "开发阶段": [ "先不要写代码，告诉我需要哪些步骤", "请解释一下[概念]是什么意思", "为什么选择这个方法而不是那个？", "React hooks 和 class 组件有什么区别？在这个项目中应该用哪个？" ], "调试阶段": [ "我的代码出现了[具体问题]，该怎么解决？", "这个错误信息是什么意思：[错误信息]", "用户登录时出现 401 错误，但用户名密码都是正确的" ], "优化阶段": [ "这段代码还可以怎么改进？", "如果要添加[功能]，应该怎么做？", "如果用户量增长到 10 万，这个数据库查询会有性能问题吗？" ] }

{ "静态网站开发示例": { "HTML阶段": [ "1. 我想要一个任务管理器的页面结构", "2. 先不写代码，告诉我需要哪些HTML元素和页面布局", "3. 好的，现在请创建HTML代码" ], 
"CSS阶段": [ "1. 我想要简洁现代的页面样式，参考 Notion 的设计风格", "2. 先解释一下设计原则和布局方案，包括颜色搭配和字体选择", "3. 现在请实现这些样式" ], "JavaScript阶段": [ "1. 我想要添加任务的交互功能：添加、删除、标记完成", "2. 先说明需要哪些函数和事件处理逻辑", "3. 现在请编写具体的代码" ] 
 }, "后端API开发示例": { "设计阶段": [ "1. 我需要一个用户认证的API接口", "2. 先设计API的请求/响应格式和错误处理机制", "3. 现在实现这个API" ], 
"数据库阶段": [ "1. 用户数据需要持久化存储", "2. 先设计数据库表结构和字段关系", "3. 现在创建数据库模型和迁移文件" ] 
 } }

# 错误1：问题太大太空泛 ❌ "帮我做一个电商网站" ✅ "帮我设计电商网站的商品展示页面，包括图片轮播、价格显示和购买按钮" 
错误2：一次要求做太多事
 ❌ "创建用户注册、登录、商品管理、订单处理的完整系统" ✅ "先实现用户注册功能，包括邮箱验证和密码加密" 
错误3：跳过理解直接复制代码
 ❌ 直接复制代码到项目中 ✅ "这段代码的核心逻辑是什么？为什么这样设计？" 
错误4：忘记问"为什么"
 ❌ 只关注代码实现 ✅ "为什么选择 JWT 而不是 Session？这样做有什么优缺点？" 
错误5：遇到问题不主动提问
 ❌ 代码报错就放弃 ✅ "出现这个错误：TypeError: Cannot read property 'map' of undefined，这是什么原因？"

 Claude 可以扮演的角色： 🎓 老师 
   
 
    
解释复杂的技术概念
 
    
分析代码的优缺点
 
    
推荐最佳实践
 
   
 👨‍💼 下属/助手 
   
 
    
执行具体的开发任务
 
    
生成模板代码
 
    
处理重复性工作
 
   
 📋 秘书 
   
 
    
整理文档和注释
 
    
管理任务清单
 
    
生成会议纪要
 
   
 🤝 合作伙伴 
   
 
    
讨论技术方案
 
    
一起解决问题
 
    
互相启发创意 
 
   

 📋 自我检查清单 提问质量检查 
   
 
    
[ ] ✅ 有没有问太大太空泛的问题？
 
    
[ ] ✅ 有没有要求Claude一次做太多事？
 
    
[ ] ✅ 问题描述是否足够具体和清晰？
 
   
 学习态度检查 
   
 
    
[ ] ✅ 有没有跳过理解直接复制代码？
 
    
[ ] ✅ 有没有忘记问"为什么"？
 
    
[ ] ✅ 是否理解了Claude提供的解决方案？
 
   
 互动质量检查 
   
 
    
[ ] ✅ 遇到问题有没有主动提问？
 
    
[ ] ✅ 有没有给Claude提供足够的上下文信息？
 
    
[ ] ✅ 是否按照计划循序渐进地推进？
 
   
 代码质量检查 
   
 
    
[ ] ✅ 生成的代码是否符合项目规范？
 
    
[ ] ✅ 有没有进行充分的测试验证？
 
    
[ ] ✅ 文档和注释是否完整？ 
 
   

 🎯 核心原则 
   
 
    
信任但验证 
     
 
      
信任Claude的建议，但要理解原理
 
      
每个重要决策都要问"为什么"
 
     
 
 
    
分而治之 
     
 
      
大任务拆分成小任务
 
      
一步一步验证结果
 
     
 
 
    
持续沟通 
     
 
      
及时反馈问题和想法
 
      
不要让Claude猜测你的需求
 
     
 
 
    
保持学习 
     
 
      
把每次合作当作学习机会
 
      
总结经验和最佳实践
 
     
 
 
    
质量第一 
     
 
      
不要为了速度牺牲代码质量
 
      
充分测试和文档化 
 
     
 
   

# 在项目根目录启动 cd your-project claude 
带参数启动
 claude --model claude-opus-4 # 指定模型 claude --verbose # 详细输出 claude --dangerously-skip-permissions # 跳过权限检查（谨慎使用）

# 交互模式（默认） claude 
   
 
    你好，Claude！请帮我分析这个项目的结构 
   
 
无头模式（直接执行）
 claude -p "分析项目结构并生成README" 
管道操作
 echo "修复所有 ESLint 错误" | claude -p 
输出格式控制
 claude -p --output-format json "获取项目统计信息"

# 在项目中运行 claude 
   
 
    /init 
   
 
Claude 会创建：
 
- CLAUDE.md（项目描述文件）
 
- .claude/（配置目录）
 
- .gitignore 更新（忽略临时文件）
 

> /clear 
清空当前会话的所有历史记录
 
适用于：开始新任务、重置上下文、解决混乱状态
 

> /compact 
保留重要信息，压缩冗余内容
 
适用于：长时间会话、内存不足、性能优化
 

> /help # 显示所有命令 
   
 
    /help git # 显示 Git 相关帮助 /help commands # 显示自定义命令帮助 
   

> /agents # 列出所有代理 /agents create code-reviewer # 创建代码审查代理 /agents switch test-engineer # 切换到测试工程师代理 components 3.3 文件操作命令 
文件读取与编辑
 bash 
读取文件
 
   
 
    读取 src/app.js 的内容 
   
 
编辑文件
 
   
 
    在 src/app.js 中添加错误处理 
   
 
创建新文件
 
   
 
    创建一个新的组件文件 src/components/UserProfile.jsx 
   
 
批量操作
 
   
 
    将所有 .js 文件重命名为 .ts 文件 
   

# 项目结构分析 分析项目结构并显示主要模块 
搜索功能
 
   
 
    找到所有包含 "TODO" 注释的文件 
   
 
依赖分析
 
   
 
    分析 package.json 并检查过时的依赖 
   

# 创建功能分支 创建一个名为 feature-user-auth 的新分支 
分支切换
 
   
 
    切换到 develop 分支 
   
 
查看状态
 
   
 
    显示当前 Git 状态和未提交的更改 
   

# 智能提交 提交当前更改，自动生成提交信息 
指定提交信息
 
   
 
    提交更改，消息为 "feat: 添加用户认证功能" 
   
 
推送到远程
 
   
 
    推送当前分支到 origin 
   

# 创建 Pull Request 创建 PR，标题为 "添加用户认证功能" 
代码审查
 
   
 
    审查最新的 Pull Request 
   
 
安装 GitHub CLI 集成
 
   
 
    /install-github-app 
   

# 项目名称 项目概述 这是一个 React + Node.js 的全栈 Web 应用，用于用户管理和内容发布。 技术栈 
   
 
    
Frontend: React 18, TypeScript, Tailwind CSS
 
    
Backend: Node.js, Express, PostgreSQL
 
    
部署: Docker, AWS ECS
 
   
 项目结构

 开发规范 
   
 
    
使用 ES6+ 语法
 
    
组件采用函数式写法
 
    
提交信息遵循 Conventional Commits
 
    
测试覆盖率保持在 80% 以上
 
   
 常用命令 
   
 
    
npm run dev: 启动开发服务器
 
    
npm run build: 构建生产版本
 
    
npm test: 运行测试
 
    
npm run lint: 代码检查
 
   
 注意事项 
   
 
    
数据库连接配置在 .env 文件中
 
    
API 接口遵循 RESTful 设计
 
    
所有用户输入都需要验证和清理 
 
   

 架构决策记录 (ADR) 
选择 PostgreSQL 而非 MongoDB，因为需要复杂查询
 
使用 JWT 进行身份验证，session 存储在 Redis
 
前端状态管理使用 Zustand 而非 Redux
 性能要求 
   
 
    
页面首次加载时间 < 2秒
 
    
API 响应时间 < 500ms
 
    
支持 1000 并发用户
 
   
 安全规范 
   
 
    
所有 API 端点都需要身份验证
 
    
用户输入必须经过 XSS 防护
 
    
密码必须使用 bcrypt 加密
 
   
 测试策略 
   
 
    
单元测试：Jest + React Testing Library
 
    
集成测试：Supertest
 
    
E2E 测试：Playwright 
 
   

.claude/ ├── config.json # 项目特定配置 ├── commands/ # 自定义命令 │ ├── test.md # 测试命令 │ ├── deploy.md # 部署命令 │ └── review.md # 代码审查命令 ├── agents/ # 自定义代理 │ ├── code-reviewer.md │ └── test-engineer.md ├── hooks/ # 生命周期钩子 │ ├── pre-tool-use.sh │ └── post-tool-use.sh └── templates/ # 代码模板 ├── component.tsx └── api-route.js 

{ "model": "claude-sonnet-4", "context_window": , "auto_commit": true, "git": { "commit_style": "conventional", "auto_push": false, "branch_naming": "feature/{ticket-id}-{description}" }, "code_style": { "language": "typescript", "formatter": "prettier", "linter": "eslint" }, "testing": { "framework": "jest", "coverage_threshold": 80 } } 

┌─────────────────────────────────────┐ │ 上下文窗口 (200K tokens) │ ├─────────────────────────────────────┤ │ CLAUDE.md (项目信息) │ │ 对话历史 │ │ 当前文件内容 │ │ 工具执行结果 │ │ 错误信息和日志 │ └─────────────────────────────────────┘ 

# 1. 定期清理 
   
 
    /compact # 压缩历史信息 /clear # 完全清空（新任务开始时） 
   
 
2. 分段处理大任务
 
   
 
    第一步：分析项目结构 
   
 
完成后
 
   
 
    /compact 第二步：实现核心功能 
   
 
3. 使用检查点
 
   
 
    将当前进度保存到 progress.md /clear 从 progress.md 继续之前的工作 
   

# 项目测试命令 描述 运行完整的测试套件并生成报告 用法 /test [scope] 参数 
   
 
    
scope: 测试范围 (unit|integration|e2e|all)
 
   
 执行步骤 
   
 
    
运行指定范围的测试
 
    
生成覆盖率报告
 
    
检查测试结果
 
    
如果有失败，提供修复建议
 
   
 命令 bash npm run test:${scope:-all} npm run coverage

部署命令 (deploy.md)： markdown 
部署到生产环境
 前置检查 
   
 
    
[ ] 所有测试通过
 
    
[ ] 代码已经合并到 main 分支
 
    
[ ] 版本号已更新
 
    
[ ] 环境变量已配置
 
   
 部署步骤 
   
 
    
构建 Docker 镜像
 
    
推送到镜像仓库
 
    
更新 Kubernetes 配置
 
    
执行滚动更新
 
    
验证部署结果
 
   
 回滚计划 如果部署失败，自动回滚到上一个稳定版本

> /test unit # 运行单元测试 
   
 
    /deploy production # 部署到生产环境 /review --security # 安全代码审查 
   

// .claude/hooks/config.json { "hooks": [ { "name": "format-on-edit", "trigger": "PostToolUse", "matcher": "Edit", "command": "npm run format", "enabled": true }, { "name": "test-on-commit", "trigger": "PreToolUse", "matcher": "git commit", "command": "npm test", "enabled": true } ] } 

#!/bin/bash 
在工具执行前运行
 
读取标准输入中的 JSON 数据
 data=$(cat) tool_name=$(echo "$data" | jq -r '.tool_name') if [ "$tool_name" = "Edit" ]; then echo "正在格式化代码..." npm run format 
# 如果格式化失败，阻止执行 if [ $? -ne 0 ]; then echo '{"should_continue": false, "message": "代码格式化失败"}' exit 1 fi 
 fi echo '{"should_continue": true}'

> /agents create ? 代理名称: security-auditor ? 代理描述: 专门进行安全审计的代理 ? 专业领域: 安全、漏洞检测、合规性检查 

# 安全审计代理 角色定义 你是一名专业的网络安全专家，专门负责代码安全审计。 专业技能 
   
 
    
识别常见安全漏洞 (OWASP Top 10)
 
    
SQL 注入检测
 
    
XSS 防护验证
 
    
身份验证和授权检查
 
    
密码学最佳实践
 
   
 审计流程 
   
 
    
静态分析: 扫描代码中的安全漏洞
 
    
依赖检查: 检查第三方库的已知漏洞
 
    
配置审查: 检查安全配置是否正确
 
    
合规性检查: 确保符合安全标准
 
   
 输出格式 
   
 
    
高危漏洞列表
 
    
中等风险问题
 
    
修复建议
 
    
安全评级
 
   
 工具集成 
   
 
    
ESLint Security Plugin
 
    
npm audit
 
    
Snyk
 
    
SonarQube 
 
   

# 主代理协调多个子代理 
   
 
    请安全代理审查这个登录功能，性能代理分析响应时间，测试代理编写测试用例 
   
 
直接调用特定代理
 
   
 
    @security-auditor 审查这个 API 接口的安全性 @performance-analyst 这个查询的性能如何？ 
   

// .mcp.json { "mcpServers": { "github": { "command": "npx", "args": ["@modelcontextprotocol/server-github"], "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token" } }, "jira": { "command": "npx", "args": ["@modelcontextprotocol/server-jira"], "env": { "JIRA_API_TOKEN": "your-token", "JIRA_BASE_URL": "https://your-domain.atlassian.net" } }, "database": { "command": "npx", "args": ["@modelcontextprotocol/server-postgres"], "env": { "DATABASE_URL": "postgresql://user:pass@host:5432/db" } } } } 

# GitHub 集成 创建一个 issue 来跟踪这个 bug 从 issue #123 生成代码来修复这个问题 
Jira 集成
 
   
 
    查看我分配的所有任务 更新任务 PROJ-456 的状态为"进行中" 
   
 
数据库集成
 
   
 
    查询用户表中活跃用户的数量 生成数据库迁移脚本来添加新字段 
   

# 安装常用服务器 claude mcp add github claude mcp add slack
 claude mcp add notion claude mcp add google-drive claude mcp add postgresql claude mcp add brave-search 

# .claude/commands/review.md 
代码审查命令
 审查清单 
   
 
    
[ ] 代码风格一致性
 
    
[ ] 安全漏洞检查
 
    
[ ] 性能潜在问题
 
    
[ ] 测试覆盖率
 
    
[ ] 文档完整性
 
   
 执行步骤 
   
 
    
运行静态分析工具
 
    
检查代码覆盖率
 
    
安全漏洞扫描
 
    
性能测试
 
    
生成审查报告
 
   
 自动修复 对于可以自动修复的问题，Claude 会： 
   
 
    
格式化代码
 
    
添加缺失的类型注解
 
    
优化导入语句
 
    
更新过时的语法 
 
   

# ESLint 集成 
   
 
    运行 ESLint 并修复所有可自动修复的问题 
   
 
TypeScript 检查
 
   
 
    检查类型错误并添加缺失的类型注解 
   
 
测试覆盖率
 
   
 
    运行测试并确保覆盖率达到 80% 
   
 
安全检查
 
   
 
    使用 npm audit 检查安全漏洞并提供修复方案 
   

# 项目分析流程 请按以下顺序分析项目： 
   
 
    
读取 package.json 了解依赖和脚本
 
    
分析项目结构和主要模块
 
    
识别核心业务逻辑
 
    
找出潜在的技术债务
 
    
生成项目健康度报告 
 
   

# 安全重构流程 重构 UserService 类： 
首先为现有功能编写测试
 
创建新的接口定义
 
逐步迁移方法
 
确保所有测试通过
 
更新相关文档
 
大规模重构
 
   
 
    将整个项目从 JavaScript 迁移到 TypeScript： 
    
 
     
安装 TypeScript 依赖
 
     
配置 tsconfig.json
 
     
逐个模块转换，从叶子节点开始
 
     
添加类型定义
 
     
修复类型错误 
 
    
 
   

# 自动文档更新 代码更改完成后，请： 
更新 API 文档
 
更新 README.md
 
添加变更日志条目
 
更新 CLAUDE.md 中的相关信息
 
文档验证
 
   
 
    检查文档与代码的一致性： 
    
 
     
API 文档是否反映最新接口
 
     
示例代码是否能正常运行
 
     
安装说明是否准确 
 
    
 
   

// .claude/team-workflow.json { "branching": { "feature": "feature/{jira-id}-{description}", "hotfix": "hotfix/{issue-id}", "release": "release/{version}" }, "commit": { "style": "conventional", "require_ticket": true, "auto_format": true }, "code_review": { "require_tests": true, "min_coverage": 80, "auto_assign_reviewers": true } } 

# .claude/commands/document.md 
知识文档化命令
 触发时机 
   
 
    
完成重要功能开发
 
    
解决复杂技术问题
 
    
做出架构决策
 
   
 文档内容 
   
 
    
决策背景: 为什么需要这个改动？
 
    
技术方案: 如何实现的？
 
    
替代方案: 考虑过哪些其他选择？
 
    
风险评估: 有什么潜在问题？
 
    
使用示例: 如何使用新功能？
 
   
 输出位置 
   
 
    
技术文档: docs/technical/
 
    
API 文档: docs/api/
 
    
用户指南: docs/user-guide/
 
    
架构决策: docs/adr/ 
 
   

# 策略1：任务分段 
   
 
    阶段1：分析需求和设计接口 /compact 阶段2：实现核心逻辑
 /compact 阶段3：编写测试和文档 
   
 
策略2：使用检查点
 
   
 
    将当前进度保存到 checkpoint.md /clear 从 checkpoint.md 恢复上下文继续工作 
   
 
策略3：专用会话
 
   
 
    为大型重构创建专门的会话 为日常开发保持另一个会话 
   

# 高效的批量操作 一次性处理所有相关文件： 
   
 
    
将所有组件文件转换为 TypeScript
 
    
统一添加 PropTypes 定义
 
    
更新所有导入语句
 
    
运行格式化和检查
 
   
 
避免低效操作
 ❌ > 转换 Component1.js 为 TypeScript ❌ > 转换 Component2.js 为 TypeScript
 ❌ > 转换 Component3.js 为 TypeScript ✅ > 将 src/components/ 下所有 .js 文件转换为 TypeScript

# 项目背景：18000 行的庞大组件需要拆分 
   
 
    分析 UserDashboard.jsx 组件： 
    
 
     
识别可以独立的功能模块
 
     
分析组件间的数据依赖
 
     
设计新的组件架构
 
     
制定重构计划
 
    
 
   
 
Claude 的分析结果：
 
- 用户信息展示 (UserProfile)
 
- 数据统计面板 (StatsDashboard)
 
- 操作历史 (ActivityLog)
 
- 设置面板 (SettingsPanel)
 
   
 
    执行重构： 
    
 
     
创建新的子组件文件
 
     
提取相关的状态和逻辑
 
     
建立组件间通信机制
 
     
逐步迁移功能模块
 
     
更新测试文件
 
     
验证功能完整性 
 
    
 
   

# 从单体应用拆分为微服务 
   
 
    微服务拆分计划： 
    
 
     
分析当前应用的业务边界
 
     
识别数据库依赖关系
 
     
设计服务间通信协议
 
     
制定迁移时间表
 
    
 
   
 
用户服务迁移
 
   
 
    创建用户微服务： 
    
 
     
初始化新的 Node.js 项目
 
     
设计用户相关 API
 
     
迁移用户数据模型
 
     
实现身份验证中间件
 
     
编写集成测试
 
     
配置容器化部署 
 
    
 
   

# 将 jQuery + PHP 应用迁移到 React + Node.js 
   
 
    现代化策略： 
    
 
     
分析现有功能和业务逻辑
 
     
设计新的技术架构
 
     
建立数据迁移方案
 
     
实现渐进式替换
 
    
 
   
 
第一阶段：API 现代化
 
   
 
    
 
     
创建 Node.js API 服务
 
     
封装现有 PHP 逻辑
 
     
实现 RESTful 接口
 
     
添加 API 文档
 
    
 
   
 
第二阶段：前端重写
 
   
 
    
 
     
搭建 React 项目框架
 
     
逐页面替换 jQuery 代码
 
     
集成新的 API 接口
 
     
保持用户体验一致性 
 
    
 
   

# .github/workflows/claude-code-review.yml name: Claude Code Review on: pull_request: types: [opened, synchronize] jobs: claude-review: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 
 - name: Setup Claude Code run: | curl -fsSL https://claude.ai/install.sh | sh claude config set api-key ${{ secrets.CLAUDE_API_KEY }} - name: Run Code Review run: | claude -p "审查这个 PR 的代码质量、安全性和性能" > review.md - name: Comment PR uses: actions/github-script@v6 with: script: | const fs = require('fs'); const review = fs.readFileSync('review.md', 'utf8'); github.rest.issues.createComment({ issue_number: context.issue.number, owner: context.repo.owner, repo: context.repo.repo, body: ` Claude Code Review\n\n${review}` }); 
 

# .claude/commands/ci-cd.md 
CI/CD 流水线命令
 测试阶段    
     
静态分析      
       
ESLint 代码检查
       
TypeScript 类型检查
       
安全漏洞扫描
      
 
     
单元测试      
       
Jest 测试运行
       
覆盖率报告生成
       
性能基准测试
      
 
     
集成测试      
       
API 接口测试
       
数据库集成测试
       
第三方服务集成测试
      
 
    
 部署阶段    
     
构建优化      
       
代码压缩和打包
       
资源优化
       
Docker 镜像构建
      
 
     
环境部署      
       
测试环境部署
       
自动化验证
       
生产环境发布
      
 
     
监控告警      
       
性能监控
       
错误追踪
       
用户体验监控 
      
    

# 问题诊断流程    
     应用出现间歇性 500 错误，请帮我诊断：     
      
分析错误日志模式
      
检查系统资源使用
      
排查数据库性能
      
验证外部依赖状态
      
提供修复方案
     
    
 
日志分析
    
     分析 application.log：     
      
统计错误类型和频率
      
找出错误的时间模式
      
关联用户操作和错误
      
生成诊断报告 
     
    

# 性能瓶颈诊断 页面加载速度慢，请分析： 
检查前端资源大小
 
分析网络请求性能
 
数据库查询优化
 
缓存策略评估
 
提供优化建议
 
数据库性能调优
    
     优化慢查询：     
      
分析查询执行计划
      
识别缺失的索引
      
优化查询语句
      
建议架构改进 
     
    

# 数据处理管道 cat access.log | claude -p "分析访问日志，找出访问量最高的 10 个页面" 
代码分析管道
 find . -name "*.js" | xargs cat | claude -p "分析代码复杂度并提供重构建议" 
Git 历史分析
 git log --oneline | claude -p "分析提交历史，识别开发模式和热点文件" 
性能数据分析
 curl -s "http://api.example.com/metrics" | claude -p "分析 API 性能指标并生成报告"

#!/bin/bash 
claude-batch-process.sh
 
批量处理多个项目
 projects=("project-a" "project-b" "project-c") for project in "${projects[@]}"; do echo "处理项目: $project" cd "$project" 
# 运行 Claude Code 分析 claude -p "分析项目健康度并生成报告" > "../reports/${project}-health.md" # 运行测试 claude -p "运行所有测试并更新覆盖率报告" > "../reports/${project}-tests.md" cd .. 
 done 
生成汇总报告
 claude -p "基于所有项目报告，生成整体开发状况总结" < reports/*.md > summary.md

# 开发环境配置 export CLAUDE_MODEL="claude-sonnet-4" export CLAUDE_MAX_TOKENS="" export CLAUDE_AUTO_COMMIT="true" 
生产环境配置
 export CLAUDE_MODEL="claude-opus-4" export CLAUDE_SAFETY_MODE="strict" export CLAUDE_BACKUP_BEFORE_EDIT="true" 
项目特定配置
 export PROJECT_TYPE="react" export CODE_STYLE="airbnb" export TEST_FRAMEWORK="jest"

# 配置 Bedrock claude config set provider bedrock claude config set bedrock-region us-east-1 claude config set bedrock-model anthropic.claude-3-sonnet--v1:0 
企业安全配置
 claude config set encryption-at-rest true claude config set audit-logging true claude config set vpc-endpoint vpc-

# 配置 Vertex AI claude config set provider vertex-ai claude config set vertex-project your-project-id claude config set vertex-location us-central1 
配置企业策略
 claude config set data-residency us claude config set compliance-mode gdpr claude config set access-control rbac

# claude-enterprise.yml apiVersion: v1 kind: ConfigMap metadata: name: claude-config data: model_endpoint: "https://internal-claude-api.company.com" auth_mode: "oidc" storage_backend: "s3" logging_level: "info" max_concurrent_sessions: "100" session_timeout: "3600"    
 apiVersion: apps/v1 kind: Deployment metadata: name: claude-code-server spec: replicas: 3 selector: matchLabels: app: claude-code template: metadata: labels: app: claude-code spec: containers: - name: claude-code image: anthropic/claude-code:enterprise ports: - containerPort: 8080 env: - name: CLAUDE_CONFIG valueFrom: configMapKeyRef: name: claude-config key: config.json

# 安装社区工具 git clone https://github.com/hesreallyhim/awesome-claude-code.git cd awesome-claude-code 
状态行美化
 npm install -g ccstatusline claude config set statusline ccstatusline 
会话历史管理
 npm install -g cchistory cchistory --show-top-10 
配置文件管理器
 npm install -g ccexp ccexp --interactive

# TSK - AI 任务管理器 cargo install tsk tsk create "实现用户认证功能" --agent claude 
SuperClaude 框架
 git clone https://github.com/SuperClaude-Org/SuperClaude.git cp SuperClaude/configs/* .claude/ 
Claude 美化主题
 git clone https://github.com/Owloops/claude-powerline.git cp claude-powerline/themes/dracula.json .claude/themes/

# 社区分享的高级配置    
     
智能代码审查配置 来源：Netflix 工程团队 
     
多语言项目管理 来源：Google 开源项目 
     
大规模重构工作流 来源：Facebook 内部分享 
     
AI 辅助测试策略 来源：Anthropic 研究团队 
     
性能优化最佳实践 来源：云原生社区 
    

# 问题1：权限错误 错误：Permission denied when running claude 解决： sudo chmod +x /usr/local/bin/claude 
或重新安装到用户目录
 curl -fsSL https://claude.ai/install.sh | sh -s -- --user 
问题2：API 连接失败
 错误：Failed to connect to Claude API 诊断： claude config check-connection curl -I https://api.anthropic.com/v1/health 解决： 
检查网络连接
 
验证 API 密钥
 
配置代理（如果需要）
 claude config set proxy http://proxy.company.com:8080 
问题3：模型访问受限
 错误：Model not available 解决： claude models list --available claude config set model claude-sonnet-4

# 配置文件损坏 cp ~/.claude/config.json ~/.claude/config.json.backup claude config reset claude config import ~/.claude/config.json.backup 
项目配置冲突
 cd project-directory claude config list --local claude config set --local model claude-sonnet-4 
MCP 服务器配置问题
 claude --mcp-debug claude mcp test github claude mcp restart --all

# 响应速度慢 
1. 检查上下文大小
 claude status --context-usage 
2. 清理会话历史
 claude /compact claude /clear 
3. 优化模型选择
 claude config set model claude-sonnet-4 # 平衡性能 claude config set model claude-haiku-3.5 # 快速响应 
内存使用过高
 
1. 限制上下文窗口
 claude config set max-context-tokens  
2. 启用自动压缩
 claude config set auto-compact true 
3. 定期清理缓存
 claude cache clear

# 全局调试模式 claude --verbose --debug 
MCP 调试
 claude --mcp-debug 
网络调试
 claude --network-debug 
保存调试日志
 claude --debug --log-file debug.log

# API 错误代码 400: 请求格式错误 - 检查输入参数 401: 身份验证失败 - 验证 API 密钥 403: 权限不足 - 检查模型访问权限 429: 请求频率限制 - 等待或升级套餐 500: 服务器错误 - 稍后重试 
工具执行错误
 Tool execution failed: 检查工具权限和依赖 Context window exceeded: 使用 /compact 或 /clear Model overloaded: 切换到其他模型

# 实时状态监控 claude status --watch 
使用量统计
 claude usage --monthly claude usage --by-project 
性能基准测试
 claude benchmark --model claude-sonnet-4 claude benchmark --compare-models

# 监控上下文使用 claude status 
输出：Context: 150K/200K tokens (75% used)
 
优化策略
    
     
定期压缩：每完成主要任务后运行 /compact
     
分阶段执行：将大任务拆分为多个小任务
     
选择性加载：只加载必要的文件到上下文
     
使用检查点：保存进度，清空上下文，从检查点继续
    
 
自动化上下文管理
 claude config set auto-compact-threshold 0.8 claude config set auto-compact-interval 1800 # 30分钟

# 监控令牌消耗 claude usage --current-session claude usage --cost-breakdown 
优化策略
    
     
模型选择：      
       
简单任务使用 Haiku 3.5
       
复杂任务使用 Sonnet 4
       
关键任务使用 Opus 4.1
      
 
     
请求优化：      
       
批量处理相关任务
       
避免重复提供相同信息
       
使用缓存机制
      
 
     
输出控制： claude config set max-response-tokens 4000 claude config set prefer-concise-responses true 
    

# 选择最近的API端点 claude config set api-region us-west-2 # 西海岸用户 claude config set api-region eu-west-1 # 欧洲用户 
启用请求缓存
 claude config set enable-cache true claude config set cache-duration 3600 
并发控制
 claude config set max-concurrent-requests 3 claude config set request-timeout 30

# 未来可能的功能 
   
 
    自动检测代码异味并重构 根据用户行为模式预测需求 智能建议架构优化方案 自动生成测试和文档 
   

# 图像和图表理解 根据这个架构图生成代码框架 分析这个UI截图并实现对应组件 
音频交互
 
   
 
    语音描述需求，Claude 直接编码 代码审查时的语音反馈 
   

# 复杂问题分解 设计一个可扩展到百万用户的系统架构 
自动化测试生成
 
   
 
    基于业务需求自动生成全套测试用例 
   
 
性能优化建议
 
   
 
    分析代码性能瓶颈并提供优化方案 
   

 必读资源 
   
 
    
Claude Code 官方文档
 
    
Anthropic 博客
 
    
GitHub 官方仓库
 
   
 学习计划 第1月：基础掌握 
   
 
    
[ ] 完成官方教程
 
    
[ ] 配置开发环境
 
    
[ ] 实践基本命令
 
   
 第2月：进阶功能 
   
 
    
[ ] 学习自定义命令
 
    
[ ] 配置 MCP 服务器
 
    
[ ] 团队协作实践
 
   
 第3月：高级应用 
   
 
    
[ ] 企业级部署
 
    
[ ] 性能优化
 
    
[ ] 社区贡献 
 
   

# 1. 参与开源项目 git clone https://github.com/hesreallyhim/awesome-claude-code.git 
贡献你的配置和最佳实践
 
2. 分享经验
 
在 Twitter、LinkedIn 分享使用心得
 
写博客记录解决的技术问题
 
3. 社区讨论
 
加入 Discord 社区
 
参与 Reddit r/ClaudeCode 讨论
 
4. 反馈和建议
 claude /bug # 报告问题 
在 GitHub 提交功能请求
 

# 1. 个人博客系统 
   
 
    使用 Claude Code 构建一个 Next.js 博客 集成 CMS，自动化部署 
   
 
2. TODO 应用
 
   
 
    React + Node.js 全栈应用 包含用户认证、数据持久化 
   
 
3. API 文档生成器
 
   
 
    自动从代码生成 API 文档 集成 Swagger/OpenAPI 
   

# 1. 电商平台 微服务架构设计 购物车、支付、订单管理 
2. 实时聊天应用
 
   
 
    WebSocket 集成 用户在线状态、消息推送 
   
 
3. 数据分析平台
 
   
 
    数据可视化 报表生成、导出功能 
   

# 1. 云原生应用 Kubernetes 部署 服务网格、监控告警 
2. AI 辅助开发工具
 
   
 
    扩展 Claude Code 功能 自定义 MCP 服务器 
   
 
3. 企业级管理系统
 
   
 
    权限管理、审计日志 多租户架构 
   

 1. 从编码者到架构师 
   
 
    
更多时间设计系统架构
 
    
专注于业务逻辑和用户体验
 
    
掌握 AI 工具的最佳实践
 
   
 
   
 
    
人机协作专家
 
   
 
   
 
    
学会如何与AI有效沟通
 
    
掌握提示工程技巧
 
    
理解 AI 的能力边界
 
   
 
   
 
    
质量和安全专家
 
   
 
   
 
    
AI 生成代码的审查能力
 
    
安全漏洞识别和防护
 
    
性能优化和监控 
 
   

# 1. 工作流程自动化 
   
 
    制定标准化开发流程 自动化重复性任务 建立质量检查卡点 
   
 
2. 知识管理体系
 
   
 
    建立个人技术知识库 记录最佳实践模板 分享团队经验 
   
 
3. 持续学习习惯
 
   
 
    每周尝试新功能 参与社区讨论 关注技术趋势 
   

 短期目标（6个月） 
   
 
    
[ ] 熟练使用Claude Code核心功能
 
    
[ ] 在团队中推广AI辅助开发
 
    
[ ] 建立个人最佳实践库
 
   
 中期目标（1年） 
   
 
    
[ ] 成为团队的AI工具专家
 
    
[ ] 开发自定义的开发工具
 
    
[ ] 在社区中分享经验
 
   
 长期目标（2-3年） 
   
 
    
[ ] 引领团队的技术转型
 
    
[ ] 成为行业内的意见领袖
 
    
[ ] 开发商业级AI工具产品 
 
   

claude # 启动交互模式 claude -p "任务描述" # 无头模式执行 claude --help # 显示帮助 claude --version # 显示版本 claude config list # 显示配置 

/init # 初始化项目 /clear # 清空会话 /compact # 压缩上下文 /help # 显示帮助 /agents # 代理管理 /bug # 报告问题 /install-github-app # 安装GitHub集成 

claude config set key value # 设置配置 claude config get key # 获取配置 claude config reset # 重置配置 claude mcp add server-name # 添加MCP服务器 claude mcp list # 列出MCP服务器 

# 项目名称 概述 项目简介和主要功能 技术栈 
   
 
    
前端：
 
    
后端：
 
    
数据库：
 
    
部署：
 
   
 项目结构 文件和目录说明 开发规范 代码风格和最佳实践 常用命令 开发、测试、部署命令 注意事项 特殊配置和已知问题

{ "model": "claude-sonnet-4", "auto_commit": false, "git": { "commit_style": "conventional" }, "code_style": { "formatter": "prettier", "linter": "eslint" } } 

#!/bin/bash 
.claude/hooks/format-code.sh
 if [[ "$TOOL_NAME" == "Edit" ]]; then npm run format fi

#!/bin/bash 
.claude/hooks/run-tests.sh
 if [[ "$TOOL_NAME" == "git commit" ]]; then npm test if [ $? -ne 0 ]; then echo "测试失败，阻止提交" exit 1 fi fi