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

课程信息

预计学时：4-6小时

难度等级：⭐ 零基础入门

更新日期：2026年4月

适用版本：Claude Code v2.1.133（验证于 2026-05-08）

信息来源：官方文档 | GitHub

前置要求：已完成Claude Code安装

本课学习目标#

先做一个15分钟实操：写出第一份 CLAUDE.md#

第一步：进入你的项目目录并启动 Claude Code#

第二步：让 Claude 先只读分析项目#

阅读这个项目，告诉我：
1. 这个项目是做什么的
2. 常用安装、启动、测试命令是什么
3. 哪些目录或文件最重要
4. 你建议写进 CLAUDE.md 的项目规则是什么

不要修改文件。

第三步：创建最小可用的 CLAUDE.md#

安全边界#

验收标准#

这些规则生效时应该看到#

创建正式 `CLAUDE.md` 前，先让 Claude 根据第二步的分析输出完整版本。命令必须来自项目文件或你亲自确认；没有确认的命令整行删除，不要留空、不要写占位。

### 第四步：验证 `CLAUDE.md` 是否生效

开启一个新会话，输入：

```text
请根据 CLAUDE.md 总结这个项目的工作规则。不要修改文件。

你刚完成了什么#

学习路径导航（先看这里！）#

根据你的情况选择学习路径：这是一篇长教程，不用全看！根据你的目标选择路径。

路径A：5分钟快速上手#

✅ 先做一个15分钟实操：写出第一份 CLAUDE.md
✅ 第二部分：5分钟快速开始（5分钟）

路径B：完整学习（4-6小时）#

路径C：问题速查（5分钟）#

🔧 第七部分：FAQ - 20个常见问题解答
🔧 /doctor命令 - 系统诊断（第4.8节）

路径D：专项学习（30-60分钟/主题）#

术语表（小白必读）#

第一部分：基础使用简介#

1.1 什么是Claude Code#

一句话理解：Claude Code是Anthropic公司开发的AI编程助手命令行工具，让你在终端里直接和AI对话写代码。

1.2 三种使用模式对比#

你要做什么？
    │
    ├── 需要多轮对话？
    │       ├── 是 → 交互模式 (claude)
    │       └── 否 ↓
    │
    ├── 需要在脚本中使用？
    │       ├── 是 → 单次执行 (claude "prompt")
    │       └── 否 ↓
    │
    └── 需要把输出传给其他命令？
            ├── 是 → 打印模式 (claude -p "prompt")
            └── 否 → 交互模式 (claude)

1.3 为什么要学CLI版本#

第二部分：5分钟快速开始#

本节目的：用最快速度完成第一次对话，让你立即看到效果！

⏱️ 预计时间：5分钟

2.1 第一次启动Claude Code#

步骤1：打开终端#

步骤2：进入项目目录#

如果没有项目，可以创建一个测试目录：

步骤3：启动Claude Code#

Claude Code v2.1.92
Working directory: /你的项目路径
Type your message or /help for commands

You: █

光标在You:后面闪烁，等待你输入，这就说明启动成功了！

2.2 第一次对话#

You: 你好，介绍一下你自己

你好！我是Claude Code，Anthropic开发的AI编程助手。

我可以帮你：
- 编写和修改代码
- 解释代码逻辑
- 修复Bug
- 重构项目
- 搜索文件
- 运行命令
...

有什么我可以帮助你的吗？

2.3 验证Claude Code正常工作#

You: 创建一个hello.py文件，内容是打印"Hello Claude Code"

2.4 退出Claude Code#

You: /exit

第三部分：交互模式详解#

本节目的：深入掌握交互模式（REPL）的所有技巧

⏱️ 预计时间：45分钟

3.1 交互模式是什么#

R = Read    读取你输入的内容
E = Eval    处理你的请求
P = Print   打印AI的回答
L = Loop    循环等待下一个输入

3.2 启动选项详解#

基本启动#

常用选项#

💡 Worktree 模式（v2.1.49+ 新增）：--worktree（-w）是 2026年2月新增的重要参数。它会自动创建一个独立的 Git Worktree，让你可以同时运行多个 Claude Code 实例，每个实例在自己的工作目录中独立工作，互不干扰。适合并行开发多个功能、边修 bug 边开发新特性等场景。使用前需要将 .claude/worktrees/ 添加到 .gitignore。

3.3 快速输入技巧#

快捷输入符号#

💡 关于记忆管理：如需将项目规范写入记忆（CLAUDE.md），请使用 /memory 命令，它会打开 CLAUDE.md 供你编辑。

多行输入#

3.4 对话管理技巧#

何时清空对话#

何时压缩对话#

第四部分：Slash命令大全#

本节目的：掌握30+个Slash命令的使用

⏱️ 预计时间：60分钟

📌 重要提示：所有Slash命令都必须在交互模式中使用！

4.1 基础控制命令#

/help - 显示帮助#

/exit - 退出交互模式#

退出前记得保存重要对话（用 /export 命令）！

/clear - 清空对话历史#

CLAUDE.md的配置不会丢失！

/compact - 压缩对话历史#

4.2 上下文管理命令#

/context - 可视化上下文使用#

/cost - 显示会话成本#

/model - 切换AI模型#

💡 v2.1.69+ 新特性：Opus模型已支持1M（约100万token）上下文窗口和128K输出token。这意味着你可以让Opus阅读整个大型代码库并一次性生成完整的长文件。

/voice - 语音模式 🆕#

{
  "voice": {
    "pushToTalk": "Space"
  }
}

⚠️ 注意：语音模式需要麦克风权限。首次使用时，系统可能会弹出授权提示。

/effort - 推理深度控制 🆕#

💡 推荐：如果你使用 Opus 4.7 模型，官方推荐默认使用 xhigh 级别以获得最佳推理质量。

💡 状态栏提示：切换后，终端状态栏会显示当前级别符号，方便随时确认。

💡 Hook 联动：从 v2.1.121 起，Hook 脚本可以通过 $CLAUDE_EFFORT 环境变量感知当前 effort 等级，据此调整检查策略（如 xhigh 时跳过轻量检查）。

Auto Memories - 自动记忆 🆕#

{
  "autoMemoryDirectory": "~/.claude/memory/"
}

💡 与 /memory 的区别：/memory 是手动编辑记忆文件，Auto Memories是Claude自动记录。两者互补，共同构成Claude的"长期记忆"。

4.3 Extended Thinking（扩展思考）#

⚠️ 重要：Extended Thinking不是Slash命令，是通过Tab键或关键词触发的功能！

什么是Extended Thinking#

如何启用#

省钱技巧#

Extended Thinking会消耗更多Token！只在真正需要时使用！

4.4 Rewind/Checkpoint（回退功能）#

Claude Code 2.0的革命性功能，让你大胆实验无后顾之忧！

什么是Checkpoint#

如何使用Rewind#

三种恢复选项#

重要限制#

Critical：Checkpoint只追踪Claude的文件编辑工具（Write、Edit），不追踪bash命令修改！

4.5 会话管理命令#

/resume - 恢复会话#

/export - 导出对话#

版本校准（2026-04）：官方命令参考当前写法是 /export [filename]，用途是导出当前对话为 plain text。会话内的 /export --format json、/export --format html 不是当前支持的 slash 参数；在 Claude Code 2.1.92 / 2.1.107 这类版本里输入这些参数，通常仍会按普通文件名/文本导出处理。

/rename - 重命名会话#

4.6 项目配置命令#

/init - 初始化项目配置#

/memory - 编辑记忆文件#

/permissions - 管理权限#

v2.1.90（release）：在 acceptEdits 模式下，官方将 .husky 目录纳入 protected directories（原文：Added .husky to protected directories (acceptEdits mode)）。是否影响你仓库里的 Hook 脚本，以当前版本实际提示与官方后续说明为准。

企业设置 > 项目本地(.claude/settings.local.json) > 项目(.claude/settings.json) > 用户(~/.claude/settings.json)

{
  "permissions": {
    "allow": ["Read", "Grep", "Glob", "Edit"]
  }
}

⚠️ 安全提醒：--dangerously-skip-permissions 会移除所有确认提示，仅适用于 Docker/VM 等隔离环境中的自动化任务，日常开发请使用 allow 精细控制。

4.7 开发辅助命令#

/security-review - 安全审查#

⚠️ 说明：/security-review 专注安全风险。需要通用代码审查时，当前官方命令参考仍提供 /review [PR]；需要更深的云端多 Agent 审查时看 /ultrareview。

待办追踪（没有 /todos slash 命令）#

不要混淆：TodoWrite 是 Claude/Agent SDK 的内部工具事件，不等于一个 /todos slash 命令。/tasks 管的是后台任务/后台 Bash，不是普通待办列表。

/agents - 管理子代理#

/fast - 快速模式切换#

💡 说明：快速模式使用相同的模型，不会切换到更低级的模型，只是优化了输出速度。适合简单的代码修改、快速问答等场景。

4.8 诊断命令#

/doctor - 系统诊断#

/status - 完整状态信息#

/usage - 使用量统计#

4.9 其他实用命令#

/stats - 使用统计#

/config - 统一设置入口#

⚠️ 说明：/vim 已在 v2.1.92 移除。现在想切换 Vim / Normal 编辑模式，请进入 /config → Editor mode。

/release-notes - 查看更新日志#

/bug - 报告Bug#

4.10 MCP相关命令#

/mcp - 管理MCP连接#

/plugin - 管理插件#

/reload-plugins / /remote-control / /install-github-app / /tasks#

/hooks - 管理Hooks#

第五部分：快捷键速查#

本节目的：掌握提高效率的键盘快捷键

⏱️ 预计时间：15分钟

5.1 通用控制#

5.2 模型切换#

5.3 粘贴图片#

5.4 多行输入#

5.5 历史搜索 (Ctrl + R)#

5.6 后台运行#

5.7 Vim模式快捷键#

第六部分：最佳实践#

本节目的：掌握高效使用Claude Code的技巧

⏱️ 预计时间：30分钟

6.1 日常工作流程#

6.2 省钱技巧#

Token优化#

模型选择策略#

6.3 配置别名提高效率#

# 编辑配置文件
notepad $PROFILE

# 添加以下内容：
function cc { claude --dangerously-skip-permissions }
function cr { claude -c }
function ccv { claude --verbose }

6.4 大胆实验的工作方式#

6.5 团队协作#

第七部分：常见问题FAQ#

本节目的：快速解决常见问题

⏱️ 预计时间：按需查阅

Q1: 启动时报错 "claude: command not found"#

Q2: 报错 "Authentication failed"#

Q3: 响应很慢怎么办#

Q4: 怎么恢复之前的对话#

Q5: 文件修改后怎么回退#

Q6: Claude一直请求确认，太烦了#

注意：仅在个人项目或信任的环境中使用！

Q7: 怎么让Claude记住项目规范#

Q8: 怎么使用Extended Thinking#

Q9: MCP服务器连不上#

Q10: 怎么省钱#

Q11: 怎么处理大文件#

Q12: 怎么批量处理多个文件#

Q13: 输出乱码怎么办#

Q14: 怎么在远程服务器使用#

Q15: 怎么集成到CI/CD#

Q16: 会话突然中断怎么办#

Q17: 怎么看Claude在做什么#

Q18: 怎么取消正在执行的操作#

Q19: 怎么更新Claude Code#

Q20: 配置文件在哪里#

附录A：完整命令速查表#

CLI启动选项#

Slash命令速查#

快捷键速查#

总结#

课程反馈：如果本教程对你有帮助，欢迎分享给更多人！

问题反馈：遇到问题可以使用 /bug 命令报告，或在社区提问。

更新日期：2026年4月5日
版本：v1.4（对齐 GitHub v2.1.90 / v2.1.92 release 原文）