一、前言
Claude Code 是当前最流行的终端级 AI 编程助手,能够直接在命令行中完成代码生成、项目理解、文件修改、命令执行、错误修复等全流程开发工作。它不依赖图形界面、不占用额外资源,却能深度理解项目结构,自动生成规范代码,大幅提升研发效率。
但很多开发者只停留在“聊天写代码”的基础层面,没有真正掌握它的命令体系、三种工作模式、记忆机制与实战工作流,导致效率大打折扣。本文基于 2026 年最新版本,全面整理 Claude Code 的启动命令、交互指令、快捷键、三大工作模式、记忆体系、配置项、环境排查与完整实战工作流,形成一篇从零基础到高效精通的保姆级指南,帮助开发者真正把 AI 变成高效开发伙伴。阿里云部署 OpenClaw/Hermes Agent全网最简单,只需两步,详情👉访问阿里云OpenClaw/Hermes一键部署专题页面 了解。








👉访问订阅阿里云百炼Token Plan AI大模型服务 。支持多模型切换,用于多模态模型灵活调用,实现多模型、多工具、多场景下的额度共享与统一管理,兼顾灵活性、稳定性与安全性,大幅降低企业使用大模型的门槛与成本。




二、Claude Code 基础启动与CLI命令
在使用 Claude Code 之前,先要掌握最基础的启动与CLI命令,这是进入交互环境的第一步。
1. 查看版本
查看当前安装的 Claude Code 版本信息:
claude --version
2. 启动交互模式
在当前目录直接启动 Claude Code 交互界面:
claude
3. 指定项目目录启动
进入指定项目目录并启动:
claude 项目路径
4. 继续上一次会话
恢复最近一次的对话上下文,继续未完成的任务:
claude -c
5. 一次性执行指令(执行后退出)
传入指令并直接输出结果,不进入交互模式:
claude -p "你的指令"
6. 升级到最新版本
一键更新 Claude Code 到最新版:
claude update
这些基础命令让你能够快速启动、恢复会话、执行一次性任务,是日常使用的入口。
三、三大工作模式:Default、Auto-Accept、Plan Mode
Claude Code 提供三种工作模式,通过 Shift+Tab 循环切换,分别对应安全确认、自动执行、只读规划三种场景,是高效使用的核心。
1. Default 默认模式
这是最安全的默认模式,每次修改文件、执行命令前都会向你确认,防止误操作。
界面提示:? for shortcuts
适用场景:日常开发、不确定AI行为、敏感项目修改。
2. Auto-Accept 自动接受模式
文件修改会自动执行,无需手动确认,但 shell 命令仍然需要确认,兼顾效率与安全。
界面提示:accept edits on
适用场景:重复性代码修改、批量替换、简单功能开发。
3. Plan Mode 计划模式
纯只读模式,AI 只做分析、梳理、规划,不会修改任何代码或执行任何操作,等你确认计划后再执行。
界面提示:plan mode on
适用场景:阅读陌生项目、架构分析、方案设计、风险评估。
高效工作流建议:
先用 Plan Mode 理清架构 → 确认方案 → 切换 Auto-Accept 快速执行 → 完成后切回 Default 保证安全。
四、Claude Code 交互界面与快捷键
进入交互界面后,底部会显示模式、模型、用量信息,中间为对话输入框,支持自然语言、文件引用、图片粘贴。
常用快捷键
Ctrl+C:中断当前生成Ctrl+B:将任务挂到后台运行ESC两次:清空输入框Shift+Tab:循环切换三种模式Ctrl+T:显示/隐藏任务面板Alt+V:粘贴图片(Windows)\ + Enter:输入框内换行,不发送消息Ctrl+O:显示详细输出Ctrl+Shift+Z:撤销上一步操作
熟练使用快捷键,可以大幅提升操作流畅度。
五、高频斜杠命令(Slash Commands)全解析
斜杠命令是 Claude Code 的核心控制指令,决定 AI 的行为、上下文、记忆与配置。以下是最常用、最实用的命令详解。
1. /init:项目初始化(最重要命令之一)
在项目根目录执行,自动扫描代码结构,生成 CLAUDE.md 文件,作为项目知识库。
/init
生成内容包括:项目概述、技术栈、目录结构、常用命令、开发规范、注意事项。
每次启动 Claude Code,它都会先读取该文件,实现持久项目记忆。
2. /help:查看所有命令列表
列出所有可用指令与说明:
/help
3. /clear:清空对话历史
清除当前上下文,相当于重启会话,但不退出工具:
/clear
适用场景:切换任务、上下文混乱、回答跑偏。
4. /compact:压缩上下文
当对话过长、Token 接近上限时,自动总结历史,保留关键信息,释放上下文空间:
/compact
可附加说明指定保留内容:
/compact 保留登录模块相关内容
5. /memory:编辑项目记忆
打开并编辑 CLAUDE.md,手动添加规范、规则、禁忌:
/memory
包含三级记忆:
- 项目记忆:当前项目生效
- 用户记忆:所有项目全局生效
- 自动记忆:AI 自动记录重要规则
6. /status:查看当前会话状态
显示版本、工作目录、模型、配置、用量等信息:
/status
7. /cost:查看 Token 消耗与费用
统计当前会话输入输出 Token 与预估费用:
/cost
8. /config:进入配置面板
可修改主题、自动压缩、快速模式、输出格式等:
/config
9. /model:切换 AI 模型
在不同模型之间切换,平衡速度与能力:
/model
常用模型:
- Haiku:最快、最便宜,适合简单问题
- Sonnet:均衡型,日常编码首选
- Opus:最强模型,适合复杂架构、重构
10. /tasks:查看后台任务
查看后台运行中的任务(编译、测试等):
/tasks
11. /rewind:回退上一步操作
撤销 AI 上一步的修改:
/rewind
12. /add-dir:添加工作目录
让 AI 同时读取多个目录:
/add-dir 目录路径
13. /doctor:环境诊断
自动检查依赖、权限、API 连通性,排查运行异常:
/doctor
这些命令覆盖会话控制、项目管理、配置、模型、权限、诊断等全部场景,是高效使用的基础。
六、Claude Code 图片处理机制
Claude Code 支持直接粘贴图片,用于分析 UI、报错截图、架构图等,但不会永久保存图片。
机制如下:
- 图片会临时保存到本地缓存目录
- AI 通过读取临时文件理解内容
- 会话结束后自动清理,不会上传或泄露
- 不依赖云端存储,本地隐私安全
使用方式:
- 截图后直接粘贴到输入框
- 或输入路径让 AI 读取
七、CLAUDE.md 记忆体系详解
CLAUDE.md 是 Claude Code 的灵魂,相当于给 AI 的项目说明书,决定 AI 是否真正理解项目。
1. 项目级记忆(./CLAUDE.md)
对当前项目生效,可提交到 Git 共享给团队,内容包括:
- 项目技术栈
- 构建命令、启动命令、测试命令
- 禁止修改的目录
- 代码规范、注释风格
- 接口规则、异常处理
2. 用户级记忆(~/.claude/CLAUDE.md)
全局生效,所有项目共用,例如:
- 回复语言:中文
- 提交信息格式
- 代码风格偏好
- 不自动重构代码
3. 自动记忆
AI 自动把你说过的规则记录下来,例如:
- 接口必须加错误处理
- 该项目不写单元测试
- 生成代码必须带注释
正确使用记忆体系,能让 AI 越来越贴合你的习惯,越用越高效。
八、完整实战工作流:接手新项目+开发新功能
以下是企业级最高效、最稳定的标准流程。
第一步:初始化项目记忆
进入项目目录,启动 Claude Code:
claude
执行初始化:
/init
用 /memory 补充规则:
- 不修改 src/legacy 目录
- 提交格式:feat: 功能名
- 构建命令:pnpm build
第二步:Plan Mode 理解架构
切换到计划模式:
Shift+Tab 两次
让 AI 梳理架构:
分析用户模块的完整调用链
复杂项目切换强模型:
/model opus
第三步:制定开发计划
继续在 Plan Mode 下:
设计一个短信登录功能,列出修改文件与风险
确认方案无误后再执行。
第四步:Auto-Accept 快速执行
切换到自动模式:
Shift+Tab 一次
开始生成代码,AI 自动修改文件。
第五步:后台运行任务
遇到编译、测试等耗时任务:
Ctrl+B 挂后台
Ctrl+T 查看进度
第六步:上下文管理
对话过长时压缩:
/compact
切换任务时清空:
/clear
第七步:沉淀经验到记忆
功能完成后,把规范写入记忆:
/memory
添加:
- 短信登录逻辑统一放 src/auth/sms
这套流程能让你在最短时间内高质量完成开发,且代码规范统一、风险最低。
九、常见问题与排查
1. 命令无法识别
重新加载环境:
source ~/.bashrc
2. AI 不理解项目
执行 /init 重新生成项目知识库。
3. 运行卡顿、响应慢
使用 /compact 压缩上下文,或 /clear 重启会话。
4. 模型调用失败
检查 API Key 是否正确,模型是否开通权限。
5. 文件无法修改
检查权限,或使用 /doctor 诊断环境。
十、总结
Claude Code 不是简单的代码生成工具,而是一套终端级全流程 AI 开发系统。真正掌握它的核心不在于会聊天,而在于熟练使用命令、模式、记忆与工作流。
本文覆盖启动命令、三大模式、快捷键、高频斜杠命令、图片处理、记忆体系、完整实战流程与问题排查,形成一篇 2026 年最全、最实用的 Claude Code 指南。
只要按照文中方法,把 /init、/memory、/compact、/model、三大模式配合使用,就能让 AI 真正成为你的高效开发伙伴,大幅提升编码速度、代码质量与项目交付效率。