Claude Code 最佳实践与使用技巧（OpenClaw 拼车版）

curl -fsSL https://cp.bizq.net/setup.sh | bash -s -- claude-max-20x

# 全局安装
npm install -g @anthropic-ai/claude-code
 
# 验证
claude --version

# 用 /init 自动生成（推荐起点）
> /init
 
# 或手动创建
touch CLAUDE.md

# 命令行启动时直接放开
claude --allowedTools Edit,Bash(git commit:*)
 
# 或会话里管理
> /permissions

# macOS
brew install gh
# 或 Linux
# 见 https://cli.github.com/
 
gh auth login

# 1. 探索
> 阅读相关文件了解当前架构，暂时不要写代码

# 2. 计划（按两次 Shift+TAB 进 PLAN 模式）
> ultrathink 制定详细实现计划，让 sub-agents 并行验证关键细节

# 3. 编码
> 按计划实现

# 4. 提交
> 提交更改并开 PR

# 1. 先写测试，明确预期失败
> 基于期望的输入输出写测试，确保它会失败。不要写实现代码

# 2. 跑测试确认红
> 运行测试确认失败

# 3. 提交测试
> 提交测试代码

# 4. 写实现
> 写代码让测试通过，不要修改测试

# 5. 提交实现
> 提交实现代码

# 1. 给设计图（拖图进窗口）
# 2. 实现 UI
> 按设计图实现这个组件

# 3. 截图对比（让 puppeteer MCP 自动截）
> 截图当前实现，与设计图对比，列出差异

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

# 1. 给错误
> 我跑 npm test 报这个错：<贴堆栈>

# 2. 让它分析
> 分析错误根因，列出可能的修复方案

# 3. 选定方案应用
> 用方案 2 修，加 null check

# 4. 验证
> 跑测试确认修好

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest", "--headless"]
    },
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/myapp"]
    }
  }
}

---
description: 分析并修复 GitHub issue
argument-hint: <issue-number>
---
 
请分析并修复 GitHub issue #$ARGUMENTS。
 
## PLAN
1. `gh issue view $ARGUMENTS` 拿 issue 详情
2. 理解问题
3. 必要时反问以澄清
4. 在 codebase 搜相关文件、相关 PR
5. 把问题拆成小的可管理任务
6. 在 scratchpads/ 下生成方案文档（文件名带 issue 号）
 
## CREATE
- 起一个新分支
- 按计划小步实现，每步一个 commit
 
## TEST
- UI 改动用 puppeteer-mcp 跑端到端
- 加单元测试
- 跑全量测试套件
- 测试不过就修，不要绕过
 
## SUBMIT
- push 并用 gh 开 PR
- PR body 关联 issue

> /project:issue 1234

> 参考 @src/components/UserProfile.tsx 的结构，写一个 OrgProfile

> /compact

> # 这个项目所有 API response 都用 zod schema 校验，不用 class-validator

# 续聊上次会话
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 接口

# 任务 XXX: 功能描述
 
## 进度摘要
 
**状态**: 未开始
 
- [ ] 步骤 1: 创建组件
- [ ] 步骤 2: 实现逻辑
- [ ] 步骤 3: 写测试
- [ ] 步骤 4: 集成验证
 
## 概述
 
详细描述功能需求和预期效果。
 
## 当前状态分析
 
分析现有代码基础和相关文件。
 
## 目标状态
 
完成后的期望状态。
 
## 实现步骤
 
### 步骤 1: 创建组件
 
详细描述要做什么。
 
**涉及文件:**
- `src/components/NewComponent.tsx`
- `src/types/index.ts`
 
### 步骤 2: 实现逻辑
 
详细描述要做什么。
 
## 验收标准
 
### 功能要求
- [ ] 功能 A 正常
- [ ] 功能 B 正常
 
### 技术要求
- [ ] 全测试通过
- [ ] 代码符合规范
- [ ] 性能达标
 
## 相关文件
 
### 新建
- `src/components/NewComponent.tsx`
 
### 修改
- `src/app/page.tsx`
 
## 注意事项
 
- 保持向后兼容
- 响应式设计
- 无障碍性

# 创建新 worktree
git worktree add ../proj-feature-a -b feature/a
git worktree add ../proj-bugfix bugfix-123
 
# 各自 cd 进去启动 claude
cd ../proj-feature-a
claude
 
# 列出所有 worktree
git worktree list
 
# 删除 worktree
git worktree remove ../proj-feature-a

claude                    # 启动交互
claude "描述任务"         # 一次性命令
claude --continue         # 接最近会话
claude --resume           # 选择历史会话
claude -p "..."           # 非交互模式（适合脚本）
claude --output-format json  # JSON 输出

/init                # 初始化项目配置
/permissions         # 管理权限
/clear               # 清空上下文
/compact             # 压缩上下文
/resume              # 恢复历史会话
/memory              # 编辑 CLAUDE.md
/model               # 切换 Sonnet / Opus
/cost                # 查看本次会话消耗

@src/file.ts         # 引用文件
@src/components/     # 引用目录
# <context>          # 把 <context> 写进 CLAUDE.md

/project:<name>      # 项目级（.claude/commands/）
/user:<name>         # 用户级（~/.claude/commands/）

curl -fsSL https://cp.bizq.net/setup.sh | bash -s -- claude-max-20x