Claude Code for vscode 新手入门完整教程

一、核心概念

Claude Code 是一个在终端运行的 AI 编程助手，也可在 VS Code、JetBrains IDE 等环境中使用。它通过"代理循环"工作：

收集上下文 → 执行操作 → 验证结果 → 循环直到完成

二、三种权限模式

按 Shift+Tab 或 Alt+M 循环切换：

模式	说明
Default（默认模式）	文件编辑和 Shell 命令都需要确认
Auto-accept edits（自动接受编辑）	自动接受文件编辑，命令仍需确认
Plan Mode（计划模式）	只读分析模式，Claude 只能分析不能修改，适合先规划再实现

三、会话恢复的三种方式

命令	功能
`claude --continue`	恢复最近一次会话，继续上次对话
`claude --resume`	选择并恢复历史会话列表中的某个会话
`claude --continue --fork-session`	分叉会话：从某个历史点创建新分支，原会话不受影响

注意：恢复会话时，会话级权限不会继承，需要重新授权。

四、常用斜杠命令

命令	功能
`/init`	初始化项目，创建 CLAUDE.md
`/clear`	清除对话历史
`/compact [instructions]`	压缩对话以节省上下文（可加焦点如 `/compact focus on API changes`）
`/model`	切换 AI 模型
`/context`	查看当前上下文使用情况（彩色网格可视化）
`/permissions`	管理权限设置
`/mcp`	查看 MCP 服务器及其上下文消耗
`/add-dir`	添加额外工作目录
`/doctor`	诊断安装问题
`/cost`	显示 Token 使用统计
`/memory`	编辑 CLAUDE.md 记忆文件
`/rewind`	回滚会话或代码
`/resume [session]`	通过 ID 或名称恢复会话
`/plan`	直接进入计划模式
`/vim`	启用 Vim 编辑模式

五、快捷键技巧

通用控制

快捷键	功能
Ctrl+C	取消当前操作
Ctrl+D	退出 Claude Code 会话
Ctrl+L	清除终端屏幕（保留对话历史）
Ctrl+O	切换详细输出模式
Ctrl+R	反向搜索命令历史
Ctrl+B	后台运行任务（Tmux 用户需按两次）
Shift+Tab 或 Alt+M	切换权限模式
Alt+P	切换模型（不清除提示）
Alt+T	切换扩展思考模式
Esc + Esc	撤销代码更改（回滚到检查点）

粘贴图片

快捷键	平台
Ctrl+V	通用
Cmd+V	macOS (iTerm2)
Alt+V	Windows

多行输入

方法	快捷键
快速换行	`\` + `Enter`
macOS 默认	`Option+Enter`
Shift+Enter	iTerm2、WezTerm、Ghostty、Kitty
控制序列	`Ctrl+J`

六、添加文件/代码到对话

方法一：使用 `@` 符号（推荐）

在输入框中输入 @ 后跟文件路径，会触发文件路径自动补全。

方法二：粘贴图片

使用 Ctrl+V（或 macOS 的 Cmd+V）从剪贴板粘贴图片或图片文件路径。

方法三：添加额外目录

启动时 ：claude --add-dir <path>
会话中 ：/add-dir 命令
配置文件 ：在 settings.json 中设置 additionalDirectories

七、撤销与检查点

每次文件编辑前，Claude 会自动创建快照
按 Esc 两次 可回滚到之前的状态
也可以直接告诉 Claude "undo" 撤销更改
检查点仅覆盖本地文件更改，不包括远程操作（数据库、API、部署等）

八、上下文管理技巧

查看上下文

运行 /context 查看当前上下文使用情况（彩色网格可视化）。

压缩上下文

自动压缩：接近上下文限制时自动触发
手动压缩 ：/compact 或 /compact focus on <主题>
保留指令：在 CLAUDE.md 中添加 "Compact Instructions" 部分

使用子代理

输入 "use subagents to investigate X"，子代理在独立上下文中工作，不会污染主对话。完成后返回摘要。

九、高效使用技巧

1. 具体化提示

复制代码

> 修复 src/payments/ 中的结账流程 bug，
> 特别检查 token 刷新逻辑。
> 先写一个失败的测试，然后修复它。

2. 先规划后实现

按 Shift+Tab 两次进入计划模式，让 Claude 先分析代码库，制定方案后再实现。

3. 提供验证条件

复制代码

> 实现 validateEmail 函数。
> 测试用例：'user@example.com' → true,
> 'invalid' → false。运行测试验证。

4. 随时打断和引导

如果 Claude 走错方向，直接输入修正内容并按 Enter，Claude 会停止当前操作并调整方向。

5. 使用 CLAUDE.md

将持久规则、项目约定写入 CLAUDE.md 文件，跨会话保持。

十、Claude 可用的工具

工具	功能	需要权限
Read	读取文件内容	否
Edit/Write	编辑/创建文件	是
Bash	执行 Shell 命令	是
Glob	按模式查找文件	否
Grep	搜索文件内容	否
WebFetch	获取网页内容	是
WebSearch	网络搜索	是
Task	运行子代理	否
AskUserQuestion	向用户提问	否
NotebookEdit	修改 Jupyter notebook	是

十一、Bash 模式（`!` 前缀）

在输入前加 ! 可直接执行 bash 命令，无需 Claude 解释或批准：

bash 复制代码

! npm test
! git status
! ls -la

特点：

命令和输出会添加到对话上下文
显示实时进度和输出
支持 Ctrl+B 后台执行
支持基于历史的自动补全（输入部分命令后按 Tab）

十二、快速参考卡片

复制代码

┌─────────────────────────────────────────────────┐
│           Claude Code 快速参考                   │
├─────────────────────────────────────────────────┤
│ 恢复会话:  claude --continue / --resume         │
│ 分叉会话:  claude --continue --fork-session     │
│ 切换模式:  Shift+Tab 或 Alt+M                   │
│ 撤销更改:  Esc + Esc                            │
│ 后台任务:  Ctrl+B                               │
│ 执行命令:  ! <command>                          │
│ 添加文件:  @ + 文件路径                          │
│ 粘贴图片:  Ctrl+V / Cmd+V / Alt+V               │
│ 压缩上下文: /compact                            │
│ 查看上下文: /context                            │
│ 反向搜索:  Ctrl+R                               │
│ 切换模型:  Alt+P 或 /model                      │
└─────────────────────────────────────────────────┘

以上内容来自 How Claude Code works、Settings、IAM 和 Interactive Mode 页面。

(常用工作流程)[https://code.claude.com/docs/en/common-workflows\]

(最佳实践)[https://code.claude.com/docs/en/best-practices\]

(Memory 与 CLAUDE.md)[https://code.claude.com/docs/en/memory\]

复制代码

Claude Code for vscode 新手入门完整教程