Claude Code 完全使用指南

# 在项目目录中启动
cd your-project
claude
​
# 指定初始提示
claude "帮我重构这个函数"
​
# 非交互模式（一次性任务）
claude -p "解释这个项目的架构"
​
# 从文件读取提示
claude -p "$(cat prompt.txt)"
​
# 管道模式
cat error.log | claude -p "分析这个错误日志"

# 插件管理
claude plugin list                  # 列出已安装插件
claude plugin install <name>        # 安装插件
claude plugin uninstall <name>      # 卸载插件
claude plugin update                # 更新所有插件
claude plugin marketplace list      # 列出市场
claude plugin marketplace add <repo> # 添加市场
​
# 配置管理
claude config set <key> <value>     # 设置配置项
claude config get <key>             # 查看配置项
​
# 会话管理
claude --resume                     # 恢复上次会话
claude --continue                   # 继续最近的会话
​
# 更新
claude update                       # 更新 Claude Code 本身

# 

"重构 @src/utils/helper.ts 中的 parseDate 函数，使其支持 ISO 8601 格式"
"查看 @UserService 类的所有调用方"

# 分析测试失败
npm test 2>&1 | claude -p "分析这些测试失败并给出修复建议"
​
# 审查 git 变更
git diff HEAD~5 | claude -p "审查这些变更，重点关注安全问题"

# 全局配置
- 永远使用中文回复
- 遵循函数式编程风格
- 优先使用 TypeScript 严格模式

# 项目名称
​
## 架构概述
- 前端：React 18 + TypeScript + TailwindCSS
- 后端：FastAPI + PostgreSQL
- 测试：Vitest + Playwright
​
## 编码规范
- 使用 Prettier 格式化（配置在 .prettierrc）
- 提交信息遵循 Conventional Commits
- 所有公共 API 必须有 JSDoc 注释
​
## 常用命令
- 开发：npm run dev
- 测试：npm test
- 构建：npm run build

# 自动分析项目并生成 CLAUDE.md
/init
​
# 手动触发更新
"帮我更新 CLAUDE.md 以反映最近的架构变更"

CLAUDE.md        → 每会话加载，存放项目规范和个人偏好
MEMORY.md        → 索引文件，指向具体记忆
~/.claude/memory/ → 持久化记忆文件，跨会话保留

# 保存重要发现
"记住：这个项目的身份验证使用 JWT + Refresh Token 模式"

# 保存偏好
"以后回复时永远使用中文"

# 打开权限管理面板
/permissions

# 添加信任目录（跳过确认）
/add-permissions /home/user/my-project

# 在 settings.json 中配置
"帮我把 npm 命令添加到白名单"

# 查看当前模型
/model

# 切换模型
/model opus
/model sonnet

# 拖拽图片到终端即可分析
"分析这张截图中的 UI 问题"

# 分析 PDF 文档
"总结这个 PDF 的关键内容"

# 分析 Excel/CSV 数据
"分析 sales.csv 中的销售趋势"

# 每 5 分钟检查一次部署状态
/loop 5m "检查 vercel 部署是否完成"

# 每 10 分钟运行一次（默认间隔）
/loop "检查 CI 状态"

# 停止循环
/loop stop

1. /brainstorm → 理清需求和方案
2. /plan → 制定详细实施计划
3. 编码实现
4. /verify → 验证功能
5. /commit → 提交变更
6. /commit-push-pr → 创建 PR
7. /review-pr → 全面审查

1. 描述需求 → Claude 生成测试
2. 运行测试 → 确认失败（红）
3. Claude 实现代码 → 确认通过（绿）
4. Claude 重构优化（重构）

# 新功能在独立分支开发
git checkout -b feature/xxx

# 频繁提交，有意义的消息
/commit   # 自动生成符合规范的 commit 信息

# 完成后一键 PR
/commit-push-pr

# 合并后清理
/clean_gone

# 一键触发所有审查
/pr-review-toolkit:review-pr all

# 针对性审查
/pr-review-toolkit:review-pr tests errors

