Claude Code 最佳实践和使用技巧

# 使用 /init 命令自动生成
claude
> /init

# 或者手动创建并填充内容
touch CLAUDE.md

# 使用 /permissions 命令管理权限
> /permissions

# 或者通过命令行参数
claude --allowedTools Edit,Bash(git commit:*)

brew install gh

# 配置 GitHub 认证
gh auth login

# 1. 探索阶段 - 了解现有代码
"请阅读相关文件了解当前架构，但暂时不要编写代码"

# 2. 计划阶段 - 使用扩展思考（按两次 Shift+TAB 进入 PLAN 模式）
"请 ultrathink 并制定详细的实现计划，并指示 sub-agents 并行验证关键细节"

# 3. 编码阶段
"请按照计划实现功能"

# 4. 提交阶段
"请提交更改并创建 PR"

# 1. 编写测试
"请基于期望的输入输出编写测试，确保测试会失败"

# 2. 运行测试确认失败
"运行测试确认失败，不要编写实现代码"

# 3. 提交测试
"请提交测试代码"

# 4. 实现功能
"请编写代码使测试通过，不要修改测试"

# 5. 提交实现
"请提交实现代码"

# 1. 提供设计图
# 拖拽图片到 Claude Code 界面

# 2. 实现 UI
"请按照设计图实现界面"

# 3. 截图对比
"请截图当前实现，与设计图对比并改进"

# 4. 迭代优化
"请继续优化，直到效果满意"

// .mcp.json 示例
{
  "mcpServers": {
    "playwright": {
      "args": [
        "@playwright/mcp@latest",
        "--headless"
      ],
      "command": "npx"
    },
    "context7": {
      "args": [
        "-y",
        "@upstash/context7-mcp@latest"
      ],
      "command": "npx"
    }
  }
}

Please analyze and fix the Github issue: $ARGUMENTS.

Follow these steps:

# PLAN

1. Use 'gh issue view' to get the issue details
2. Understand the problem described in the issue
3. Ask clarifying questions if necessary
4. Understand the prior art for this issue
    - Search the scratchpads for previous thoughts related to the issue
    - Search PRs to see if you can find history on this issue
    - Search the codebase for relevant files
5. Think harder about how to break the issue down into a series of small, manageable tasks.
6. Document your plan in a new scratchpad
    - include the issue name in the filename
    - include a link to the issue in the scratchpad.

# CREATE
- Create a new branch for the issue
- Solve the issue in small, manageable steps, according to your plan.
- Commit your changes after each step.

# TEST
- Use puppeteer via MCP to test the changes if you have made changes to the UI
- Write unit tests to describe the expected behavior of your code
- Run the full test suite to ensure you haven't broken anything
- If the tests are failing, fix them
- Ensure that all tests are passing before moving on to the next step

# SUBMIT
- Push and open a PR on Github.

Remember to use the GitHub CLI ('gh') for all Github-related tasks.

> /issue 1234

# 使用文件引用
请参考 @src/components/UserProfile.tsx 的结构

# 压缩上下文
> /compact

# 清理上下文
> /clear

# 增加记忆
# <context>

# 恢复历史会话
/resume

# 续聊上次会话
claude --continue
claude --continue --print   # 适合脚本调用

# 从历史会话中选择再继续
claude --resume

# 项目开发路线图

## 开发流程

1. ** 任务规划 **
   - 分析现有代码基础
   - 更新 ROADMAP.md 添加新任务
   - 优先级任务插入到最后完成任务之后

2. ** 任务创建 **
   - 在 `/tasks` 目录创建详细任务文件
   - 命名格式：`XXX-description.md`
   - 包含规格说明、相关文件、验收标准

3. ** 任务实现 **
   - 按照任务文件中的步骤实现
   - 每完成一步更新任务文件进度
   - 每步完成后暂停等待进一步指令

## 任务列表

### 已完成 ✅
- **任务 001: 数据库架构** ✅
  - 参考: `/tasks/001-database.md`
  - 实现了核心表结构和关系

### 进行中 🔄
- ** 任务 002: 用户界面 ** 🔄
  - 参考: `/tasks/002-ui.md`
  - 正在实现登录和注册页面

### 计划中 📋
- ** 任务 003: API 接口 **
  - 设计 RESTful API
  - 实现用户认证

# 任务 XXX: 功能描述

## 进度摘要

**状态**: 未开始

- [ ] 步骤 1: 创建组件
- [ ] 步骤 2: 实现逻辑
- [ ] 步骤 3: 编写测试
- [ ] 步骤 4: 集成验证

## 概述

详细描述功能需求和预期效果。

## 当前状态分析

分析现有代码基础和相关文件。

## 目标状态

描述完成后的期望状态。

## 实现步骤

### 步骤 1: 创建组件
详细描述第一步需要做什么。

** 涉及文件:**
- `src/components/NewComponent.tsx`
- `src/types/index.ts`

### 步骤 2: 实现逻辑
详细描述第二步需要做什么。

## 验收标准

### 功能要求
- [ ] 功能 A 正常工作
- [ ] 功能 B 正常工作

### 技术要求
- [ ] 通过所有测试
- [ ] 代码符合规范
- [ ] 性能满足要求

## 相关文件

### 新建文件
- `src/components/NewComponent.tsx`
- `src/utils/helper.ts`

### 修改文件
- `src/app/page.tsx`
- `src/types/index.ts`

## 注意事项

- 保持向后兼容性
- 确保响应式设计
- 考虑无障碍性

git worktree add -b feature-x ../feature-x
cd ../feature-x
claude --resume   # 在新终端继续上下文

# 不好的指令
"给 foo.py 添加测试"

# 好的指令
"为 foo.py 编写新的测试用例，覆盖用户登出的边界情况，避免使用 mock"

# 激活不同级别的思考
"think 并分析问题"          # 基础思考
"think hard 制定计划"       # 深度思考
"think harder 优化方案"     # 更深思考
"ultrathink 并制定详细计划"  # 最深思考

# 让 Claude 管理 Git 操作
"请查看当前更改并提交"
"请创建新分支实现 feature-x"
"请基于当前更改创建 PR"
"请解决合并冲突"

# 跳过所有权限确认
claude --dangerously-skip-permissions

# 设置别名方便使用
alias cc="claude --dangerously-skip-permissions"

# 生成 ESLint 报错清单
claude -p "运行 eslint 并把所有错误输出成 Markdown checklist"

claude -p "分析代码并生成测试报告"

# JSON 输出
claude -p "分析代码并生成测试报告" --output-format json

# 自动化代码审查
claude -p "审查当前 PR 中的代码变更"

# 提供数据
cat build-error.txt | claude -p 'concisely explain the root cause of this build error'

# 探索代码库的并行任务
"使用 4 个并行任务探索代码库，每个代理探索不同的目录"

# 批量处理子任务
"开始一项研究，使用 6 个并行任务将所有仓库更新为使用 Bun。其中一个任务用于网络搜索，获取针对 Nexts、服务器和包的最佳实践，另外 5 个任务用于规划如何迁移我们现有的 5 个包，制定完整的迁移计划并将其写入 PLAN.md 文件。"

# 适合的应用场景
"并行运行不同的测试套件"
"同时分析多个日志文件"
"批量处理多个配置文件"

# 创建功能分支工作区
git worktree add -b feature-auth ../auth-workspace
git worktree add -b feature-payment ../payment-workspace
git worktree add -b feature-admin ../admin-workspace

# 在各工作区启动 Claude
cd ../auth-workspace && claude --resume
cd ../payment-workspace && claude --resume
cd ../admin-workspace && claude --resume