Claude Code 基础使用完整指南：从启动到精通的实战手册

Claude Code 基础使用完整指南：从启动到精通的实战手册 Claude Code 基础使用完整指南：从启动到精通的实战手册 Modified June 10 ⠀ 启用详细输出： ⠀ Code block Plain Text 启动时启用 claude verbose 运行时切换 Ctrl + O Q18: 怎么取消正在执行的操作 ⠀ 按 Ctrl + C 中断： ⠀ Code block Plain Text Claude正在生成长回答时 [按 Ctrl + C] 会立即停止生成 Q19: 怎么更新Claude Code ⠀ 更新命令： ⠀ Code block Plain Text 在终端运行 claude update 或使用npm更新 npm update g @anthropic ai/claude code Q20: 配置文件在哪里 ⠀ 配置文件位置： ⠀ 文件 位置 作用 CLAUDE.md 项目根目录 项目配置 .mcp.json 项目根目录 MCP服务器配置 /.claude/ 用户目录 全局配置 /.claude/commands/ 用户目录 个人 legacy Slash 命令 附录A：完整命令速查表 ⠀ CLI启动选项 ⠀ 选项 简写 作用 version v 显示版本 help h 显示帮助 print p 打印模式 model <name m 指定模型 continue c 恢复最近会话 resume <id r 恢复指定会话 project <path 无 指定项目目录 verbose 无 详细输出 dangerously skip permissions 无 跳过权限确认 ⠀ Slash命令速查 ⠀ 命令 作用 /help 显示帮助 /exit 退出 /clear 清空对话 /compact 压缩对话 /context 查看Token使用 /cost 查看费用 /model 切换模型 /status 查看状态 /doctor 系统诊断 /resume 恢复会话 /export 导出对话 /rename 重命名会话 /init 初始化项目 /memory 编辑记忆 /permissions 管理权限 /security review 安全审查 /tasks 后台任务管理 /rewind 回退功能 /plan 规划模式 /mcp 管理MCP /plugin 管理插件 /reload plugins 重载插件 /hooks 管理Hooks /config 打开统一设置界面 /stats 使用统计 /usage 使用量 /insights 查看会话/使用洞察 /schedule 计划任务入口 /statusline 状态行定制 /remote control 远程继续当前本地会话 /mobile 手机 App 下载二维码 /install github app GitHub Actions 快速接入 /tasks 管理后台任务 /theme 切换配色主题 /desktop 切到 Claude Code Desktop /diff 查看当前变更和逐轮 diff /btw 提一个不污染主线程的 side question /chrome 管理 Claude in Chrome 集成 /ultraplan 在浏览器里草拟并回传 plan /release notes 更新日志 /bug 报告Bug /powerup 交互式功能教程（v2.1.90+，见 GitHub release） /voice 语音模式 🆕 /effort 推理深度控制（五级：low/medium/high/xhigh/max）🆕 /loop Bundled skill：定时循环执行 🆕 /sandbox 沙箱隔离模式 🆕 /color 会话颜色设置 🆕 /copy 复制AI回复 🆕 /branch 会话分支 🆕 /skills 查看和搜索已安装的 Skills 🆕 /proactive /loop 的别名（v2.1.105+）🆕 ⠀ 快捷键速查 ⠀ 快捷键 作用 Ctrl + C 取消/中断 Ctrl + D 退出 Ctrl + L 清屏 Ctrl + O 切换详细输出 Ctrl + R 搜索历史 Ctrl + B 转后台运行 Esc + Esc Rewind菜单 Tab 切换Extended Thinking Shift + Tab 切换权限模式 Option/Alt + P 切换模型 总结 ⠀ 恭喜你完成了Claude Code基础使用的学习！ ⠀ 你现在掌握了： ⠀ 1. 三种使用模式（交互/单次/打印） 2. 30+个Slash命令 3. 高效快捷键操作 4. Checkpoint/Rewind回退功能 5. Extended Thinking深度思考 6. 省钱和效率技巧 ⠀ 下一步学习建议： ⠀ 1. Commands系统：学习自定义Slash命令 2. MCP集成：连接外部工具 3. Hooks系统：自动化工作流 4. Skills定制：创建专业知识技能包 ⠀ ⠀ 启用详细输出： ⠀ Q18: 怎么取消正在执行的操作 ⠀ 按 Ctrl + C 中断： ⠀ Q19: 怎么更新Claude Code ⠀ 更新命令： ⠀ Q20: 配置文件在哪里 ⠀ 配置文件位置： ⠀ 文件 位置 作用 CLAUDE.md 项目根目录 项目配置 .mcp.json 项目根目录 MCP服务器配置 /.claude/ 用户目录 全局配置 /.claude/commands/ 用户目录 个人 legacy Slash 命令 文件 文件 位置 位置 作用 作用 CLAUDE.md CLAUDE.md 项目根目录 项目根目录 项目配置 项目配置 .mcp.json .mcp.json 项目根目录 项目根目录 MCP服务器配置 MCP服务器配置 /.claude/ /.claude/ 用户目录 用户目录 全局配置 全局配置 /.claude/commands/ /.claude/commands/ 用户目录 用户目录 个人 legacy Slash 命令 个人 legacy Slash 命令 附录A：完整命令速查表 ⠀ CLI启动选项 ⠀ 选项 简写 作用 version v 显示版本 help h 显示帮助 print p 打印模式 model <name m 指定模型 continue c 恢复最近会话 resume <id r 恢复指定会话 project <path 无 指定项目目录 verbose 无 详细输出 dangerously skip permissions 无 跳过权限确认 选项 选项 简写 简写 作用 作用 version version v v 显示版本 显示版本 help help h h 显示帮助 显示帮助 print print p p 打印模式 打印模式 model <name model <name m m 指定模型 指定模型 continue continue c c 恢复最近会话 恢复最近会话 resume <id resume <id r r 恢复指定会话 恢复指定会话 project <path project <path 无 无 指定项目目录 指定项目目录 verbose verbose 无 无 详细输出 详细输出 dangerously skip permissions dangerously skip permissions 无 无 跳过权限确认 跳过权限确认 ⠀ Slash命令速查 ⠀ 命令 作用 /help 显示帮助 /exit 退出 /clear 清空对话 /compact 压缩对话 /context 查看Token使用 /cost 查看费用 /model 切换模型 /status 查看状态 /doctor 系统诊断 /resume 恢复会话 /export 导出对话 /rename 重命名会话 /init 初始化项目 /memory 编辑记忆 /permissions 管理权限 /security review 安全审查 /tasks 后台任务管理 /rewind 回退功能 /plan 规划模式 /mcp 管理MCP /plugin 管理插件 /reload plugins 重载插件 /hooks 管理Hooks /config 打开统一设置界面 /stats 使用统计 /usage 使用量 /insights 查看会话/使用洞察 /schedule 计划任务入口 /statusline 状态行定制 /remote control 远程继续当前本地会话 /mobile 手机 App 下载二维码 /install github app GitHub Actions 快速接入 /tasks 管理后台任务 /theme 切换配色主题 /desktop 切到 Claude Code Desktop /diff 查看当前变更和逐轮 diff /btw 提一个不污染主线程的 side question /chrome 管理 Claude in Chrome 集成 /ultraplan 在浏览器里草拟并回传 plan /release notes 更新日志 /bug 报告Bug /powerup 交互式功能教程（v2.1.90+，见 GitHub release） /voice 语音模式 🆕 /effort 推理深度控制（五级：low/medium/high/xhigh/max）🆕 /loop Bundled skill：定时循环执行 🆕 /sandbox 沙箱隔离模式 🆕 /color 会话颜色设置 🆕 /copy 复制AI回复 🆕 /branch 会话分支 🆕 /skills 查看和搜索已安装的 Skills 🆕 /proactive /loop 的别名（v2.1.105+）🆕 命令 命令 作用 作用 /help /help 显示帮助 显示帮助 /exit /exit 退出 退出 /clear /clear 清空对话 清空对话 /compact /compact 压缩对话 压缩对话 /context /context 查看Token使用 查看Token使用 /cost /cost 查看费用 查看费用 /model /model 切换模型 切换模型 /status /status 查看状态 查看状态 /doctor /doctor 系统诊断 系统诊断 /resume /resume 恢复会话 恢复会话 /export /export 导出对话 导出对话 /rename /rename 重命名会话 重命名会话 /init /init 初始化项目 初始化项目 /memory /memory 编辑记忆 编辑记忆 /permissions /permissions 管理权限 管理权限 /security review /security review 安全审查 安全审查 /tasks /tasks 后台任务管理 后台任务管理 /rewind /rewind 回退功能 回退功能 /plan /plan 规划模式 规划模式 /mcp /mcp 管理MCP 管理MCP /plugin /plugin 管理插件 管理插件 /reload plugins /reload plugins 重载插件 重载插件 /hooks /hooks 管理Hooks 管理Hooks /config /config 打开统一设置界面 打开统一设置界面 /stats /stats 使用统计 使用统计 /usage /usage 使用量 使用量 /insights /insights 查看会话/使用洞察 查看会话/使用洞察 /schedule /schedule 计划任务入口 计划任务入口 /statusline /statusline 状态行定制 状态行定制 /remote control /remote control 远程继续当前本地会话 远程继续当前本地会话 /mobile /mobile 手机 App 下载二维码 手机 App 下载二维码 /install github app /install github app GitHub Actions 快速接入 GitHub Actions 快速接入 /tasks /tasks 管理后台任务 管理后台任务 /theme /theme 切换配色主题 切换配色主题 /desktop /desktop 切到 Claude Code Desktop 切到 Claude Code Desktop /diff /diff 查看当前变更和逐轮 diff 查看当前变更和逐轮 diff /btw /btw 提一个不污染主线程的 side question 提一个不污染主线程的 side question /chrome /chrome 管理 Claude in Chrome 集成 管理 Claude in Chrome 集成 /ultraplan /ultraplan 在浏览器里草拟并回传 plan 在浏览器里草拟并回传 plan /release notes /release notes 更新日志 更新日志 /bug /bug 报告Bug 报告Bug /powerup /powerup 交互式功能教程（v2.1.90+，见 GitHub release） 交互式功能教程（v2.1.90+，见 GitHub release） /voice /voice 语音模式 🆕 语音模式 🆕 /effort /effort 推理深度控制（五级：low/medium/high/xhigh/max）🆕 推理深度控制（五级：low/medium/high/xhigh/max）🆕 /loop /loop Bundled skill：定时循环执行 🆕 Bundled skill：定时循环执行 🆕 /sandbox /sandbox 沙箱隔离模式 🆕 沙箱隔离模式 🆕 /color /color 会话颜色设置 🆕 会话颜色设置 🆕 /copy /copy 复制AI回复 🆕 复制AI回复 🆕 /branch /branch 会话分支 🆕 会话分支 🆕 /skills /skills 查看和搜索已安装的 Skills 🆕 查看和搜索已安装的 Skills 🆕 /proactive /proactive /loop 的别名（v2.1.105+）🆕 /loop 的别名（v2.1.105+）🆕 ⠀ 快捷键速查 ⠀ 快捷键 作用 Ctrl + C 取消/中断 Ctrl + D 退出 Ctrl + L 清屏 Ctrl + O 切换详细输出 Ctrl + R 搜索历史 Ctrl + B 转后台运行 Esc + Esc Rewind菜单 Tab 切换Extended Thinking Shift + Tab 切换权限模式 Option/Alt + P 切换模型 快捷键 快捷键 作用 作用 Ctrl + C Ctrl + C 取消/中断 取消/中断 Ctrl + D Ctrl + D 退出 退出 Ctrl + L Ctrl + L 清屏 清屏 Ctrl + O Ctrl + O 切换详细输出 切换详细输出 Ctrl + R Ctrl + R 搜索历史 搜索历史 Ctrl + B Ctrl + B 转后台运行 转后台运行 Esc + Esc Esc + Esc Rewind菜单 Rewind菜单 Tab Tab 切换Extended Thinking 切换Extended Thinking Shift + Tab Shift + Tab 切换权限模式 切换权限模式 Option/Alt + P Option/Alt + P 切换模型 切换模型 总结 ⠀ 恭喜你完成了Claude Code基础使用的学习！ ⠀ 你现在掌握了： ⠀ 1. 三种使用模式（交互/单次/打印） 2. 30+个Slash命令 3. 高效快捷键操作 4. Checkpoint/Rewind回退功能 5. Extended Thinking深度思考 6. 省钱和效率技巧 ⠀ 下一步学习建议： ⠀ 1. Commands系统：学习自定义Slash命令 2. MCP集成：连接外部工具 3. Hooks系统：自动化工作流 4. Skills定制：创建专业知识技能包 ⠀ 记住：最好的学习方式是实践！打开Claude Code，开始你的AI编程之旅吧！ 课程反馈：如果本教程对你有帮助，欢迎分享给更多人！ 问题反馈：遇到问题可以使用 /bug 命令报告，或在社区提问。 更新日期：2026年5月30日 版本：v1.5（对齐 Claude Code v2.1.158 release 差量） 课程反馈：如果本教程对你有帮助，欢迎分享给更多人！ 问题反馈：遇到问题可以使用 /bug 命令报告，或在社区提问。 更新日期：2026年5月30日 版本：v1.5（对齐 Claude Code v2.1.158 release 差量） 课程信息 ⠀ • 作者：老金 • GitHub：https://github.com/KimYx0207 • 公众号：老金带你玩AI • X（Twitter）：老金带你玩AI • 个人博客：https://aiking.dev • 预计学时：4 6小时 • 难度等级：⭐ 零基础入门 • 更新日期：2026年5月30日 • 适用版本：Claude Code v2.1.158（验证于 2026 05 30） • 信息来源：官方文档 | GitHub 官方文档 GitHub • 前置要求：已完成Claude Code安装 本课学习目标 ⠀ 完成本课学习后，你将能够： ⠀ 1. 理解三种使用模式：掌握交互模式、单次执行、打印模式的适用场景 2. 熟练使用交互模式：掌握REPL对话窗口的完整操作技巧 3. 精通30+个Slash命令：熟练使用所有内置快捷指令 4. 掌握快捷键操作：提高10倍工作效率的键盘技巧 5. 配置个性化环境：根据项目需求定制Claude Code 6. 独立排查问题：使用诊断命令解决90%的常见问题 先做一个15分钟实操：写出第一份 CLAUDE.md ⠀ 这章很长，但新手不需要先背命令表。先做一件最有价值的事：让 Claude Code 读懂你的项目规则。 ⠀ CLAUDE.md 是 Claude Code 的项目说明书。它不只是备注文件，而是你告诉 Claude “这个项目怎么工作、怎么验证、哪些地方不要乱动”的地方。 ⠀ 第一步：进入你的项目目录并启动 Claude Code ⠀ 如果你只是想在当前仓库练习，也可以直接在本教程仓库里启动。 ⠀ 第二步：让 Claude 先只读分析项目 ⠀ 在 Claude Code 里输入： ⠀ ⠀ 这一步的目的不是让 Claude 写代码，而是让它先建立项目地图。 ⠀ 第三步：创建最小可用的 CLAUDE.md ⠀ 在项目根目录创建 CLAUDE.md，先写成这样： ⠀ text 1. [步骤] 验证：[检查方式] 2. [步骤] 验证：[检查方式] 3. [步骤] 验证：[检查方式] Code block Plain Text ⠀ 创建正式 前，先让 Claude 根据第二步的分析输出完整版本。命令必须来自项目文件或你亲自确认；没有确认的命令整行删除，不要留空、不要写占位。 ⠀ 第四步：验证 是否生效 ⠀ 开启一个新会话，输入： ⠀ ⠀ 如果 Claude 能说出项目用途、常用命令和工作规则，就说明这份 CLAUDE.md 已经开始发挥作用。 ⠀ 你刚完成了什么 ⠀ • 让 Claude Code 先读项目，而不是直接乱改。 • 写出第一份项目级指令文件。 • 建立了“先读规则、再动手、最后验证”的基本工作流。 ⠀ 后面的命令、快捷键、会话管理都建立在这个基础上。没有 CLAUDE.md，Claude Code 很容易变成一次性问答工具；有了它，才更像一个能长期协作的项目助手。 学习路径导航（先看这里！） ⠀ 根据你的情况选择学习路径：这是一篇长教程，不用全看！根据你的目标选择路径。 根据你的情况选择学习路径：这是一篇长教程，不用全看！根据你的目标选择路径。 ⠀ 路径A：5分钟快速上手 ⠀ 适合人群：急着体验Claude Code，想快速跑起来 ⠀ 只看这些章节（其他跳过）： ⠀ ⠀ 完成后你能达到：成功启动Claude Code，完成第一次对话，并让 Claude 读到项目规则 路径B：完整学习（4 6小时） ⠀ 适合人群：想系统掌握所有功能，成为Claude Code高手 ⠀ 学习顺序：从头到尾所有章节 ⠀ 建议分段学习： • 第1天（2小时）：第1 3部分（简介+快速开始+交互模式） • 第2天（1.5小时）：第4部分（Slash命令大全） • 第3天（1小时）：第5 6部分（快捷键+最佳实践） • 第4天（0.5小时）：第7部分（FAQ） 路径C：问题速查（5分钟） ⠀ 适合人群：使用中遇到问题，需要快速解决 ⠀ 直接跳到： ⠀ ⠀ 使用方法： 1. 按 Ctrl + F 搜索你的问题关键词 2. 找到对应的Q&A 3. 按步骤解决 路径D：专项学习（30 60分钟/主题） ⠀ 适合人群：已经会基础命令，想深入某个功能 ⠀ 想学什么 看哪几节 预计时间 Checkpoint回退 第4.4节 30分钟 Extended Thinking 第4.3节 30分钟 会话管理 第4.5节 20分钟 快捷键速查 第五部分 15分钟 省钱技巧 FAQ Q10 10分钟 想学什么 想学什么 看哪几节 看哪几节 预计时间 预计时间 Checkpoint回退 Checkpoint回退 第4.4节 第4.4节 30分钟 30分钟 Extended Thinking Extended Thinking 第4.3节 第4.3节 30分钟 30分钟 会话管理 会话管理 第4.5节 第4.5节 20分钟 20分钟 快捷键速查 快捷键速查 第五部分 第五部分 15分钟 15分钟 省钱技巧 省钱技巧 FAQ Q10 FAQ Q10 10分钟 10分钟 术语表（小白必读） ⠀ 在开始之前，先了解这些关键术语。用生活类比帮助理解： ⠀ 术语 英文全称 通俗解释 生活类比 CLI Command Line Interface 命令行界面，通过打字操作电脑 发短信指挥别人干活 交互模式 Interactive Mode 可以连续对话的模式，AI记住上下文 打电话聊天（可以连续说很多轮） REPL Read Eval Print Loop 交互模式的技术称呼，读取 执行 打印 循环 你说一句AI回一句，不停循环 打印模式 Print Mode 只输出结果，没有额外格式 只给答案，不说废话 Slash命令 Slash Commands 以"/"开头的特殊命令 微信的"@某人"，快速触发功能 Token • AI处理文字的计费单位 打的士按公里计费，AI按Token计费 Checkpoint • 检查点，代码和对话的存档点 游戏存档，随时可以读档重来 Rewind • 回退到之前的检查点 游戏读档 Compact • 压缩对话历史，节省Token 整理房间，扔掉不重要的东西 Extended Thinking • 扩展思考模式，让AI深度分析 让AI写解题过程，不只是答案 MCP Model Context Protocol 让Claude连接外部工具的插件系统 手机安装App，扩展功能 术语 术语 英文全称 英文全称 通俗解释 通俗解释 生活类比 生活类比 CLI CLI Command Line Interface Command Line Interface 命令行界面，通过打字操作电脑 命令行界面，通过打字操作电脑 发短信指挥别人干活 发短信指挥别人干活 交互模式 交互模式 Interactive Mode Interactive Mode 可以连续对话的模式，AI记住上下文 可以连续对话的模式，AI记住上下文 打电话聊天（可以连续说很多轮） 打电话聊天（可以连续说很多轮） REPL REPL Read Eval Print Loop Read Eval Print Loop 交互模式的技术称呼，读取 执行 打印 循环 交互模式的技术称呼，读取 执行 打印 循环 你说一句AI回一句，不停循环 你说一句AI回一句，不停循环 打印模式 打印模式 Print Mode Print Mode 只输出结果，没有额外格式 只输出结果，没有额外格式 只给答案，不说废话 只给答案，不说废话 Slash命令 Slash命令 Slash Commands Slash Commands 以"/"开头的特殊命令 以"/"开头的特殊命令 微信的"@某人"，快速触发功能 微信的"@某人"，快速触发功能 Token Token • • AI处理文字的计费单位 AI处理文字的计费单位 打的士按公里计费，AI按Token计费 打的士按公里计费，AI按Token计费 Checkpoint Checkpoint • • 检查点，代码和对话的存档点 检查点，代码和对话的存档点 游戏存档，随时可以读档重来 游戏存档，随时可以读档重来 Rewind Rewind • • 回退到之前的检查点 回退到之前的检查点 游戏读档 游戏读档 Compact Compact • • 压缩对话历史，节省Token 压缩对话历史，节省Token 整理房间，扔掉不重要的东西 整理房间，扔掉不重要的东西 Extended Thinking Extended Thinking • • 扩展思考模式，让AI深度分析 扩展思考模式，让AI深度分析 让AI写解题过程，不只是答案 让AI写解题过程，不只是答案 MCP MCP Model Context Protocol Model Context Protocol 让Claude连接外部工具的插件系统 让Claude连接外部工具的插件系统 手机安装App，扩展功能 手机安装App，扩展功能 第一部分：基础使用简介 ⠀ 1.1 什么是Claude Code ⠀ 一句话理解：Claude Code是Anthropic公司开发的AI编程助手命令行工具，让你在终端里直接和AI对话写代码。 一句话理解：Claude Code是Anthropic公司开发的AI编程助手命令行工具，让你在终端里直接和AI对话写代码。 ⠀ 生活类比： • 传统编程：你一个人在厨房做菜，从买菜到炒菜全得自己来 • 用Claude Code：请了一个厨师助手，你说"做宫保鸡丁"，他帮你查菜谱、准备食材、甚至直接帮你炒 ⠀ 1.2 三种使用模式对比 ⠀ Claude Code提供三种使用模式，适合不同场景： ⠀ 模式 启动方式 特点 适用场景 生活类比 交互模式 claude 连续对话，保持上下文 日常开发、复杂任务 打电话聊天 单次执行 claude "prompt" 执行一次就退出 脚本自动化、快速查询 发短信问问题 打印模式 claude p "prompt" 只输出纯文本结果 管道处理、数据转换 只要答案不要废话 模式 模式 启动方式 启动方式 特点 特点 适用场景 适用场景 生活类比 生活类比 交互模式 交互模式 claude claude 连续对话，保持上下文 连续对话，保持上下文 日常开发、复杂任务 日常开发、复杂任务 打电话聊天 打电话聊天 单次执行 单次执行 claude "prompt" claude "prompt" 执行一次就退出 执行一次就退出 脚本自动化、快速查询 脚本自动化、快速查询 发短信问问题 发短信问问题 打印模式 打印模式 claude p "prompt" claude p "prompt" 只输出纯文本结果 只输出纯文本结果 管道处理、数据转换 管道处理、数据转换 只要答案不要废话 只要答案不要废话 ⠀ 选择决策树： ⠀ ⠀ 1.3 为什么要学CLI版本 ⠀ 很多人问："不是有VS Code插件吗？为什么学命令行？" ⠀ 答案：CLI版本是最强大、最灵活的版本： ⠀ 能力 CLI版本 IDE插件 脚本自动化 完美支持 不支持 远程服务器 完美支持 需要图形界面 CI/CD集成 原生支持 困难 管道组合 完美支持 不支持 能力 能力 CLI版本 CLI版本 IDE插件 IDE插件 脚本自动化 脚本自动化 完美支持 完美支持 不支持 不支持 远程服务器 远程服务器 完美支持 完美支持 需要图形界面 需要图形界面 CI/CD集成 CI/CD集成 原生支持 原生支持 困难 困难 管道组合 管道组合 完美支持 完美支持 不支持