Appearance
VS Code 扩展
Claude Code VS Code 扩展提供原生图形界面，直接集成到编辑器中。你可以在 VS Code 里审查 Claude 的计划、查看内联 diff、@提及特定文件范围，以及管理多个对话。
安装要求
- VS Code 1.98.0 或更高版本
- Anthropic 账户（首次打开扩展时登录）
安装扩展
或者在 VS Code 扩展视图（Cmd+Shift+X / Ctrl+Shift+X）中搜索"Claude Code"并安装。
安装后如果不显示，运行"Developer: Reload Window"重启扩展。
快速开始
打开 Claude 面板
有几种方式打开 Claude Code 面板：
- 编辑器工具栏：打开文件后点击右上角的 Spark 图标（最快）
- 活动栏：点击左侧边栏的 Spark 图标，查看会话列表
- 命令面板：
Cmd+Shift+P输入"Claude Code"，选择"Open in New Tab" - 状态栏：点击右下角的"✱ Claude Code"（即使没有打开文件也可用）
首次打开会看到"Learn Claude Code"引导清单，点击各项学习，或点击 X 关闭。
发送提示
Claude 自动看到你选中的文本。
插入 @提及文件： 按 Option+K (Mac) / Alt+K (Windows/Linux) 将当前文件和选中行数作为 @提及引用插入提示框（如 @file.ts#5-10）。
引用文件和目录：
解释 @auth 中的逻辑（模糊匹配 auth.js、AuthService.ts 等）
@src/components/ 目录下有什么？（目录需要加斜杠）多行输入： 按 Shift+Enter 换行而不发送。
审查改动
Claude 要编辑文件时，会显示并排的对比（原版 vs 建议改动），然后请求你的确认。你可以接受、拒绝，或告诉 Claude 换个方式。
权限模式
点击提示框底部的模式指示器切换：
| 模式 | 行为 |
|---|---|
| 默认 | 每次操作前询问 |
| 计划模式 | 描述计划后等待批准，VS Code 自动将计划作为 Markdown 文档打开 |
| 自动接受 | 无需确认直接编辑文件 |
在 VS Code 设置中设置默认模式：claudeCode.initialPermissionMode
多对话管理
在新标签页打开：命令面板 → "Open in New Tab"，或使用 Cmd+Shift+Esc (Mac) / Ctrl+Shift+Esc (Windows/Linux)
每个对话有独立的历史和上下文，可以同时处理不同任务。标签上有状态点：蓝色表示有待确认的权限请求，橙色表示 Claude 在后台完成了任务。
快捷键
| 快捷键 | 说明 |
|---|---|
Cmd+Esc / Ctrl+Esc | 在编辑器和 Claude 之间切换焦点 |
Cmd+Shift+Esc / Ctrl+Shift+Esc | 在新标签页打开对话 |
Cmd+N / Ctrl+N | 开始新对话（需要 Claude 处于焦点） |
Option+K / Alt+K | 插入当前文件和选中内容的 @提及（需要编辑器处于焦点） |
配置说明
扩展设置（VS Code 内）
Cmd+, → 扩展 → Claude Code：
| 设置 | 默认值 | 说明 |
|---|---|---|
selectedModel | default | 默认模型（可在会话中用 /model 切换） |
useTerminal | false | 使用 CLI 终端模式而不是图形面板 |
initialPermissionMode | default | 初始权限模式 |
autosave | true | Claude 读写文件前自动保存 |
useCtrlEnterToSend | false | 用 Ctrl/Cmd+Enter 发送而不是 Enter |
Claude Code 设置（跨扩展和 CLI 共用）
设置存在 ~/.claude/settings.json，扩展和 CLI 共享。用于权限规则、Hooks、MCP 服务器等。
添加
"$schema": "https://json.schemastore.org/claude-code-settings.json"到 settings.json 可获得 VS Code 内的自动补全和验证。
回退检查点
扩展支持检查点功能，悬停任何消息就能看到回退按钮，有三个选项：
- 从此分叉对话：保留所有代码改动，创建新对话分支
- 回退代码到此处：保留对话历史，回退文件改动
- 分叉并回退代码：两者同时执行
连接 MCP 服务器
在集成终端（Ctrl+` 或 Cmd+`）中运行：
bash
claude mcp add --transport http github https://api.githubcopilot.com/mcp/配置好后，在聊天面板输入 /mcp 管理 MCP 服务器（启用/禁用、重连、OAuth 认证）。
使用第三方提供商
如果你的组织用 Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry：
- 打开 Disable Login Prompt 设置 并勾选
- 按照对应提供商的配置指南设置
扩展 vs CLI 的功能差异
| 功能 | CLI | VS Code 扩展 |
|---|---|---|
| 命令和 Skills | 全部 | 部分（输入 / 查看可用的） |
| MCP 服务器配置 | 完整 | 部分（用 CLI 添加，/mcp 管理） |
| 检查点回退 | 是 | 是 |
! Bash 快捷方式 | 是 | 否 |
| Tab 自动补全 | 是 | 否 |
需要 CLI 专属功能时，打开集成终端运行 claude。
常见问题
找不到 Spark 图标
- 需要打开一个文件（仅有文件夹不够）
- VS Code 版本需要 1.98.0 以上
- 运行"Developer: Reload Window"
- 临时禁用其他 AI 扩展（Cline、Continue 等）
状态栏右下角的"✱ Claude Code"即使没有文件打开也始终可用。
Claude Code 无响应
- 检查网络连接
- 尝试开始新对话
- 在终端运行
claude查看详细错误信息
卸载
在扩展视图中搜索"Claude Code"，点击卸载。
同时删除扩展数据：
bash
rm -rf ~/.vscode/globalStorage/anthropic.claude-code