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分钟完成第一个任务」 获得即时成就感，再逐步深入学习各章节。
目录
- Claude Code 是什么？
- 安装与配置
- 核心界面与交互
- 斜杠命令大全
- 高效提示词技巧
- 记忆系统：CLAUDE.md 与 Auto Memory
- 会话管理
- 快捷键完全指南
- 扩展思考模式
- Git 集成
- MCP 扩展协议
- 自定义命令与 Skills
- Hooks 自动化钩子
- 插件生态 Plugin Ecosystem
- Voice Mode 语音模式
- Channels 推送会话
- Headless 无头模式
- Checkpointing 文件追踪与回滚
- 权限与安全（含 Auto Mode）
- 模型切换、定价与第三方 Provider
- 多代理协作（含 Agent Teams）
- 成本控制与优化
- 计划任务与自动化
- 常见问题与解决
1. Claude Code 是什么？
Claude Code 是由 Anthropic 公司推出的 AI 驱动命令行编程工具，通过自然语言对话完成代码编写、调试、重构等开发任务。它不是简单的代码补全工具，而是一个能够理解整个代码库、跨文件操作、自主规划执行步骤的智能代理。
核心能力
| 能力 | 说明 |
|---|---|
| 代码读写 | 读取整个代码库，编辑多文件 |
| 命令执行 | 运行终端命令、构建项目、启动服务 |
| 工具集成 | Git、MCP 扩展、浏览器、文件系统 |
| 主动规划 | 任务拆解、步骤执行、结果验证 |
| 持久记忆 | 跨会话记住项目规则和上下文 |
Claude Code vs 其他工具
| 工具 | 定位 | 特点 |
|---|---|---|
| Claude Code | 终端代理 | 最强推理能力，支持深度思考 |
| Codex CLI | 终端代理 | OpenAI 出品，与 GitHub 深度集成 |
| Gemini CLI | 终端代理 | Google 出品，多模态能力强 |
| Cursor | IDE 插件 | 适合实时编辑，小规模修改 |
| GitHub Copilot | IDE 插件 | 代码补全为主 |
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 多界面版本
| 版本 | 安装方式 | 特点 |
|---|---|---|
| 终端 CLI | npm/npx/clang | 最完整功能，推荐使用 |
| VS Code 扩展 | VS Code Marketplace | 内联差异、@-提及 |
| JetBrains 插件 | JetBrains Marketplace | IDEA/PyCharm/WebStorm 等 |
| 桌面应用 | 官网下载 | 支持并行会话、定时任务、计算机控制 |
| 网页版 | claude.ai/code | 无需本地安装 |
2.3 桌面应用特色功能
桌面应用提供 CLI 版本没有的图形化专属功能：
| 功能 | 说明 | 版本要求 |
|---|---|---|
| 并行会话 | 多个会话分屏并排，支持 Git 分支隔离 | 全版本 |
| 定时任务 | 设置每日自动化任务（代码审查、依赖审计等） | Desktop App |
| 计算机控制 | 让 Claude 操作本地鼠标和键盘 | v2.1.50+ |
| Dispatch | 从手机端向桌面应用推送任务 | Desktop App |
| PR 监控 | 自动追踪项目 PR 状态（via GitHub CLI） | Desktop App |
| App Preview | 嵌入式浏览器预览 Web 应用渲染效果 | Desktop App |
| 侧边聊天 (Side Chat) | Cmd+; 快速提问，不影响主会话 |
Desktop App |
| 连接器 UI | 图形化管理 Slack/GitHub/Linear 等集成 | Desktop App |
| 桌面通知 | 任务完成时系统通知 | Desktop App |
说明：以下功能为 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
2.4 模型选择
Claude Code 支持多个 Claude 模型，通过 /model 命令切换：
/model # 交互式选择模型
/model list # 查看可用模型列表
| 模型 | 适用场景 | 说明 | 价格等级 |
|---|---|---|---|
| Claude Sonnet 4.6（默认） | 日常编程，性价比最高 | 推荐日常使用，速度与能力最佳平衡 | ⭐⭐ |
| Claude Haiku 4.5 | 简单快速任务 | 最低延迟，成本最低，适合轻量任务 | ⭐ |
| Claude Opus 4.8（v2.1.154+） | 旗舰推理，Max 订阅者 | 最新旗舰，默认高 effort，支持 xhigh | ⭐⭐⭐⭐⭐ |
| Claude Opus 4.7（legacy） | 超复杂推理 | 已被 4.8 取代，仍可用 | ⭐⭐⭐⭐ |
| Claude Opus 4.6（legacy） | 复杂架构推理 | 旧版旗舰，仅 Pro/Max 用户 | ⭐⭐⭐⭐ |
关于 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 将：
- 读取当前目录（仅 README.md）
- 理解你要创建 Node.js Web API 项目的需求
- 生成包含以下结构的建议：
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 会话管理
| 命令 | 功能 |
|---|---|
/continue |
继续上一个未完成的任务 |
/resume |
从历史会话列表恢复 |
/rename <名称> |
给当前会话命名 |
/clear |
清空当前上下文，重新开始 |
/compact |
压缩对话历史，保留摘要 |
/export |
导出整段对话为 Markdown 文件 |
/quit |
退出 Claude Code |
/recap |
v2.1.108+ 会话回顾，返回时提供上下文摘要 |
/undo |
v2.1.108+ /rewind 的别名 |
/fork |
v2.1.118+ 创建会话分支 |
/color |
v2.1.118+ 设置会话强调色；无参数随机生成颜色（v2.1.128+） |
/goal <条件> |
v2.1.139+ 设置完成条件，跨轮次持续工作直至满足条件 |
/plugin list |
v2.1.163+ 列出已安装插件（支持 --enabled/--disabled 过滤） |
/reload-skills |
v2.1.152+ 重新扫描技能目录，无需重启会话 |
/code-review |
v2.1.147+ 代码审查（原 /simplify），支持 --fix 和 --comment |
/simplify |
v2.1.147+ 现为 /code-review --fix 别名 |
/btw |
v2.1.163+ 查看对话；c 快捷键复制原始 Markdown |
/branch |
v2.1.157+ 会话分支管理 |
claude agents |
v2.1.139+ Agent View 统一会话列表视图 |
4.2 配置与信息
| 命令 | 功能 |
|---|---|
/model |
切换 AI 模型；v2.1.126+ 支持网关模型发现（CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY） |
/model list |
查看可用模型列表 |
/cost |
查看当前会话 Token 消耗（/usage 别名） |
/usage |
v2.1.118+ 打开使用统计仪表盘（合并 cost/stats） |
/stats |
使用统计仪表盘（/usage 别名） |
/context |
查看上下文各部分 Token 占比 |
/config |
配置自动压缩、会话回顾等功能 |
/statusline |
自定义底部状态栏内容 |
/effort |
v2.1.111+ 打开交互式 Effort 级别滑块 |
/theme |
v2.1.118+ 创建和切换自定义主题 |
/doctor |
改进 可在 Claude 响应时打开，按 f 自动修复问题 |
/scroll-speed |
v2.1.139+ 调节鼠标滚轮速度，实时预览 |
/terminal-setup |
v2.1.157+ 终端设置（GPU 加速等） |
/chrome |
v2.1.157+ 选择 Chrome 浏览器连接 |
/remote-control |
v2.1.157+ 远程控制管理 |
/insights |
v2.1.149+ 会话洞察分析 |
/feedback |
v2.1.149+ 发送反馈 |
/diff |
v2.1.149+ 查看差异（支持键盘滚动） |
/autofix-pr |
v2.1.149+ 自动修复 PR |
/ultracode |
v2.1.160+ 动态工作流触发关键词（原 workflow） |
! <命令> |
v2.1.154+ 后台会话中运行 shell 命令 |
4.3 编辑模式
| 命令 | 功能 |
|---|---|
/vim |
开启 Vim 编辑模式（v2.1.118+ 支持 v/V 可视模式） |
/write |
直接写入文件内容 |
/read |
读取并分析文件 |
4.4 特殊模式
| 命令 | 功能 | 版本要求 |
|---|---|---|
/sandbox |
开启沙盒模式，预定义权限白名单 | 全版本 |
/permission-browser |
打开权限浏览器 | 全版本 |
/subagent |
创建子代理，并行处理任务 | 全版本 |
/think |
开启或关闭扩展思考模式 | 全版本 |
/ultraplan |
远程计划模式（云端环境） | v2.1.91+ |
/ultrareview |
v2.1.111+ 云端代码审查（无参数审查当前分支，/ultrareview <PR#> 审查指定 PR） |
|
/mcp list |
查看已连接 MCP 服务器状态 | 全版本 |
/mcp add |
添加新的 MCP 服务器 | 全版本 |
/plugin |
管理插件（安装/卸载/marketplace） | v2.1.60+ |
/memory |
打开并编辑 CLAUDE.md | 全版本 |
/voice on/off |
开启或关闭语音对话模式 | v2.1.50+ |
/powerup |
进入交互式学习模式（约10节课程） | v2.1.90+ |
/loop <task> |
设置定时循环任务 | Desktop App |
/proactive |
v2.1.105+ /loop 的别名 |
全版本 |
/tui |
v2.1.110+ 全屏无闪烁渲染模式（/tui fullscreen）</ |
1901
扫一扫
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