# 在 CLAUDE.md 中描述架构
## 模块职责
- src/api/       → HTTP 请求层，使用 Axios
- src/stores/    → 状态管理，使用 Zustand
- src/components/→ UI 组件，使用 React + Tailwind
- src/hooks/     → 自定义 Hooks
- src/utils/     → 工具函数

# 添加市场
claude plugin marketplace add <github-user>/<repo> --scope user

# 列出市场
claude plugin marketplace list

# 在市场内搜索插件
claude plugin search <keyword>

# 从市场安装插件
claude plugin install <plugin-name>@<marketplace-name>

安装 → 会话加载 → 可用 → 更新/卸载

# 查看已安装
claude plugin list

# 安装
claude plugin install <name>@<market> --scope user

# 卸载
claude plugin uninstall <name>

# 更新全部
claude plugin update

# 开启/关闭
/plugin  # 打开管理面板，可切换启用/禁用

# 开发新功能前
/brainstorm 用户登录系统改造

# 制定计划
/plan

# 编码时自动触发 TDD 和调试

# 完成后
"帮我审查刚才的修改"
# → 自动触发 requesting-code-review

"帮我创建一个登录页面"
"设计一个仪表盘 UI"
"做个响应式导航栏"
"创建一个产品展示页面"

# 编码时自动应用，也可手动触发
"按照 Karpathy 的准则帮我重构这个函数"

# 完全自动 —— 当你编辑文件时：
"帮我在登录接口添加用户输入处理"
# → security-guidance 自动检查是否有 SQL 注入、XSS 等问题并给出警告

# 修改代码后
/commit

# Claude 会：
# 1. 分析 git diff 变更
# 2. 查看最近提交历史以匹配风格
# 3. 生成符合 Conventional Commits 规范的消息
# 4. 自动暂存并提交
# 5. 避免提交敏感文件（.env、证书等）

# 开发完成后
/commit-push-pr

# Claude 会：
# 1. 如果当前在 main 分支，自动创建 feature 分支
# 2. 分析整个分支的所有提交
# 3. 创建提交
# 4. 推送到 origin
# 5. 使用 gh pr create 创建 PR（含摘要和测试计划）
# 6. 返回 PR 链接

# 前置要求：
# - 安装 GitHub CLI：winget install GitHub.cli
# - 认证：gh auth login

# 合并几个 PR 后
/clean_gone

# Claude 会：
# 1. 找到所有标记为 [gone] 的分支
# 2. 清理关联的 Worktree
# 3. 删除本地过期分支
# 4. 报告清理结果

# 全量审查（默认）
/pr-review-toolkit:review-pr

# 针对性审查
/pr-review-toolkit:review-pr tests errors    # 只查测试和错误处理
/pr-review-toolkit:review-pr comments        # 只查注释
/pr-review-toolkit:review-pr simplify        # 只做代码简化
/pr-review-toolkit:review-pr types           # 只查类型设计

# 并行审查（更快）
/pr-review-toolkit:review-pr all parallel

开发中 → code-reviewer（代码审查）
  ↓
写测试后 → pr-test-analyzer（测试完整性）
  ↓
加注释后 → comment-analyzer（注释准确性）
  ↓
新增类型后 → type-design-analyzer（类型设计）
  ↓
加错误处理后 → silent-failure-hunter（静默失败）
  ↓
审查通过后 → code-simplifier（打磨优化）
  ↓
创建 PR → /commit-push-pr

# 写项目文档
"帮我写一份 API 使用文档"

# 处理 Word 文件
"分析这个 .docx 文件并提取摘要"（拖入文件）

# 构建 MCP 服务
/mcp-builder

# 写内部公告
/internal-comms 产品发布公告

# Claude API 问题（自动触发）
"用 Python 调用 Claude API，怎么做流式输出？"
# → 自动加载 claude-api 技能提供准确示例

"帮我回忆一下，我们上周处理的那个 JWT 认证问题是怎么解决的？"
# → 搜索历史会话，找到相关讨论

"分析我最近的对话，找出值得长期记住的经验"
# → 读取历史对话，识别有价值的见解，建议保存到 CLAUDE.md 或 MEMORY.md

"分析我的 Token 使用情况"
# → 生成交互式 HTML 仪表盘，展示缓存命中率、工作流模式、消费趋势

