Source: https://aiprimetech.io/zh/claude-code/vscode/

[首页](/zh/) › [Claude Code](/claude-code/zh/) › VS Code

[概览](/claude-code/zh/)[安装](/claude-code/zh/install/)[CLI 参考文档](/zh/claude-code/cli/)[定价与限制](/claude-code/zh/pricing/)[Agent SDK](/zh/claude-code/sdk/)[技能与插件](/zh/claude-code/skills/)[GitHub](/zh/claude-code/github/)[网页、桌面与 IDE](/zh/claude-code/web-and-desktop/)[模型](/zh/claude-code/models/)[错误](/zh/claude-code/errors/)[是否开源？](/zh/claude-code/open-source/)[教程](/claude-code/zh/tutorial/)[学生指南](/zh/claude-code/for-students/)[QA 自动化](/zh/claude-code/qa-automation/)[与 Cursor 对比](/zh/claude-code/vs-cursor/)[与 Codex 和 OpenCode 对比](/zh/claude-code/vs-codex/)[子智能体](/zh/claude-code/subagents/)[钩子](/zh/claude-code/hooks/)[MCP](/zh/claude-code/mcp/)[生态系统](/zh/claude-code/ecosystem/)[VS Code](/zh/claude-code/vscode/)[OpenRouter](/zh/claude-code/openrouter/)[速率限制](/zh/claude-code/rate-limits/)[中文指南](/claude-code/zh/)

最后更新：2026 年 11 月

# 在 VS Code 中使用 Claude Code：扩展、终端方式与常见错误

在 VS Code 中使用 Claude Code 有两种方式，而大家搜索的大多数问题都源于混淆了这两种方式：官方扩展会添加面板和内联差异视图；直接在 VS Code 集成终端中运行 CLI 则使用同一个智能体，无需扩展。本页介绍这两种方式，以及账户检查和错误消息。

## TLDR
- 扩展：安装 anthropic.claude-code ，可从扩展市场获取（或打开 vscode:extension/anthropic.claude-code）；首次启动时，它会自动为你安装 CLI。
- 终端：打开 VS Code 的终端并运行 claude — 适用于所有 VS Code 版本，包括 Cursor，无需扩展。
- 使用哪个账户： /status 在会话中运行后，会显示正在使用的端点、密钥和登录信息；扩展与终端读取相同的环境。
- command 'claude-vscode.editor.openlast' not found = 扩展已安装但未激活，或其封装的 CLI 缺失 — 重新加载窗口，然后检查 claude --version.

## 安装 Claude Code VS Code 扩展 

搜索 Claude Code ，在扩展视图中选择 Anthropic 发布的版本，或将 vscode:extension/anthropic.claude-code 粘贴到浏览器中直接打开。该扩展是 CLI 的前端：首次启动时，它会检查是否存在 claude 可执行文件，如果缺失则进行安装（通过 npm 安装需要 Node.js 18+；原生安装程序无需任何前置依赖）。之后，活动栏中的 Claude 图标会打开聊天面板，智能体所做的每项更改都会显示为内联差异，由你接受或拒绝 — 与终端中的操作流程相同，只是改用编辑器来审查更改。 

```
# check the CLI the extension will use
claude --version
# if it is missing, install it yourself and reload VS Code
npm install -g @anthropic-ai/claude-code     # or: curl -fsSL https://claude.ai/install.sh | bash
```

## 也可以跳过扩展：在集成终端中使用 Claude Code 

打开 VS Code 的终端并运行 claude。这就是完整的智能体 — 规划模式、子智能体、钩子、MCP、 /compact — 无需扩展，即可在任何 VS Code 分支版本中使用，包括 Cursor 和 VSCodium。编辑结果会立即反映在打开的文件中，并由 VS Code 自带的差异视图显示。对于长时间自主执行的任务，大多数人更喜欢这种方式；对于小规模交互式编辑，扩展面板更方便。两者可以同时运行。 

## 检查 Claude Code 在 VS Code 中使用哪个账户 

扩展和终端读取相同的配置，因此无论使用哪种方式，答案都一样：运行 /status ，在会话中执行即可。它会输出端点（ANTHROPIC_BASE_URL）、当前启用的是 API 密钥还是 /login 订阅、模型以及版本。如果环境中设置了 API 密钥，它会优先于登录信息，这通常就是“我用 Max 登录了，却扣了我的 API 余额”的原因。要切换，可以取消设置 ANTHROPIC_API_KEY 以使用订阅，或设置它（使用网关时同时设置 ANTHROPIC_BASE_URL ）以按用量计费。 

```
# use this gateway from VS Code: put these in your shell profile, restart VS Code
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
```

VS Code 会继承启动它的 shell 中的环境变量。如果 /status 在你修改配置文件后仍显示旧端点，请完全退出 VS Code，再从新终端启动 — 仅重新加载窗口是不够的。 

## 错误：找不到命令 'claude-vscode.editor.openlast' 

当快捷键或命令面板在扩展激活前调用它，或扩展已激活但找不到其封装的 CLI 时，就会出现此错误。 

