首页 › Claude Code › VS Code
概览安装CLI 参考文档定价与限制Agent SDK技能与插件GitHub网页、桌面与 IDE模型错误是否开源?教程学生指南QA 自动化与 Cursor 对比与 Codex 和 OpenCode 对比子智能体钩子MCP生态系统VS CodeOpenRouter速率限制中文指南
最后更新: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

所有不限量套餐 →

先免费试用

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

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

使用优惠码 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 密钥 查看不限量方案

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

更多 Claude Code 指南

Claude Code:完整指南如何安装 Claude CodeClaude Code CLI 文档:命令与参数Claude Code 定价与限制详解Claude Code SDK,现已更名为 Claude Agent SDKClaude Code 技能与插件在 GitHub 中使用 Claude Code:App、Action 和 @claudeClaude Code 有网页界面吗?网页、桌面与 IDE 版本详解Claude Code 使用哪个模型,以及如何更改Claude Code 错误及修复方法Claude Code 开源吗?Claude Code 教程:您的首次实际会话学生使用 Claude:Claude Code、API,以及教育优惠实际提供什么如何使用 Claude Code 实现 QA 自动化Claude Code 与 Cursor 对比:如何选择、何时使用,以及如何同时使用两者Claude Code、Codex 与 OpenCode:终端智能体对比Claude Code 子智能体:工作原理、定义方法与智能体团队Claude Code 钩子:以确定性方式控制智能体的行为Claude Code MCP:连接服务器、作用域、远程 MCP 与实际示例Claude Code 生态系统:路由器、框架、插件及收录它们的清单如何在 Claude Code 中使用 OpenRouter(以及何时不宜使用)Claude 速率限制错误:“API error: rate limit reached”的含义与解决方法Claude Code 怎么用:从安装到日常使用