一、概述

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 用于自动化脚本和后台任务。