# 场景 1：忘了之前的决策
"上周我们为什么选择了 PostgreSQL 而不是 MongoDB？"
# → recall-conversations 找到当时讨论的上下文

# 场景 2：积累项目知识
"扫描最近的对话，把重要的架构决策记录下来"
# → extract-learnings 分析并建议存入 MEMORY.md

# 场景 3：优化使用习惯
"看看我的 token 消耗合理吗？"
# → get-token-insights 生成分析报告

上午开工
  └→ claude（启动会话）
     └→ Claude Memory 自动注入昨日上下文
        └→ "继续昨天的工作，完善用户模块的单元测试"

编码中
  └→ 写代码
  └→ /code-review（快速审查）
  └→ 修改问题
  └→ /commit（提交代码）

功能完成
  └→ /pr-review-toolkit:review-pr all（全面审查）
  └→ 修复关键问题
  └→ /commit-push-pr（创建 PR）
  └→ /clean_gone（清理分支）

收到 Bug 报告
  └→ "帮我在 @src/services/order.ts 中排查这个 bug：下单时偶发金额计算错误"

定位问题
  └→ Claude 分析代码、搜索调用链
  └→ 找到根因后："这个修复方案可行吗？"

修复验证
  └→ Claude 修复代码
  └→ /verify（验证修复）
  └→ Security Guidance 自动检查安全问题
  └→ /pr-review-toolkit:review-pr errors code（审查修复）
  └→ /commit（提交修复）

/brainstorm 用户积分系统设计
  └→ 探索需求、约束、技术方案

/plan
  └→ 生成详细实施计划

编码实现（Claude 逐步实现）
  └→ 数据模型 → type-design-analyzer
  └→ API 接口 → silent-failure-hunter
  └→ 业务逻辑 → code-reviewer
  └→ 前端页面 → frontend-design
  └→ 测试用例 → pr-test-analyzer

完成
  └→ /pr-review-toolkit:review-pr all
  └→ /commit-push-pr

作为 Reviewer
  └→ 拿到 PR 链接
  └→ /review-pr <pr-url>
     └→ Claude 自动触发 6 个审查代理
     └→ 汇总：严重问题 / 重要问题 / 建议
  └→ 根据报告给出 review 意见

作为 Author
  └→ 收到 review 意见
  └→ Claude 辅助修复
  └→ 重新运行针对性审查
  └→ 推送更新

# 确认是否安装
npm list -g @anthropic-ai/claude-code

# 重新安装
npm install -g @anthropic-ai/claude-code

# 或更新
claude update

# 不要在 Claude Code 会话内执行，改用终端：
claude plugin marketplace add <user>/<repo> --scope user

# 注意：--scope 和 user 之间用空格，不要用 =

# 临时禁用某个插件
/plugin → 找到插件 → 切换为 disabled

# 卸载插件
claude plugin uninstall <plugin-name>

# 添加目录到信任列表
/add-permissions /path/to/project

# 或在 settings.json 中配置白名单

# 审查安全警告，大部分是真实问题
# 如果确认安全，可以忽略特定警告
# 不建议全局禁用 security-guidance 插件

# 安装 GitHub CLI
winget install GitHub.cli

# 认证
gh auth login

# 确认仓库有 remote
git remote -v

# 确认有文件变更
git status

# 检查 .gitignore 是否屏蔽了需要的文件

# 使用 get-token-insights 分析
"分析我的 token 使用情况"

# 优化 CLAUDE.md，精简内容
# 使用 /fast 模式
# 选择合适的模型（简单任务用 Haiku）

第 1 天：基础交互
  └→ 启动会话 → 简单代码修改 → 理解权限系统
​
第 2-3 天：核心命令
  └→ /init → CLAUDE.md → /commit → /review
​
第 1 周：插件生态
  └→ 安装常用插件 → 体验自动触发 → 理解工作流
​
第 2 周：深度使用
  └→ 自定义 CLAUDE.md → TDD 开发 → 多插件协作
​
第 3 周+：高级技巧
  └→ 自定义技能 → 工作流编排 → 子代理并行