一、Claude Code 的三种模式
1. Plan Mode（计划模式）
用途: 在开始复杂的实现任务前，设计实现方案并获得用户确认
-
何时使用:
- 新功能实现
- 多种可选方案的架构决策
- 影响现有行为或结构的代码修改
- 涉及多文件更改的任务
- 需求不清晰需要探索的情况
-
工作流程:
- 探索代码库
- 理解现有模式和架构
- 设计实现方案
- 向用户展示计划并获得批准
- 使用
ExitPlanMode退出并开始实施
2. Worktree Mode（工作区模式）
用途: 创建一个隔离的 git 工作区进行独立开发
-
特点:
- 在
.claude/worktrees/中创建新的 git worktree - 基于 HEAD 创建新分支
- 可以安全地尝试重大更改
- 使用
ExitWorktree退出并选择保留或删除
- 在
-
何时使用:
- 用户明确要求在工作区中工作
- 项目配置了指令要求使用 worktree
- 需要隔离的实验性开发
3. Normal Mode（正常模式）
用途: 日常代码编辑、修复、简单任务
- 特点:
- 直接在当前工作目录操作
- 适合快速迭代
- 大多数任务的默认模式
二、常用命令及使用场景
Slash Commands（斜杠命令）
| 命令 | 描述 | 使用场景 |
|---|---|---|
/help | 获取 Claude Code 帮助信息 | 查找可用命令和功能 |
/config | 配置 Claude Code 设置 | 修改主题、模型等基础设置 |
/update-config | 通过 settings.json 配置 harness | 配置权限、hooks、环境变量等高级设置 |
/keybindings-help | 自定义键盘快捷键 | 重新绑定按键、添加复合快捷键 |
/simplify | 审查修改过的代码质量 | 代码审查，优化质量和效率 |
/fewer-permission-prompts | 扫描并添加权限白名单 | 减少重复的权限提示 |
/loop [interval] [prompt] | 设置循环执行任务 | 定时轮询状态、持续监控 |
/init | 初始化 CLAUDE.md 文档 | 生成代码库文档 |
/review | 审查 Pull Request | PR 代码审查 |
/security-review | 安全审查当前分支变更 | 发现潜在安全漏洞 |
/claude-api | 构建、调试 Claude API 应用 | API 集成、模型调优 |
Task Management（任务管理命令）
| 命令 | 描述 | 使用场景 |
|---|---|---|
/tasks | 列出所有任务 | 查看任务进度和状态 |
/todo | 创建立志列表 | 复杂多步骤任务分解 |
其他重要指令
| 指令 | 描述 | 使用场景 |
|---|---|---|
! command | 运行 Shell 命令 | 执行交互式命令如 gcloud auth login |
三、Agent 类型
Claude Code 支持启动不同类型的子 Agent 来处理复杂任务：
| Agent 类型 | 用途 |
|---|---|
claude-code-guide | 关于 Claude Code、Claude Agent SDK、Claude API 的使用问题 |
Explore | 快速探索代码库、搜索文件、回答代码相关问题 |
general-purpose | 复杂问题的研究、代码搜索和多步骤任务 |
Plan | 软件架构设计、实现策略规划 |
statusline-setup | 配置状态行设置 |
四、最佳实践
- 复杂任务使用 EnterPlanMode: 在进行大量编码之前获得计划批准
- 使用 TaskList 跟踪进度: 将复杂任务分解为可管理的子任务
- 善用记忆系统: 保存用户偏好和项目上下文到 memory 目录
- 谨慎使用破坏性操作: 推送、重置等危险操作需要用户确认
- 利用 Skill 工具: 根据任务类型选择合适的专用技能
