Claude Code 全方位使用手册

水煮白菜王2026-05-10 8:24

🤖 作者简介：水煮白菜王，一个web开发工程师 👻

👀 文章专栏： 前端专栏 ，记录一下平时在博客写作中，总结出的一些开发技巧、记录和知识归纳总结✍。

✍本文内容来源于网络公开资源的整理与再创作

感谢支持💕💕💕

Claude Code 全方位使用手册：命令速查指南


核心价值 ：Claude Code 的强大之处在于将命令、模型、记忆、模式串联成一条流畅的流水线------开发者只需把控方向，执行细节交由 AI 完成。
Claude Code 全方位使用手册
核心价值
命令、模型、记忆、模式 流水线
常用命令
claude --version
claude
claude /path
claude update
界面与模式
Default 默认模式
Auto-Accept 自动接受
Plan Mode 计划模式
Shift+Tab 切换
Ctrl+C 中断
Ctrl+B 后台
ESC 返回
常用指令速查
/compact 压缩上下文
/clear 清空历史
claude -c 恢复对话
Ctrl+B 后台任务
↓ / /tasks 管理后台
Ctrl+T 任务面板
Ctrl+G 编辑计划文件
Alt+V 粘贴图像
/memory 编辑记忆
/init 生成记忆初稿
/hooks 配置钩子
Shift+Tab 切换模式
命令行输入
/add-dir 设定工作目录
/init 初始化项目记忆
/help 查看命令列表
/clear 清除对话历史
/compact 压缩对话
/memory 编辑记忆文件
/status 会话状态
/cost token费用
/config 查看/修改配置
/model 切换AI模型
/doctor 环境健康检查
记忆体系
项目记忆（Project）
./CLAUDE.md
项目专属规则和约定
用户记忆（User）
~/.claude/CLAUDE.md
个人全局习惯
自动记忆（Auto）
Claude 自动识别并写入
模型管理
Default 默认模型
Sonnet 均衡，日常编码
Opus 最强，复杂架构
Haiku 最快，简单问答
思考力度 low/medium/high
/fast 快速模式（Opus）
进阶实战工作流
第一步："建立项目记忆" -> /init + /memory
第二步："理解代码结构" -> Plan Mode
第三步："规划新功能" -> Plan Mode + Opus
第四步："分模块执行" -> Auto-Accept + 后台任务
第五步："性能分析与优化" -> Plan Mode 审视
第六步："收尾与记忆沉淀" -> /memory 写入经验
模式与模型选型原则
只读分析 → Plan Mode + Opus
日常编码 → Default + Sonnet
重复性修改 → Auto-Accept + Sonnet/Haiku
快速问答 → Default + Haiku
核心总结
Plan Mode 想清楚 → Auto-Accept 执行 → /compact /clear 管理上下文 → /memory 沉淀经验

