一、安装与启动

多平台安装方式

# macOS / Linux（官方推荐，零依赖，自动更新）
curl -fsSL https://claude.ai/install.sh | bash

# Windows（推荐 winget）
winget install Anthropic.ClaudeCode

# Windows 备选（需要 Node.js >= 18）
npm install -g @anthropic-ai/claude-code@latest

# 验证安装
claude --version

# 启动（在项目目录下）
cd your-project
claude

首次认证

启动后会提示选择登录方式：

• 选项 1：Claude 订阅账号（Pro / Max / Team / Enterprise）
• 选项 2：Anthropic Console API 账号（按量付费）
• 选项 3：第三方平台（AWS Bedrock / Google Vertex / Microsoft Foundry）

---

二、核心交互模式

三种模式：按 Shift + Tab 切换

模式	图标	特点	适用场景
Normal	>	每步操作需确认	初次使用、关键代码修改
Auto-accept	*>	自动执行读写和命令	批量重构、信任度高的任务
Plan	#>	只分析不写文件	需求规划、架构设计、代码审查

模式使用策略

复杂需求的正确流程： Plan 模式出方案 → 确认方案 → 切 Normal/Auto 模式执行 → 验证结果 

切记：不要在 Auto-accept 模式下给模糊指令，它会直接动手，可能改错文件。

---

三、必会命令大全

核心斜杠命令

命令	作用	使用时机
/init	生成 CLAUDE.md 项目知识库	新项目第一次启动时
/clear	清空对话上下文	切换任务时必用
/compact	压缩上下文保留核心信息	对话太长 Token 快满时
/model	切换模型（d 设为默认）	需要更强/更便宜模型时
/skills	查看和管理已加载技能	检查 superpowers 是否生效
/plugins	管理插件	安装/查看/配置插件
/doctor	诊断环境问题	遇到奇怪报错时
/cost	查看当前会话消耗	控制成本
/resume	恢复上一次会话	中断后继续工作

文件引用技巧

# 直接引用文件（无需手动粘贴内容）
分析一下 @src/main.go 的代码质量

# 引用多个文件
对比 @config/dev.yaml 和 @config/prod.yaml 的差异

# 引用目录
查看 @src/api/ 目录下所有路由文件

快捷操作

快捷键	作用
Shift + Tab	切换模式
q / Esc	退出当前菜单（IDEA 终端用 q）
Ctrl + C	中断当前操作
Ctrl + L	清屏
↑ / ↓	浏览历史输入

---

四、安装 Superpowers 插件

# 启动 Claude Code 后
/plugin install superpowers@claude-plugins-official
/reload-plugins

# 验证
/skills
# 应该看到 14 个 superpowers:* 技能全部为 on

五、Superpowers 14 个技能详解

1. 需求规划阶段

技能	触发场景	作用
brainstorming	需求不明确、需要讨论方案	头脑风暴，探索多种技术方案
writing-plans	方案确定后，需要开发计划	拆解任务，生成分步开发计划

2. 编码开发阶段

技能	触发场景	作用
test-driven-development	用 TDD 方式开发	先写测试 → 写实现 → 跑测试 → 重构
subagent-driven-development	大型功能开发	启动多个子 agent 并行开发不同模块
dispatching-parallel-agents	互不依赖的多个任务	并行分发任务，提高效率

3. 审查与验证阶段

技能	触发场景	作用
requesting-code-review	代码写完后请求审查	自动分析代码质量、潜在 bug
receiving-code-review	收到审查反馈后	按反馈逐条修改代码
verification-before-completion	任务即将完成前	运行测试、检查 lint、验证完整性

4. 调试阶段

技能	触发场景	作用
systematic-debugging	遇到 bug 或报错	系统化分析 → 定位 → 修复 → 验证

5. 分支与版本管理阶段

技能	触发场景	作用
using-git-worktrees	需要并行开发多个功能	使用 git worktree 隔离工作区
finishing-a-development-branch	功能开发完成	整理 commit、创建 PR、清理分支

6. 元技能

技能	作用
using-superpowers	教 Claude 如何正确使用其他技能
writing-skills	创建自定义技能，扩展能力

---

六、完整项目开发流程（Superpowers 驱动）

以「从零开发一个 Go 微服务项目」为例：

第一步：项目初始化与规划

mkdir my-service && cd my-service 