按顺序操作：1） 重新加载窗口 (Developer: Reload Window）— 大多数情况到这一步就能解决。2）运行 claude --version ，在终端中执行；如果找不到，请安装 CLI（见上文），然后再次重新加载。3）检查该扩展是否已在此工作区启用，而不只是已安装。4）如果使用 VS Code 分支版本，请确认扩展版本支持它 — 否则，无论是否支持，都可以使用终端方式。5）最后的办法是卸载扩展，删除 ~/.claude/ 缓存（仅在你接受丢失本地会话历史的情况下），然后重新安装。 

## 其他扩展问题 
- 面板打开但始终为空 → CLI 正在启动；查看输出面板（Claude Code）中的实际错误，通常是 Node.js 版本过旧。
- 始终不显示内联差异 → 工作区不受信任；VS Code 会在受限模式下阻止扩展运行。
- 终端中可以使用，面板中却不行 → 代理或 ANTHROPIC_BASE_URL 仅在 shell 配置文件中设置，未包含在启动 VS Code 时的环境中。
- 401 / 无效密钥 → 密钥与端点不匹配；网关 URL 需要网关密钥，Anthropic URL 需要控制台密钥。 

## 在 VS Code 中使用的费用 

扩展的计费方式与 CLI 完全相同 — 通过其背后的服务按 token 计费。在此网关上，可使用面值为购买价格 7.69231 倍的额度（$13 可购买 $100 的用量，优惠 87%），或选择 $1 起的固定费率不限量套餐；定价指南提供详细说明，模型指南列出了 /model 可选择的模型。 

 | 计划 | 时长 | 价格

 | 1 小时不限量 | 1 小时 | $1

 | 24 小时不限量 | 24 小时 | $10

 | 1 周不限量 | 1 周 | $49

 | 15 天不限量 | 15 天 | $89

[所有不限量套餐 →](/zh/plans/)

## 先免费试用

新账户可获得 $5 免费 API 额度 使用优惠码 CLAUDECODE — 足够用 Sonnet 运行 Claude Code 一晚，之后可获得面值 7.69231 倍的额度。

```
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key
```

[使用优惠码 CLAUDECODE 创建账户](/register?promo=CLAUDECODE)

## 常见问题

VS Code 有 Claude Code 扩展吗？

有，扩展市场上提供 Anthropic 官方的 `anthropic.claude-code` 扩展。它为 CLI 提供面板和内联差异视图；CLI 也可以独立运行在 VS Code 的终端中。如何检查 Claude Code 在 VS Code 中使用哪个账户？

在会话中运行 /status。它会显示端点、当前启用的是 API 密钥还是订阅登录，以及模型。环境中的 API 密钥优先于 /login。如何修复“找不到 'claude-vscode.editor.openlast'”？

重新加载 VS Code 窗口；如果问题仍然存在，请确保 `claude --version` 能在终端中运行（否则请安装 CLI），并确认扩展已在该工作区启用。Claude Code 可以在 Cursor 或 VSCodium 中使用吗？

在集成终端中始终可以使用。如果分支版本的扩展市场提供该扩展，也可以使用扩展。

## 通过网关运行 Claude Code

相同的模型，两个环境变量，面值 7.69231 倍的额度，或固定费率不限量方案。 新账户：使用优惠码 CLAUDECODE 可获得 $5 免费 API 额度。[获取 API 密钥](/register?promo=CLAUDECODE) [查看不限量方案](/zh/plans/)

AI Prime Tech 是独立的 API 网关，与 Anthropic 无关联，也未获得其认可或赞助。“Claude”和“Claude Code”是 Anthropic 的商标。此处介绍的 Claude Code 功能以撰写时 Anthropic 的公开文档为依据，且经常发生变化；本页面的价格和模型列表读取自此网关的实时设置。

## 更多 Claude Code 指南

[Claude Code：完整指南](/claude-code/zh/)[如何安装 Claude Code](/claude-code/zh/install/)[Claude Code CLI 文档：命令与参数](/zh/claude-code/cli/)[Claude Code 定价与限制详解](/claude-code/zh/pricing/)[Claude Code SDK，现已更名为 Claude Agent SDK](/zh/claude-code/sdk/)[Claude Code 技能与插件](/zh/claude-code/skills/)[在 GitHub 中使用 Claude Code：App、Action 和 @claude](/zh/claude-code/github/)[Claude Code 有网页界面吗？网页、桌面与 IDE 版本详解](/zh/claude-code/web-and-desktop/)[Claude Code 使用哪个模型，以及如何更改](/zh/claude-code/models/)[Claude Code 错误及修复方法](/zh/claude-code/errors/)[Claude Code 开源吗？](/zh/claude-code/open-source/)[Claude Code 教程：您的首次实际会话](/claude-code/zh/tutorial/)[学生使用 Claude：Claude Code、API，以及教育优惠实际提供什么](/zh/claude-code/for-students/)[如何使用 Claude Code 实现 QA 自动化](/zh/claude-code/qa-automation/)[Claude Code 与 Cursor 对比：如何选择、何时使用，以及如何同时使用两者](/zh/claude-code/vs-cursor/)[Claude Code、Codex 与 OpenCode：终端智能体对比](/zh/claude-code/vs-codex/)[Claude Code 子智能体：工作原理、定义方法与智能体团队](/zh/claude-code/subagents/)[Claude Code 钩子：以确定性方式控制智能体的行为](/zh/claude-code/hooks/)[Claude Code MCP：连接服务器、作用域、远程 MCP 与实际示例](/zh/claude-code/mcp/)[Claude Code 生态系统：路由器、框架、插件及收录它们的清单](/zh/claude-code/ecosystem/)[如何在 Claude Code 中使用 OpenRouter（以及何时不宜使用）](/zh/claude-code/openrouter/)[Claude 速率限制错误：“API error: rate limit reached”的含义与解决方法](/zh/claude-code/rate-limits/)[Claude Code 怎么用：从安装到日常使用](/claude-code/zh/)