目录

  • [Claude Code 全方位使用手册：命令速查指南](#Claude Code 全方位使用手册：命令速查指南)
    • [1. Claude 常用命令](#1. Claude 常用命令)
    • [2. Claude Code 界面说明](#2. Claude Code 界面说明)
    • [3. Claude 常用指令速查](#3. Claude 常用指令速查)
    • [4. Claude Code 的命令行输入](#4. Claude Code 的命令行输入)
      • [4.1 `/init` -- 初始化项目记忆指南](#4.1 /init – 初始化项目记忆指南)
      • [4.2 `/help` -- 查看命令列表](#4.2 /help – 查看命令列表)
      • [4.3 `/clear` -- 清除对话历史](#4.3 /clear – 清除对话历史)
      • [4.4 `/compact` -- 压缩对话内容](#4.4 /compact – 压缩对话内容)
      • [4.5 `/memory` -- 编辑会话记忆文件](#4.5 /memory – 编辑会话记忆文件)
      • [4.6 `/status` -- 会话状态检查](#4.6 /status – 会话状态检查)
      • [4.7 `/cost` -- token 费用统计](#4.7 /cost – token 费用统计)
      • [4.8 `/config` -- 查看或修改配置](#4.8 /config – 查看或修改配置)
      • [4.9 `/model` -- 切换 AI 模型版本](#4.9 /model – 切换 AI 模型版本)
      • [4.10 `/doctor` -- 环境健康检查](#4.10 /doctor – 环境健康检查)
    • [5. Claude Code 进阶实战指南](#5. Claude Code 进阶实战指南)
      • [5.1 核心理念](#5.1 核心理念)
      • [5.2 一套完整的开发工作流](#5.2 一套完整的开发工作流)
      • [5.3 模式与模型的选用原则](#5.3 模式与模型的选用原则)
      • [5.4 一句话总结](#5.4 一句话总结)
    • [如果你觉得这篇文章对你有帮助，请点赞 👍、收藏 👏 并关注我！👀](#如果你觉得这篇文章对你有帮助，请点赞 👍、收藏 👏 并关注我！👀)

只读分析
需要修改
复杂/重构
日常编码
简单/批量
《Claude Code 全方位使用手册》
基础使用
进阶实战 (5)

  1. 常用命令
  2. 界面与三种模式
  3. 常用指令速查
  4. 命令行输入 (斜杠命令)
    claude / claude --version
    claude /path / claude update
    Default / Accept Edits / Plan Mode
    快捷键 Shift+Tab 等
    上下文管理: /compact /clear /rewind
    后台与面板: Ctrl+B Ctrl+T ↓
    记忆与配置: /init /memory /hooks
    工作目录 /add-dir
    记忆: /init
    会话: /clear /compact /status /cost
    配置: /config /model /doctor
    5.1 核心理念
    命令、模型、记忆、模式 串联流水线
    5.2 完整开发工作流
    第一步: 建立项目记忆
    /init 扫描生成 CLAUDE.md
    /memory 补充人工经验
    第二步: 理解代码结构 (Plan Mode)
    只读分析, 梳理调用链
    复杂部分 → 切 Opus 模型
    第三步: 规划新功能 (Plan Mode + Opus)
    RBAC 等方案设计
    Ctrl+G 编辑计划文件
    第四步: 分模块执行 (Auto-Accept + 后台)
    Shift+Tab 切模式
    Ctrl+B 后台任务, Ctrl+T 查看
    /clear 或 /compact 管理上下文
    第五步: 性能分析与优化 (Plan Mode)
    代码审查, 输出报告
    第六步: 收尾与记忆沉淀
    /memory 写入 CLAUDE.md
    团队共享持久经验
    5.3 模式与模型选用原则
    需要修改文件?
    Plan Mode + Opus
    任务复杂度?
    Plan Mode 规划 → Auto-Accept 执行 (Opus)
    Default + Sonnet
    Auto-Accept + Sonnet/Haiku
    5.4 总结
    Plan Mode 想 → Auto-Accept 做 → 上下文管理 → 记忆沉淀

1. Claude 常用命令

  • 查看版本：
bash 复制代码 
claude --version
  • 启动交互界面（当前目录）：
bash 复制代码 
claude
  • 在指定目录启动：
bash 复制代码 
claude /code/claude-project
  • 升级到最新版本：
bash 复制代码 
claude update

2. Claude Code 界面说明

  • Claude Code 界面底部左侧显示当前模式（Default / Accept Edits / Plan Mode），按 Shift+Tab 可循环切换三种工作模式。
指示器显示 模式 行为说明
Default Default（默认模式） 标准模式，每次编辑文件或执行命令都需手动确认。
Accept Edits Auto-Accept（自动接受） 文件修改自动执行，无需逐一确认（Shell 命令仍需确认）。适合批量重构。
Plan Mode Plan Mode（计划模式） 只读模式，仅做分析和规划，不修改任何文件。适合架构讨论或代码审查。
  • 底部状态栏会根据不同模式展示特定样式：

1、默认模式

2、自动接受模式

3、计划模式

  • 对话区：工具调用的详情会直接展示在对话流中。
  • 输入框：位于中央，支持自然语言、Markdown，可拖入图片或文件。
  • 底部快捷键提示：Ctrl+C 中断 · Ctrl+B 后台执行 · ESC 返回/取消。
  • 输入 ? 可显示更多快捷键。

3. Claude 常用指令速查

指令 / 快捷键 作用 典型场景
/compact 压缩对话上下文，保留核心摘要 对话过长导致 token 即将超限时
/clear 清空所有对话历史，全新开始 切换到完全不同的任务时
claude -c 启动时恢复上一次对话 次日继续昨天未完成的工作
Ctrl+B 将当前任务挂到后台运行 让 AI 后台编译，前台继续讨论下一步
ESC × 2 (/rewind) 回退/撤销 AI 操作 AI 改错了代码，快速回滚
↓ 或 /tasks 管理后台任务（查看/停止） 检查后台编译或测试是否完成
Ctrl+T 显示/隐藏任务列表面板 查看 Claude 创建的任务进度
Ctrl+G 打开计划文件（Plan Mode 专用） 在规划阶段直接编辑计划文本
Alt+V 粘贴图像（Windows） 截图发给 Claude 分析 UI 或报错
/memory 打开并编辑 CLAUDE.md 修改项目规则或个人偏好
/init 自动生成 CLAUDE.md 初稿 新项目首次接入 Claude Code
/hooks 配置工具钩子（自动化触发） 写文件后自动运行 prettier 格式化
\ + Enter 输入框内换行（不发送消息） 输入多行代码或详细需求描述时
Shift+Tab 循环切换三种工作模式 从 Plan Mode 切到 Auto-Accept 执行

4. Claude Code 的命令行输入

  • Claude Code 是 Anthropic 推出的终端 AI 编码助手，通过 斜杠命令（Slash Commands） 控制 AI 助手的行为与上下文。合理运用这些命令，配合自然语言描述，能让开发过程更加顺畅。
  • 通常第一步是设定工作目录。在交互界面输入斜杠 / 触发指令模式，然后添加工作目录：
bash 复制代码 
/add-dir <你的项目目录>
  • 添加完成后，用初始化命令对项目做全局分析，生成 CLAUDE.md 文件。该文件用于建立持久上下文，让 Claude Code 理解项目目标、结构、代码规范和自身角色。后续可通过对话或命令修改此文件，以适配更具体的设定。

在一个已完成的项目下，执行 /init 即可完成初始化。

4.1 /init -- 初始化项目记忆指南

bash 复制代码 
/init
  • 定义与语法 ：/init 。扫描当前项目代码库，在根目录生成 CLAUDE.md 文件作为该项目的知识指南，通常包含项目结构摘要、主要模块说明、依赖列表等。
  • 使用场景 ：建议首次在新项目中使用 Claude Code 时立即执行 /init。Claude 会自动了解项目结构和背景，相当于给 AI 同事一本入门手册。你还可以在 Claude 的帮助下进一步完善它，例如询问"请列出项目架构的关键部分写入 CLAUDE.md"。完成后保存（甚至可以提交到仓库共享），之后每次启动都会首先读取 CLAUDE.md，从而拥有持久的项目信息。

4.2 /help -- 查看命令列表

bash 复制代码 
/help
  • 定义与语法 ：/help ，显示所有可用命令的帮助信息。

4.3 /clear -- 清除对话历史

bash 复制代码 
/clear
  • 定义与语法 ：/clear ，清除当前会话的对话历史，相当于开启一个新会话，但不会退出 Claude Code 界面。
  • 使用场景 ：当对话持续过久、上下文累积过多时，可使用 /clear 重置上下文窗口，保持思路清晰。例如完成一个独立任务后开启新任务，或 Claude 回答出现偏离时，一键"重启"对话。

渲染错误: Mermaid 渲染失败: Lexical error on line 3. Unrecognized text. ...C[/compact
压缩为摘要] B -->|完全重新开始| -----------------------^

4.4 /compact -- 压缩对话内容

bash 复制代码 
# 基础用法
/compact

# 指定保留重点
/compact "保留尚未解决的问题"
  • 定义与语法 ：/compact [instructions] ，可选附加指令。将当前对话历史总结并压缩，以一份摘要作为新对话的开场上下文。可选参数可指定压缩时需要侧重的要点。
  • 使用场景 ：当会话长度接近模型上下文上限时，/compact 是延续长对话的有效手段。Claude 会自动提炼要点，释放 token。与 /clear 的区别在于，压缩后的摘要保留了关键上下文，新会话可以无缝衔接之前的结论，避免重复沟通。

4.5 /memory -- 编辑会话记忆文件

bash 复制代码 
/memory

  • 定义与语法 ：/memory ，打开并编辑当前项目的持久记忆文件 CLAUDE.md（或用户级全局记忆文件），方便查看和修改 Claude 的"长期记忆"。

  • 使用场景 ：通过 /memory 可随时更新 CLAUDE.md，比如补充漏掉的关键业务术语。保存退出后，可以通过 /clear 开启新会话，Claude 将自动参照更新后的文件。

  • 一般选择当前项目记忆

三种记忆可以这样区分：

Project memory = 项目专属的规则和约定

User memory = 你个人的全局习惯，所有项目通用

Auto-memory = Claude 自动识别并写入的重要信息，无需手动操作

举几个典型场景：

  1. Project memory（项目记忆） ./CLAUDE.md

    适合写跟这个项目强绑定的内容

    • "这是一个 Vue3 + TypeScript 项目，使用 npm"
    • "不要修改 src/config/ 目录下的任何文件"
    • "测试命令是 npm test，构建是 npm build"
    • "API 接口统一放在 src/api/，不要分散"

  2. User memory（用户记忆） ~/.claude/CLAUDE.md

    适合写跟你个人习惯相关、所有项目通用的内容

    • "回复一律用中文"
    • "代码注释保持简洁，不要过多赘述"
    • "提交信息用英文，格式 feat: xxx"
    • "不要主动帮我重构我没提到的代码"

  3. Auto-memory（自动记忆）

    Claude 自己判断什么重要，自动写入，比如：

    • "项目规定所有接口要加错误边界处理"------自动记下来
    • "这个项目不用写单元测试"------自动记下来

一句话概括：项目记忆决定"这个项目怎么做"，用户记忆决定"我习惯怎么工作"，自动记忆则把你从手动维护记忆中解放出来。

4.6 /status -- 会话状态检查

bash 复制代码 
/status
  • 定义与语法 ：/status ，显示当前会话状态：工作目录、登录账户、所用模型、加载的项目记忆等，属于只读命令。
  • 使用场景 ：需要确认当前运行环境时，例如切换目录或模型后想验证，/status 可立刻给出答案，也是排查问题的起点。

4.7 /cost -- token 费用统计

bash 复制代码 
/cost
  • 定义与语法 ：/cost ，显示当前会话的 token 使用量（输入/输出）及预估 API 消耗费用。
  • 使用场景 ：按量计费时，养成关注 token 消耗的好习惯。执行 /cost 可了解累计用量并估算花费，及时发现 token 飙升，用以调整提问策略或压缩上下文。结束当天工作时也适合用它核对预算。

4.8 /config -- 查看或修改配置

bash 复制代码 
/config
  • 定义与语法 ：/config ，可交互式查看和修改 Claude Code 的配置参数，如启用/禁用自动压缩、设置主题、切换编辑模式等。
  • 使用场景：根据个人习惯定制 Claude Code，比如开启 Autocompact、启用待办事项功能、打开 verbose 输出以辅助调试等。

4.9 /model -- 切换 AI 模型版本

bash 复制代码 
/model
  • 定义与语法 ：/model [model_name]。不带参数时显示当前模型及可选列表；指定参数则直接切换模型。常用模型：Sonnet（较快）、Opus（较慢但更强）、Haiku（最快）。
  • 使用场景：根据任务需要选择合适的模型，在速度和质量之间平衡。默认使用较快的模型，复杂架构或批量重构时切换到 Opus，简单问答继续使用 Sonnet。

模型选项：

选项 含义
1. Default 当前默认模型（示例：claude-sonnet-4-20250514）
2. Sonnet (1M context) 均衡型，性价比高，适合日常编码
3. Opus (1M context) 最强模型，适合复杂架构/难题，但最慢最贵
4. Haiku 最快最便宜，适合简单问答/快速任务

渲染错误: Mermaid 渲染失败: Lexical error on line 7. Unrecognized text. ...>|否| Fast[/fast 快速模式] -----------------------^

价格参考：输入 3 / 输出 15 每百万 token（以实际模型为准）

底部两个设置：

项目 含义
◐ Medium effort 思考力度，使用 ← → 可调节，分为 low / medium / high，力度越高则越慢、越消耗 token
/fast 快速模式，仅 Opus 可用，关闭深度思考使速度更快

日常选型指南：

  • 写业务代码 → Sonnet
  • 做复杂重构或架构设计 → Opus（配合 Plan Mode 效果最佳）
  • 快速查语法或简单问答 → Haiku

4.10 /doctor -- 环境健康检查

bash 复制代码 
/doctor
  • 定义与语法 ：/doctor ，检查当前安装环境的健康状态，验证依赖和权限是否正确配置，并报告潜在问题。
  • 使用场景：Claude Code 行为异常时的首要排查工具。会检查 API 连通性、账户有效性、必需依赖（git、GitHub CLI、ripgrep 等）及文件权限等，输出报告指明问题方向。

5. Claude Code 进阶实战指南

5.1 核心理念

把命令、模型、记忆和模式有机串联起来，才算发挥了 Claude Code 的真正能力。开发者掌握方向和决策，Claude 负责落地与细化。

5.2 一套完整的开发工作流

以"接手新项目并开发新功能"为例，展示如何从头到尾组合使用各项能力。

工作流总览：
循环
第一步：/init 初始化项目认知
第二步：Plan Mode 理解代码结构
第三步：Plan Mode + Opus 规划新功能
第四步：Auto-Accept + 后台任务 分模块执行
第五步：Plan Mode 性能分析与优化
第六步：/memory 沉淀经验

第一步：建立项目记忆

刚进入项目目录，先让 Claude "读懂"项目，而不是急于写代码。

bash 复制代码 
/init

自动扫描目录，生成 CLAUDE.md 初稿（包含技术栈、目录结构、常用命令等）。接着用 /memory 补充人工经验：

markdown 复制代码 
- 不要修改 src/legacy/ 目录
- 提交信息格式：feat: / fix: / chore:
- 测试命令：pnpm test

此后每次对话都会自动加载这些记忆，免去重复交代。

第二步：理解代码结构（Plan Mode）

面对不熟悉的代码库，Plan Mode 最稳妥------只读不改，专心理清逻辑。

bash 复制代码 
Shift+Tab × 2  →  进入 Plan Mode

然后用自然语言提问：

text 复制代码 
分析 src/auth/ 模块的整体架构，梳理用户登录与权限校验的完整调用链

Claude 会浏览相关文件、组织逻辑、输出架构图和说明，全过程不修改代码。如果遇到特别复杂的部分，可临时切到 Opus 模型来增强理解：

bash 复制代码 
/model  →  选择 Opus
第三步：规划新功能（Plan Mode + Opus）

吃透现有代码后，继续留在 Plan Mode 规划，不要急于动手。

text 复制代码 
我需要给系统加上基于角色的权限控制（RBAC），请分析现有代码结构，
制定一个改动最小、风险最低的实现方案

Claude 给出计划后，可以用 Ctrl+G 打开计划文件直接编辑，剔除多余步骤、补充业务约束，这比通过对话反复修正更精确、高效。

💡 这 10 分钟的确认，常常能避免后面 1 小时的返工。

第四步：分模块执行（Auto-Accept + 后台任务）

计划敲定后，切换到 Auto-Accept 模式开始落地：

bash 复制代码 
Shift+Tab × 1  →  进入 Auto-Accept 模式

对于编译、跑测试等耗时操作，可以挂到后台：

bash 复制代码 
Ctrl+B  →  后台执行
Ctrl+T  →  查看任务进度

前台继续和 Claude 讨论下一个模块，两边不耽误。

每完成一个独立模块，建议用 /clear 清掉旧上下文，避免干扰：

bash 复制代码 
/clear

如果对话已经很深但还不想完全清空，可用 /compact 压缩保留要点：

bash 复制代码 
/compact "保留 RBAC 权限模型的核心决策和接口约定"
第五步：性能分析与优化

功能开发完成后，切回 Plan Mode 做全面审视：

bash 复制代码 
Shift+Tab × 2  →  Plan Mode
分析刚才新增的权限控制代码，找出潜在的性能问题和安全隐患，不要修改，只给报告

根据报告有针对性地调整，比边写边优化更清晰，也少引入新问题。

第六步：收尾与记忆沉淀

最后，用 /memory 把本次积累的经验写入 CLAUDE.md：

markdown 复制代码 
- RBAC 相关逻辑统一在 src/auth/rbac/ 下
- 新增角色时参考 AdminRole 的实现模式，使用装饰器声明权限

无论是下一个功能还是团队其他成员接手，这些经验都会直接生效。

5.3 模式与模型的选用原则

只读分析
需要执行
复杂架构/深度重构
日常编码
简单修改/批量替换
需要修改文件？
Plan Mode
任务复杂度？
Plan Mode 先规划

然后 Auto-Accept 执行

模型用 Opus
Default 模式

模型用 Sonnet
Auto-Accept 模式

模型用 Sonnet/Haiku

阶段 模式 模型
读代码 / 规划 Plan Mode Opus
日常编码 Default Sonnet
重复性修改 Auto-Accept Sonnet / Haiku
快速问答 Default Haiku

5.4 一句话总结

Plan Mode 想清楚 → Auto-Accept 执行 → /compact 或 /clear 管理上下文 → /memory 沉淀经验

只要把这条主线跑顺，就能真正驾驭 Claude Code 的高效工作方式。

如果你觉得这篇文章对你有帮助，请点赞 👍、收藏 👏 并关注我！👀

相关推荐
Highcharts.js1 小时前
金融Web App中的复杂时序数据可视化：从选型到高性能实践
开发语言·金融·highcharts·实战代码·响应式图表
minji...1 小时前
Linux 网络基础（三）HTTP的请求方法(GET/POST)，HTTP表单、临时和永久重定向状态码、Cookie、查询参数、Web根目录
linux·运维·服务器·网络·c++·http
kiku18181 小时前
Docker高级管理--Dockerfile镜像制作
java·docker·eureka
郝学胜-神的一滴1 小时前
跨平台 C++ 静态库编译实战：Linux/Windows/macOS 三端统一实现
linux·开发语言·c++·windows·软件构建
wefg11 小时前
【计算机网络】IP 协议（IP划分/公私IP/NAT/路由/分片组装/mac帧/MTU/MSS/ARP协议）
网络·tcp/ip·计算机网络
xyq20241 小时前
XHR 请求详解
开发语言
我滴老baby1 小时前
智能体安全防护指南从输入校验到工具沙箱的全方位防御策略
网络·安全
ooseabiscuit1 小时前
Laravel10.x重磅发布：新特性全解析
android·java·开发语言·mysql
上海云盾王帅1 小时前
如何有效抵御恶意IP攻击：从封禁到智能治理的进阶之路
网络·tcp/ip·安全
热门推荐
01GitHub 镜像站点02Codex 接入 DeepSeek API 完整配置文档03零基础教你claude code 接入 deepseek V404要裂开了！ChatGPT要手机号验证了？注册Codex要求验证电话号码怎么办？2026年登陆Codex要手机号验证的解决办法05CC-Switch & Claude 基于 Linux 服务器安装使用指南06Dirtyfrag漏洞：我花了一下午搞清楚这个Linux内核提权漏洞到底在搞什么07【AI】2026 年具身智能模型和世界模型总结08Windows端Codex接入第三方模型（DeekSeek，BaiLian)092026年Codex如何解决手机号码登陆验证的问题？10裂开！ChatGPT 居然开始要手机号验证，附详细解决方法