claude 

# Plan 模式下（Shift + Tab 切换）
我想开发一个 Go 微服务，使用 Gin 框架 + GORM + PostgreSQL，
实现用户注册、登录、JWT 认证和 CRUD 接口。
请先用 brainstorming 分析技术方案，再用 writing-plans 制定详细的开发计划。

Claude 会：

1. 1.调用 brainstorming — 列出多种方案并比较优劣
2. 2.调用 writing-plans — 生成分步开发计划，明确每个阶段的任务

第二步：脚手架搭建

/init
按照计划，创建项目目录结构、go.mod、Dockerfile、docker-compose.yml
和基础配置文件。

生成 CLAUDE.md 后，Claude 会记住项目规范。

第三步：TDD 驱动开发（核心）

# 切回 Normal 或 Auto-accept 模式 用 test-driven-development 方式开发用户注册接口：

1. 先写测试用例（覆盖正常注册、重复邮箱、参数校验）

2. 写实现代码

3. 跑测试确保全部通过 

Claude 会自动执行 TDD 循环：

写测试 → 运行测试（预期失败）→ 写实现 → 运行测试 → 重构 → 最终验证 

第四步：并行开发多个模块

用 dispatching-parallel-agents 并行开发以下三个互不依赖的模块：
1. 用户登录 + JWT 中间件
2. CRUD 接口（创建、列表、详情、更新、删除）
3. 请求日志中间件 + 错误处理
每个模块都要用 TDD 方式。

Claude 会派出多个子 agent 同时工作，大幅提升效率。

第五步：系统化调试

跑一下集成测试，如果报错用 systematic-debugging 自动修复。 

Claude 会按照 诊断 → 假设 → 验证 → 修复 的系统化流程排查问题。

第六步：代码审查

用 requesting-code-review 审查所有新增代码，重点关注：
- SQL 注入风险
- 错误处理是否完善
- 并发安全问题
- 测试覆盖率

审查完成后：

用 receiving-code-review 按照审查结果逐条修复。 

第七步：验证与交付

用 verification-before-completion 做最终验证：
- 所有测试通过
- lint 无报错
- docker-compose 能正常启动
- API 文档生成完成

第八步：分支完成

用 finishing-a-development-branch：
- 整理 commit 历史
- 生成 changelog
- 准备 PR 描述

---

七、日常高频工作流速查

场景速查表

场景	你说的话	自动触发
需求分析	"帮我分析一下这个需求"	brainstorming
制定计划	"帮我规划开发步骤"	writing-plans
写新功能	"用 TDD 方式写 xxx"	test-driven-development
修 Bug	"这个报错帮我看看"	systematic-debugging
代码审查	"review 一下这周的改动"	requesting-code-review
完成任务	"这个功能做完了，验证一下"	verification-before-completion
并行开发	"这几个模块互不影响，并行开发"	dispatching-parallel-agents
切分支	"开个新分支做这个功能"	using-git-worktrees
提交代码	"整理 commit 准备提 PR"	finishing-a-development-branch

---

八、避坑指南（补充）

问题	解决方案
Token 消耗过快	定期 /compact，切换任务用 /clear
AI 改错文件	用 Normal 模式，每次确认 diff
上下文混乱	一个会话只做一件事
测试跑不起来	先 /init 让它理解项目结构
插件报 not cached	更新到 v2.1.144+，已修复此 bug
IDEA 终端 Esc 无效	按 q 代替，或用外部终端
并行 agent 失败	确保任务之间没有文件依赖
Claude 不触发 superpowers	确认 /skills 里 14 个技能全部为 on

---

九、自定义 CLAUDE.md 示例

在项目根目录创建 CLAUDE.md，规范 Claude 的行为：

# 项目规范

## 技术栈
- Go 1.22 + Gin + GORM + PostgreSQL
- Docker 部署

## 代码规范
- 错误处理必须用 %w 包装
- 所有公共函数必须有 godoc 注释
- 数据库操作必须在 repository 层
- 不允许在 handler 层写业务逻辑

## 测试要求
- 单元测试覆盖率 > 80%
- 使用 testify 断言
- Mock 外部依赖用 gomock

## Git 规范
- commit message 使用 conventional commits 格式
- 每个 PR 不能超过 500 行改动

有了这个文件，Claude 每次启动都会遵守这些规范。