一、概述
Claude Code 提供 VS Code 官方扩展，将 AI 编程助手直接集成到 IDE 中。扩展本身免费，使用需绑定 Anthropic 账户（Pro / Max / Team / Enterprise 订阅）或 API 密钥按量付费。
**VS Code 版本要求：** 1.98.0 或更高版本。
二、安装 Claude Code VS Code 扩展
VS Code 内安装（推荐）
1. 打开 VS Code
2. 按 `Ctrl+Shift+X`（Windows/Linux）或 `Cmd+Shift+X`（Mac）打开扩展面板
3. 搜索 **"Claude Code for VS Code "**，选择发布者为 `Anthropic` 的扩展
4. 点击 **安装**，安装完成后点击 **重新加载窗口**
三、配置deepseek
按Ctrl+,打开设置，顶部搜索“Claude Code。点右侧的“编辑 in settings.json”，会自动打开配置文件
"claudeCode.environmentVariables": [
{
"name": "ANTHROPIC_BASE_URL",
"value": "https://api.deepseek.com/anthropic"
},
{
"name": "ANTHROPIC_AUTH_TOKEN",
"value": "deepseek -api "
},
{
"name": "ANTHROPIC_MODEL",
"value": "deepseek-v4-pro[1m]"
},
{
"name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
"value": "deepseek-v4-pro[1m]"
},
{
"name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
"value": "deepseek-v4-pro[1m]"
},
{
"name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
"value": "deepseek-v4-flash"
},
{
"name": "CLAUDE_CODE_SUBAGENT_MODEL",
"value": "deepseek-v4-flash"
},
{
"name": "CLAUDE_CODE_EFFORT_LEVEL",
"value": "max"
}
]
**密钥说明：** `ANTHROPIC_API_KEY`（用于官方 api.anthropic.com，`x-api-key` 标头）和 `ANTHROPIC_AUTH_TOKEN`（用于第三方兼容 API，`Bearer` 标头）**互斥**，不要同时设置，否则会报 401 错误。
四、验证deepseek
左边找到 Claude Code 的图标，点开它。或者直接 Ctrl+Shift+P，敲 “Claude Code: Start Chat” 然后回车
五、核心操作与快捷键
5.1 三种权限模式（`Shift+Tab` 循环切换）
| 模式 | 行为 | 适用场景 |
|------|------|----------|
| **编辑模式**（默认） | Claude 提出修改建议，逐一审批 | 需要精细控制每次编辑 |
| **自动接受模式** | Claude 直接修改代码，无需确认 | 快速搭建、原型开发 |
| **计划模式** | Claude 只读分析代码，不修改 | 架构探索、代码审查 |
5.2 @-mention 文件引用
在对话中输入 `@` 可以引用文件、文件夹或代码行范围，支持模糊匹配：
@src/utils.ts # 引用文件
@src/components/ # 引用整个文件夹
@src/app.ts:42-58 # 引用特定行范围
```
5.2 内联差异审查
Claude 每次编辑后，VS Code 会以内联差异（diff）形式展示修改内容，可以：
- **接受**（Apply）—— 保留此修改
- **拒绝**（Discard）—— 撤销此修改
- 逐条审查，精确控制代码变更
六、配置与设置
6.1 项目级配置：CLAUDE.md
在项目根目录创建 `CLAUDE.md` 文件，指导 Claude 理解项目：
```markdown
# 项目概述
简要描述项目用途。
## 常用命令
- npm run dev # 启动开发服务器
- npm run build # 生产构建
- npm run test # 运行测试
## 代码规范
- 使用 TypeScript 严格模式
- 提交前运行 lint 检查
CLAUDE.md 可通过 `/init` 命令自动生成，也可通过 `/memory` 手动编辑。
七、VS Code 扩展 vs 终端 CLI
| 能力 | VS Code 扩展 | 终端 `claude` 命令 |
|------|-------------|-------------------|
| 可视化差异对比 | 并排内联 diff，可点击接受/拒绝 | 纯文本 diff |
| 回退机制 | 自动检查点，双击 Esc 一键回退 | 手动 git 操作 |
| 文件引用 | @-mention 模糊匹配 + 行号 | 手动粘贴路径 |
| 多会话 | 多标签页，对话历史 | 每终端一个会话 |
| 纯键盘操作 | 鼠标+键盘结合 | 纯键盘流 |
| 自动化/CI | 不支持 | `claude --print`、GitHub Actions |
| 资源占用 | 较高（在 VS Code 内） | 较低（独立终端进程） |
**推荐实践：** 两者互补使用 —— 扩展用于交互式编码和 diff 审查，终端 CLI 用于自动化脚本和后台任务。
