Claude Code for VS Code 使用教程

Claude Code 是 Anthropic 推出的一款 Agentic Coding 工具，也被称为世界最强编程 Agent 之一。Claude Code 的 VS Code 扩展提供了原生的图形化界面，支持内联 Diff 视图、@-mentions 引用、计划审查等功能，是在 VS Code 中使用 Claude Code 的推荐方式。

本文档主要介绍如何通过 AceData Cloud 的代理服务，在 VS Code 中配置和使用 Claude Code 扩展。

申请流程

要使用 Claude Code，首先可以到 Claude Messages 服务页面点击「Acquire」按钮，获取请求所需要的凭证：

如果你尚未登录或注册，会自动跳转到登录页面邀请您来注册和登录，登录注册之后会自动返回当前页面。

在首次申请时会有免费额度赠送，可以免费体验 Claude Code 服务。

安装插件

系统要求

VS Code 1.98.0 或更高版本（也支持 Cursor）

安装步骤

在 VS Code / Cursor 的扩展市场中，按 Cmd+Shift+X（Mac）或 Ctrl+Shift+X（Windows/Linux）打开扩展视图，搜索 Claude Code，找到 Anthropic 官方发布的插件并点击「Install」安装：

也可以通过以下链接直接安装：

安装后在弹出的信息提示中选择信任，即可完成安装。

如果安装后扩展没有出现，请重启 VS Code 或在命令面板中执行「Developer: Reload Window」。

配置 AceData Cloud API

第一次打开插件时，会提示登录 Anthropic 官方账号。我们可以跳过官方登录，通过配置 AceData Cloud 的代理 API 来使用，无需官方订阅。

步骤一：创建 config.json

首先需要创建 Claude Code 的配置文件 config.json，不同系统的文件路径如下：

系统	路径
macOS / Linux	`~/.claude/config.json`
Windows	`C:\Users\{用户名}\.claude\config.json`

在该文件中写入以下内容并保存：

1
2
3

{
  "primaryApiKey": "self"
}

步骤二：配置 VS Code 环境变量

回到 VS Code，打开 Claude Code 插件设置。可以通过以下任一方式进入：

在扩展列表中找到 Claude Code，点击齿轮图标 → Extension Settings
打开设置（Cmd+, 或 Ctrl+,），搜索 Claude Code
在 Claude Code 面板中输入 /，选择 General Config

然后点击「在 settings.json 中编辑」跳转到 JSON 配置文件。

在 settings.json 中添加以下 API 配置信息，将 {token} 替换为你在 AceData Cloud 控制台获取的 API 令牌：

{
  "claude-code.environmentVariables": [
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "{token}"
    },
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://api.acedata.cloud"
    }
  ]
}

提示：API 令牌可在 AceData Cloud 控制台中查看。ANTHROPIC_AUTH_TOKEN 的值会被自动添加 Bearer 前缀发送到服务端。

将上方配置插入到 settings.json 的合适位置即可，注意保持 JSON 格式正确。

步骤三：禁用登录提示（可选）

如果不想每次打开都看到登录提示，可以在 VS Code 设置中勾选 Disable Login Prompt：

在设置中搜索「Claude Code login」，找到 Disable Login Prompt 选项并勾选即可。

配置完成后，重新打开 Claude Code 插件面板，即可正常开始使用。

打开 Claude Code 面板

安装并配置完成后，有多种方式打开 Claude Code：

方式	操作
编辑器工具栏	点击编辑器右上角的 ✦ Spark 图标（需要打开一个文件）
状态栏	点击底部状态栏右侧的「✱ Claude Code」（无需打开文件）
命令面板	`Cmd+Shift+P` / `Ctrl+Shift+P`，搜索「Claude Code」
快捷键	`Cmd+Esc`（Mac）/ `Ctrl+Esc`（Windows/Linux）切换焦点

与 Cursor / Copilot 等工具使用侧边栏不同，Claude Code 默认采用编辑区视图作为聊天区域，可视区域更大，内容展示更丰富。你也可以将面板拖动到侧边栏或其他位置。

基本使用

对话交互

在 Claude Code 面板中直接输入自然语言即可与 Claude 交互。例如：

「帮我分析这个项目的整体架构」
「这段代码有 Bug，帮我修一下」
「把这个函数重构一下，提升可读性」
「给这个模块写单元测试」

Claude Code 会自动理解你的代码库上下文，跨文件进行分析和编辑。当 Claude 需要修改文件时，会显示 Diff 对比视图，你可以选择接受或拒绝修改。

上下文引用

在对话中使用 @ 符号可以引用特定文件或上下文：

@filename.py — 引用指定文件（支持模糊匹配）
@src/components/ — 引用整个目录（需要尾部斜杠）
@terminal:name — 引用终端输出

选中编辑器中的代码后，按 Option+K（Mac）/ Alt+K（Windows/Linux）可以快速插入 @ 引用（如 @app.ts#5-10）。

斜杠命令

点击对话框中的 / 图标，或直接输入 /，可以使用丰富的内置功能：

常用命令包括：

命令	功能
`/new`	新建对话
`/model`	切换模型
`/compact`	压缩上下文
`/mcp`	配置 MCP 服务
`/config`	打开设置
`/usage`	查看用量
`/memory`	管理 Claude 记忆
`/help`	显示帮助信息

查看历史对话

点击面板顶部的下拉菜单即可查看历史对话记录，支持按关键词搜索和按时间段（Today、Yesterday、Last 7 days 等）浏览，方便回溯之前的交互内容。点击任意对话即可恢复完整消息历史。

审阅代码变更

当 Claude 需要修改文件时，会显示 Diff 对比视图，展示原始代码和修改后的对比。你可以选择接受或拒绝每项修改，也可以告诉 Claude 你想要的不同做法：

权限模式

通过面板底部的模式指示器可以切换不同的权限模式：

模式	说明
Default（Ask）	每次操作前询问确认（默认）
Plan	Claude 先制定计划等待审批，确认后才执行
acceptEdits	自动接受文件编辑，但终端命令仍需确认
bypassPermissions	跳过所有权限提示，完全自动化（谨慎使用）

多会话并行

使用命令面板中的 Open in New Tab 或 Open in New Window 可以启动多个独立对话，每个对话维护独自的历史和上下文，可以并行处理不同任务。

其他设置

切换模型

Claude Code 支持切换不同的模型，例如 Claude Sonnet、Claude Opus 等。可以通过 /model 命令或在插件设置的 Selected Model 中配置。

自动模式

在插件设置中可以将 Initial Permission Mode 设为 bypassPermissions，开启后 Claude Code 执行文件编辑、终端命令等操作时不再逐一弹窗确认，实现全自动化工作流。

也可以设为 acceptEdits 实现自动接受编辑但终端命令仍需确认的半自动模式。

注意：开启自动模式前请确保你了解其风险，建议在可信的项目环境中使用。

在终端中使用 CLI

如果你更偏好命令行风格，可以在 VS Code 设置中勾选 Use Terminal，Claude Code 会以 CLI 模式在集成终端中运行。你也可以直接打开 VS Code 集成终端，运行 claude 命令。

常见问题

连接失败怎么办？

检查 ~/.claude/config.json 文件是否正确创建，内容为 {"primaryApiKey": "self"}
确认 VS Code settings.json 中环境变量配置正确，特别是 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL
确认 API 令牌有效（可在控制台查看）
重启 VS Code 后重试

静觅崔庆才的个人站点 - Python爬虫教程