Claude Code 完整使用教程（2026最新版）

Claude Code 完整使用教程（2026最新版）

更新时间：2026年6月6日 · 基于 Claude Code v2.1.167 + 官方 GitHub releases 校验修正
涵盖 Claude Code v2.1.90~v2.1.167 完整更新 · 文档版本：v2.8 · 下次计划更新：2026年7月6日

📋 文档验证说明：本教程已通过事实核查（2026年6月6日），基于 code.claude.com/docs/en/changelog 官方更新日志 + 官方定价页 + 桌面应用文档三重验证。已修正桌面功能归属、模型列表、认证流程等关键信息。

🕐 预计学习时间：完整学习本教程约需 3-4小时（按章节分段学习）。如果你是 Claude Code 新手，建议先完成 第2.5节「快速开始：5分钟完成第一个任务」 获得即时成就感，再逐步深入学习各章节。

目录

1. Claude Code 是什么？
2. 安装与配置
3. 核心界面与交互
4. 斜杠命令大全
5. 高效提示词技巧
6. 记忆系统：CLAUDE.md 与 Auto Memory
7. 会话管理
8. 快捷键完全指南
9. 扩展思考模式
10. Git 集成
11. MCP 扩展协议
12. 自定义命令与 Skills
13. Hooks 自动化钩子
14. 插件生态 Plugin Ecosystem
15. Voice Mode 语音模式
16. Channels 推送会话
17. Headless 无头模式
18. Checkpointing 文件追踪与回滚
19. 权限与安全（含 Auto Mode）
20. 模型切换、定价与第三方 Provider
21. 多代理协作（含 Agent Teams）
22. 成本控制与优化
23. 计划任务与自动化
24. 常见问题与解决

1. Claude Code 是什么？

Claude Code 是由 Anthropic 公司推出的 AI 驱动命令行编程工具，通过自然语言对话完成代码编写、调试、重构等开发任务。它不是简单的代码补全工具，而是一个能够理解整个代码库、跨文件操作、自主规划执行步骤的智能代理。

核心能力

Claude Code vs 其他工具

2. 安装与配置

2.1 安装 Claude Code

macOS / Linux / WSL：

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell：

irm https://claude.ai/install.ps1 | iex

Homebrew（macOS 推荐）：

注意：Homebrew 安装的为稳定版（约滞后官方最新版一周），且不会自动更新，需手动 brew upgrade claude-code。
如需即时最新版本，使用 brew install --cask claude-code@latest。

brew install --cask claude-code          # 稳定版（约滞后一周，需手动升级）
brew install --cask claude-code@latest   # 最新版（即时更新，也需手动升级）

Windows WinGet：

winget install Anthropic.ClaudeCode

安装完成后，首次运行 claude 命令，按浏览器提示登录 Anthropic 账户完成认证（需 Pro/Max/Team/Enterprise/Console 账户）。Console API 用户也可通过 ANTHROPIC_API_KEY 环境变量使用 API Key（从 console.anthropic.com 获取）。

v2.1.113+ 变更：CLI 改为生成原生二进制文件（通过按平台的可选依赖），而非捆绑 JavaScript。安装更轻量，启动更快。

2.2 多界面版本

2.3 桌面应用特色功能

桌面应用提供 CLI 版本没有的图形化专属功能：

说明：以下功能为 CLI 通用功能（非桌面专属，在桌面应用的集成终端中同样可用）：

• Voice Mode（语音对话）：CLI /voice 命令，v2.1.50+
• Auto Memory（自动记忆）：环境变量 CLAUDE_CODE_AUTO_MEMORY=1 开启，v2.1.60+
• Agent Teams（代理团队）：CLI 多实例并行，v2.1.32+
• 第三方 Provider（Bedrock/Vertex/Foundry）：桌面应用默认仅支持 Anthropic API

💡 下载地址：macOS · Windows

2.4 模型选择

Claude Code 支持多个 Claude 模型，通过 /model 命令切换：

/model          # 交互式选择模型
/model list     # 查看可用模型列表

关于 Effort 级别：

• Opus 4.8 默认 Effort 为 high（v2.1.154+），支持额外 xhigh 级别
• Pro/Max 订阅用户 Opus 4.6/4.7 和 Sonnet 4.6 的默认 Effort 已从 medium 提升为 high（v2.1.117+）
• 使用 /effort 打开交互式滑块调节（方向键导航，Enter 确认）
• 也可用 /effort high、/effort xhigh、/effort max 直接设置

2.5 快速开始：5分钟完成第一个任务

🚀 新手友好：如果你刚安装完 Claude Code，按照以下步骤可以在5分钟内完成第一个实际任务，快速体验其核心能力。

步骤1：验证安装

claude --version  # 应显示 v2.1.101 或更高版本

步骤2：创建测试项目目录

mkdir claude-test && cd claude-test
echo "# Claude Code 测试项目" > README.md

步骤3：运行第一个命令

启动 Claude Code 并输入以下内容：

"分析这个目录结构，并为一个简单的 Node.js Web API 项目建议合理的文件结构"

步骤4：查看结果

Claude 将：

1. 读取当前目录（仅 README.md）
2. 理解你要创建 Node.js Web API 项目的需求
3. 生成包含以下结构的建议：
   • package.json（基础配置）
   • src/ 目录（源代码）
   • index.js（入口文件）
   • .gitignore（Git 忽略文件）
   • 可能还包括 Dockerfile、测试目录等

步骤5：进一步探索

成功生成结构后，可以尝试：

• 让 Claude 直接创建这些文件："请按照你建议的结构创建这些文件"
• 让 Claude 编写一个简单的 API 端点："在 src/ 目录下创建一个 user.js，实现 GET /users 和 POST /users 端点"
• 让 Claude 运行项目："安装依赖并启动这个 Node.js 项目"

💡 提示：首次使用可能会提示权限确认，这是正常的安全机制。对于创建文件等操作，点击"Approve"即可。

3. 核心界面与交互

3.1 启动方式

claude                    # 新建会话
claude --continue         # 继续最近会话（断点续传）
claude --resume           # 从历史会话列表选择
claude --teleport <id>    # 将网页版会话传送到本地
claude <项目路径>          # 直接进入指定项目

3.2 对话流程

用户输入任务
    ↓
Claude 分析需求，理解代码库
    ↓
规划执行步骤（复杂任务会列出步骤清单）
    ↓
执行：读写文件、运行命令、调用工具
    ↓
展示结果，等待下一步指令

3.3 基本操作示例

# 编写功能
帮我写一个用户登录的 REST API

# 修复错误
修复这个空指针异常：Error at line 42 in auth.js

# 重构代码
把这个Java类从过程式改成面向对象

# 运行测试
运行项目中的所有单元测试并报告覆盖率

# 解释代码
解释一下这个算法的逻辑

4. 斜杠命令大全

在 Claude Code 中输入 / 可查看所有可用斜杠命令，以下是核心命令详解：

4.1 会话管理

4.2 配置与信息

4.3 编辑模式

4.4 特殊模式