Claude Code 使用教程 ⌨️
"Claude Code 是 Anthropic 官方的终端 AI 编程助手,本文档涵盖从入门到进阶的完整使用指南。"
1. Claude Code 概述
1.1 什么是 Claude Code
Claude Code 是 Anthropic 推出的命令行 AI 编程工具:
- 终端原生: 在命令行中运行
- Agentic: 能自主规划和执行多步任务
- 权限模型: 精细的权限控制
- 迭代执行: 持续工作直到任务完成
1.2 与 Cursor 的区别
| 特性 | Claude Code | Cursor |
|---|---|---|
| 界面 | 终端 CLI | IDE GUI |
| 触发 | 显式命令 | 快捷键/对话 |
| 权限 | 显式授权 | IDE 集成 |
| 目标用户 | 命令行用户 | IDE 用户 |
2. 安装与配置
2.1 安装
curl -fsSL https://claude.ai/install.sh | sh2.2 登录认证
首次启动需登录,或手动执行 /login。
认证方式:
- 订阅制:Claude Pro/Max 会员,无需额外配置
- API Key:按 token 计费,需配置环境变量
使用国产模型:GLM、MiniMax 等,设置相应环境变量即可。
2.3 启动参数
claude # 标准启动
claude -c # 恢复上次会议
claude /path/to/project # 指定目录
claude --dangerously-skip-permissions # 危险模式(跳过权限)3. 三种工作模式
通过 Shift + Tab 循环切换:
| 模式 | 特征 | 行为 | 适用场景 |
|---|---|---|---|
| 默认模式 | ? For shortcuts | 修改前必询问 | 学习、不确定时 |
| 自动模式 | Accept Edits On | 自动执行不询问 | 快速开发、批量操作 |
| 规划模式 | Plan Mode | 只讨论不修改 | 方案讨论、架构设计 |
4. 基础交互
- Enter:提交问题
- Shift + Enter:换行继续输入
- Ctrl + G:打开 VS Code 编辑器,保存后内容自动填入输入框
- !:进入 shell 模式,执行终端命令(如
!npm run dev) - 拖拽图片 / Ctrl+V:粘贴图片到对话
5. 权限与操作确认
5.1 文件操作权限
当 Claude 要创建/修改文件时:
- Allow:单次同意
- Always allow [path]:以后访问该路径都不问
- Deny:拒绝
5.2 终端命令权限
执行命令时会询问,选项同上。危险模式 --dangerously-skip-permissions 可跳过所有权限,仅在可信环境使用。
5.3 权限分层
| 层级 | 操作 |
|---|---|
| 自动通过 | 读文件、搜索、查看 git |
| 需要确认 | 写文件、编辑、删除、执行命令 |
| 显式权限 | 网络访问、git 提交 |
| 禁止 | 访问忽略文件、系统修改 |
6. 常用命令与快捷键
6.1 快捷命令
| 命令 | 功能 |
|---|---|
/login | 登录认证 |
/help | 查看帮助 |
/memory | 编辑 CLAUDE.md |
/hooks | 配置 Hooks |
/skills | 查看 Agent Skills |
/agent | 管理 Sub Agents |
/mcp | 管理 MCP Servers |
/plugin | 插件管理器 |
/tasks 或 /t | 查看后台任务 |
/compact | 压缩上下文 |
/clear | 清空上下文 |
/rewind | 回滚 |
/init | 生成 CLAUDE.md |
/resume | 恢复上次会议 |
6.2 快捷键
| 快捷键 | 功能 |
|---|---|
Shift + Tab | 切换工作模式 |
Ctrl + G | 打开 VS Code 编辑器 |
Ctrl + B | 后台/前台切换任务 |
Ctrl + O | 查看上下文 |
Ctrl + C | 取消当前操作 |
ESC | 返回上级/退出 |
双击 ESC | 进入回滚界面 |
Shift + Enter | 输入框换行 |
Enter | 提交问题 |
7. 规划模式
规划模式用于复杂任务:只讨论不执行,适合架构设计、需求分析。
7.1 使用流程
Shift + Tab切换到规划模式- 描述需求(如「将 HTML 项目重构为 React + TypeScript + Vite」)
- Claude 生成详细计划(项目结构、技术栈、功能清单、执行步骤)
- 可提出修改意见完善计划
- 选择执行方式:自动模式 / 默认模式 / 继续修改计划
7.2 执行选项
- 执行计划并进入自动模式:后续不再询问
- 执行计划并使用默认模式:每次写入前都询问
- 继续修改计划:完善后再执行
8. 终端与后台任务
8.1 Shell 模式
输入 ! 进入 shell,可执行 ls、npm install、npm run dev 等命令。
8.2 后台任务
- 启动服务后按 Ctrl + B 将任务放到后台
/tasks或/t查看运行中的任务- 按 K 结束选中的任务
典型流程:!npm run dev → Ctrl+B 放后台 → 继续让 Claude 改代码 → 实时查看效果 → /tasks 按 K 关闭服务。
9. 回滚功能
9.1 触发方式
- 命令:
/rewind - 快捷键:双击 ESC
9.2 回滚选项
选择回滚点后可选:
- Rollback code & session:回滚代码和会话
- Rollback session only:只回滚对话
- Rollback code only:只回滚代码
- Cancel:放弃
9.3 局限性
Claude Code 只能回滚它自己写入的文件。终端命令创建的文件(如 mkdir、npm install 产生的 node_modules)需手动删除。建议用 git 管理版本,回滚作为补充。
10. 上下文管理
长时间使用后上下文会膨胀,可:
/compact:压缩上下文,可指定策略如/compact 重点保留用户提出的需求/clear:清空上下文,全新开始- Ctrl + O:查看当前上下文
建议每完成一个大功能后执行 /compact。
11. CLAUDE.md 项目配置
CLAUDE.md 让 Claude 每次启动时读取项目信息。
11.1 生成与编辑
/init:自动生成/memory:编辑 CLAUDE.md
11.2 配置级别
| 级别 | 位置 | 作用范围 |
|---|---|---|
| 项目 | 项目根目录 CLAUDE.md | 当前项目 |
| 用户 | ~/.claude/CLAUDE.md | 所有项目 |
11.3 模板示例
# 项目名称
## 项目概述
## 技术栈
## 开发规范
## 注意事项12. Hooks 自动化
Hooks 在特定时机自动执行逻辑:Pre/Post Tool Use、Tool Use Failed、Send Notification。
12.1 自动格式化示例
/hooks → Post Tool Use → Matcher: write 或 edit → Hook 命令:
echo '$JSON' | jq -r '.filePath' | xargs prettier --write12.2 保存级别
- Local:
settings.local.json,加入 .gitignore - Project:
settings.json,随 git 分发 - User:
~/.claude/,不跟随项目
13. Agent Skills 与 Sub Agents
13.1 Agent Skills
给模型看的「说明书」,用于重复性任务(如每日总结、固定格式文档)。
创建:~/.claude/skills/xxx/skill.md,需包含 # name: 和 # description: 元数据。
使用:自动触发(识别意图)或手动 /skill-name 参数。
13.2 Sub Agents
拥有独立上下文和工具的独立 Agent,适合与主对话关联小、影响大的任务(如代码审核)。
| 特性 | Agent Skill | Sub Agent |
|---|---|---|
| 上下文 | 共享 | 独立 |
| 适用 | 与上下文关联大 | 与上下文关联小 |
| 示例 | 每日总结 | 代码审核 |
创建:/agent → Create New Agent → 描述用途 → 选择工具(如 Read Only)→ 选择模型。
14. MCP 集成
MCP 是大模型与外部工具沟通的协议。
14.1 安装与认证
# 安装(以 Figma 为例)
npx -y @modelcontextprotocol/server-figma
# 重启 Claude Code 或 /resume
# 认证
/mcp → 选择 server → authenticate14.2 设计稿还原
- 在 Figma 复制设计稿链接
- 输入「修改当前页面使其与 Figma 稿件一致」并粘贴链接
- Claude 调用
get_design_context、get_screenshot获取精确的设计参数(间距、字体、颜色等) - 生成精确代码
相比直接传图片,MCP 可获取结构化设计信息,还原更准确。
15. Plugins 插件
插件打包了 skills、sub agents、hooks 等能力,一键部署。
15.1 安装
/plugin → Discover → 选择插件 → 选择安装范围(用户/项目)→ 确认。
15.2 Frontend Design 示例
安装后输入「按照 frontend-design 的要求做一个待办软件」,Claude 会加载官方 UI 设计直觉,生成更现代、美观的界面。
16. 典型工作流程
16.1 新项目启动
mkdir project && cd project
claude
/init # 生成 CLAUDE.md
/memory # 编辑配置
# 提出需求16.2 功能开发
规划模式讨论 → 切换到自动模式 → 执行开发 → !npm run dev + Ctrl+B → 持续迭代16.3 大型重构
规划模式详细讨论 → 审查计划 → 执行 → git commit 保存 → /compact 压缩上下文17. 实战案例概要
案例一:待办应用
从 HTML 快速原型开始 → 规划模式讨论重构为 React+TS+Vite → 执行并迭代 → 后台运行服务实时查看。
案例二:设计稿还原
安装 Figma MCP → 认证 → 粘贴设计稿链接 → Claude 精确还原布局和样式。
案例三:重构与回滚
规划模式讨论重构 → 执行 → 不满意时双击 ESC 回滚 → 终端创建的文件需手动清理(rm -rf node_modules 等)。
案例四:插件快速开发
安装 frontend-design 插件 → 按插件规范生成更专业的 UI。
18. 常见问题
| 问题 | 解决 |
|---|---|
| 查看版本 | claude --version |
| 升级 | curl -fsSL https://claude.ai/install.sh | sh |
| 忘记登录 | /login |
| 上下文太大 | /compact 或 /clear |
| 关闭后台服务 | /tasks → 按 K |
| 回滚后残留文件 | 终端命令创建的文件需手动删除,建议用 git |
| Shift+Enter 不好用 | 可能是版本过旧,重新安装升级 |
19. 延伸阅读
- Claude Code 原理分析 - 系统架构与实现细节
- 官方文档
- GitHub
- 插件市场