在 VS Code 中使用 Claude Code:安装扩展、配置 IDE 并切换到 Novita AI

在 VS Code 中使用 Claude Code:安装扩展、配置 IDE 并切换到 Novita AI

Claude Code 作为原生 VS Code 扩展直接安装在市场中——无需浏览器标签页,也无需在窗口间复制粘贴。该扩展内置了与 CLI 相同的 Claude Code 引擎,因此从斜杠命令到文件编辑再到 MCP 工具调用,所有功能都以相同的方式运行,就在编辑器侧边栏内。PyCharm 和其他 JetBrains 系列产品通过专用的 JetBrains 插件获得相同的体验。由于两者都从环境变量读取 ANTHROPIC_BASE_URL,因此只需更改一个环境变量,即可将 LLM 后端切换到 Novita AI 的 API 及其更广泛的模型选择。

VS Code 扩展的实际功能

Claude Code VS Code 扩展并非一个附加到编辑器上的聊天标签页。它在侧边栏面板中呈现完整的 Claude Code 代理:相同的 REPL 风格界面、相同的工具集、相同的会话连续性。当你要求它重构一个函数或为你打开的文件编写测试时,它会直接在工作区中读取和编辑这些文件——无需使用剪贴板。

该扩展处理的具体事项:

  • 带内联差异的多文件编辑。 Claude Code 提出更改并显示差异,你可以在不离开编辑器的情况下接受或拒绝。
  • 斜杠命令。 /compact/init/memory/clear 等命令与 CLI 中的行为完全相同。
  • 上下文固定。 使用 # 前缀可以将特定文件、文件夹或符号作为上下文附加到请求中。
  • CLAUDE.md 感知。 你在 CLAUDE.md 中编写的项目说明和编码标准会在会话启动时自动加载。
  • MCP 工具调用。 在 Claude Code 配置中注册的任何 MCP 服务器都可以在扩展中使用。

它的作用不包括:在编辑器缓冲区中添加 AI 自动补全。对于这一点,Copilot 或 Cline 等工具扮演着不同的角色。VS Code 中的 Claude Code 是一个代理——你给它一个任务,它执行多个步骤,而不是单次内联补全。

在 VS Code 中安装 Claude Code

打开 VS Code 的扩展面板(Windows/Linux 上按 Ctrl+Shift+X,macOS 上按 Cmd+Shift+X)。搜索 Claude Code 并查找由 Anthropic 发布的扩展。点击 ** 安装**。

或者,在终端中运行以下命令:

code --install-extension Anthropic.claude-code

安装后,Claude 图标会出现在左侧的 VS Code 活动栏中。点击它打开 Claude Code 面板。

首次启动认证。 扩展程序会提示你登录。你有两种方式:

  • Anthropic 账户(订阅或控制台计费): 点击浏览器 OAuth 流程。
  • API 密钥路由到 Novita AI: 跳过 Anthropic 认证。在启动 VS Code 之前,在环境中设置 ANTHROPIC_BASE_URLANTHROPIC_AUTH_TOKEN,扩展程序将使用这些值。完整说明见下一节。

自动更新。 VS Code 会在你重新启动编辑器时在后台更新扩展。你无需手动管理版本。

在 VS Code 中日常使用 Claude Code

打开面板后,工作流程很简单。输入一个请求,Claude Code 读取你的工作区并回复提议的操作。在编辑文件之前,它会默认显示差异并等待你批准。

一些提高日常使用效率的模式:

引用你正在查看的文件。 输入 # 后跟文件名,将其显式附加为上下文。对于已在活动编辑器中打开的文件,Claude Code 通常会自动获取,但在多文件任务中,当你想要固定某个特定文件时,# 就很有用了。

在新项目中运行一次 /init 这会在仓库根目录创建一个 CLAUDE.md,你可以在其中存储项目特定的说明——首选库、架构说明、测试约定。Claude Code 会在每次会话启动时读取它,因此你无需重复说明。

当会话变长时使用 /compact 与 CLI 类似,扩展程序会按需压缩对话历史记录,以释放当前任务的上下文空间。

查看正在运行的工具列表。 在面板底部,VS Code 会显示 Claude Code 当前正在调用的工具(文件读取、bash 命令、网络搜索)。这对于了解较长的自动化任务中正在发生的事情非常有用。

撤销是你的朋友。 所有文件编辑都会经过标准的 VS Code 文件系统,因此 Ctrl+Z 可以像撤销任何手动编辑一样撤销它们。Claude Code 的更改没有单独的撤销堆栈。

将扩展路由到 Novita AI

VS Code 扩展在启动时从环境变量读取 ANTHROPIC_BASE_URL——与 CLI 使用的变量相同。将其设置为 Novita AI 的 Anthropic 兼容端点,可以将每个 API 调用从 Anthropic 的服务器重定向出去。你将获得 Novita AI 基础设施上的 DeepSeek、Kimi K2、Qwen、GLM 等模型,并通过你的 Novita AI 账户以 Novita 的 token 费率进行计费。

获取 Novita AI API 密钥

注册 Novita AI 账户 以获取免费试用积分。前往 密钥管理,创建一个新密钥并复制它。在通过 Novita 路由时,此密钥将取代你的 Anthropic API 密钥。

在启动 VS Code 之前设置环境变量

macOS 和 Linux — 将这些添加到你的 shell 配置文件(.zshrc.bashrc 或等效文件)中,然后重新加载:

export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<Your Novita API Key>"
export ANTHROPIC_MODEL="deepseek/deepseek-v4-flash"
export ANTHROPIC_SMALL_FAST_MODEL="deepseek/deepseek-v4-flash"
source ~/.zshrc   # 或 ~/.bashrc

Windows(持久化——重启后仍有效) — 使用 PowerShell 设置用户级环境变量:

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://api.novita.ai/anthropic","User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN","<Your Novita API Key>","User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL","deepseek/deepseek-v4-flash","User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_SMALL_FAST_MODEL","deepseek/deepseek-v4-flash","User")

设置这些变量后,重新启动 VS Code,以便扩展读取更新后的环境。

Windows(仅当前会话)

set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<Your Novita API Key>
set ANTHROPIC_MODEL=deepseek/deepseek-v4-flash
set ANTHROPIC_SMALL_FAST_MODEL=deepseek/deepseek-v4-flash

设置这些变量后,从同一个 shell 启动 VS Code。扩展在启动时读取这些变量。你无需登录 Anthropic——Novita 通过 API 密钥处理认证。

选择模型

ANTHROPIC_MODEL 告诉 Claude Code 用于主要任务的模型;ANTHROPIC_SMALL_FAST_MODEL 控制后台操作,如文件摘要。任何在 Novita AI 的 LLM API 上可用的模型都可以在此设置。在 Novita 上经常与 Claude Code 一起使用的模型包括 DeepSeek V4 Flash、Kimi K2 和 GLM-4.6——每种模型都有不同的上下文窗口大小、定价和性能特征,具体取决于你的工作负载。

要恢复为默认的 Anthropic 路由,请取消设置环境变量:

unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_MODEL ANTHROPIC_SMALL_FAST_MODEL

或者从从未设置过这些变量的 shell 中打开 VS Code。

PyCharm 和 JetBrains 集成

Claude Code 为 JetBrains 平台提供了官方插件,该平台涵盖 PyCharm、IntelliJ IDEA、WebStorm、GoLand、Rider 以及 JetBrains 系列的其他产品。

安装插件

在 JetBrains IDE 中打开 **设置 → 插件 ,切换到 Marketplace 标签页,搜索 Claude Code。点击 ** 安装,然后在提示时重新启动 IDE。

或者,从 JetBrains Marketplace 网站下载插件文件,然后通过 设置 → 插件 → 从磁盘安装插件 进行安装。

首次运行

安装后,Claude Code 面板会出现在 IDE 侧边栏或工具窗口区域(取决于你的布局)。首次启动会提示进行身份验证,与 VS Code 相同。

将 PyCharm 路由到 Novita AI

JetBrains 插件读取与 VS Code 扩展和 CLI 相同的环境变量。在启动 IDE 之前,在 shell 配置文件中设置 ANTHROPIC_BASE_URLANTHROPIC_AUTH_TOKENANTHROPIC_MODELANTHROPIC_SMALL_FAST_MODEL,插件将通过 Novita 进行路由。

如果你从桌面启动器(在 macOS 和 Linux 上很常见)而不是终端启动 PyCharm,IDE 可能不会继承你的 shell 环境。可靠的解决方法是使用项目级 .env 文件,或者在系统级环境中设置变量,而不是在 shell 配置文件中。在 macOS 上,通过 launchctl setenv 设置的变量对 GUI 应用程序可见。

IDE 扩展与 CLI:何时使用哪种

扩展和 CLI 共享相同的引擎。实际区别在于上下文和集成。

VS Code / JetBrains 扩展 CLI
文件导航 点击打开,# 引用 从 CWD 读取;显式指定路径
差异审查 编辑器中内联 终端输出
多个项目 每个窗口一个面板 每个目录单独的会话
CI/CD 和自动化 不适用 -p 标志用于非交互式批量运行
管道和脚本 不支持 完整的 Unix 管道支持
Novita AI 路由 ANTHROPIC_BASE_URL 环境变量 相同

当你的主要工作流程是交互式编辑代码时,扩展是更好的选择。当你自动化任务、在脚本中运行 Claude Code、与 CI 集成或在 Claude Code SDK 基础上构建时,CLI 是更合适的选择。

Novita AI 的 Agent Sandbox

如果你从交互式开发转向自动化流水线——无头运行 Claude Code 代理、针对不同仓库启动多个代理或构建评估工具——Novita AI 的 Agent Sandbox 提供了隔离的执行环境,用于以编程方式运行代理。每个沙箱都是一个 firecracker 支持的虚拟机,因此代理在隔离环境中运行,不会影响你的开发机器。

常见问题

我需要付费的 Anthropic 订阅才能使用 VS Code 扩展吗?

不需要——如果你通过 ANTHROPIC_BASE_URL 将扩展路由到 Novita AI,所有计费都将通过你的 Novita AI 账户进行。不需要 Anthropic 账户,也不会被计费。

如何安装 Claude Code 的 VS Code 扩展?

打开 VS Code 的扩展面板(Ctrl+Shift+X),搜索 Claude Code(发布者:Anthropic),然后点击安装。或者从终端运行 code --install-extension Anthropic.claude-code

Claude Code 扩展在 Cursor 中工作吗?

Cursor 是 VS Code 的一个分支,支持大多数 VS Code 扩展。Claude Code 扩展可能可以安装,但 Cursor 已经内置了自己的 Claude 集成。同时运行两者可能会产生重复的提示和竞争的认证流程。大多数开发者只使用其中之一,而不是两者都用。

有 Claude 浏览器扩展吗?

Anthropic 没有官方的 Claude 浏览器扩展。Claude Code 作为 VS Code 扩展、JetBrains 插件、CLI、桌面应用程序以及通过 claude.ai/code 的 Web 界面运行——但不是作为连接到任意网页的浏览器扩展。

如何在不重启 VS Code 的情况下切换模型?

更改 shell 配置文件中的 ANTHROPIC_MODEL,然后从新的终端会话重新打开 VS Code。在正在运行的 VS Code 会话中,没有面板内的模型切换器——环境变量在启动时读取。

我可以在不同的项目中使用不同的模型吗?

可以。在项目级 .env 文件或 CLAUDE.md 指令中设置 ANTHROPIC_MODEL,或者使用 direnv 将环境变量限定到特定目录。Claude Code 在会话级别尊重环境变量值,因此使用标准的 dotfile 工具可以实现按项目路由。

将 Claude 与 VS Code 集成与使用 Cline 有何不同?

Cline 是一个扩展,使用任何兼容 OpenAI 的后端将 VS Code 转变为代理式编码环境。Claude Code 是 Anthropic 自己的代理,作为 VS Code 扩展提供,拥有自己的工具集和推理循环。主要的实际区别是:Cline 让你可以更好地控制由哪个提供商和模型运行循环,而 Claude Code 默认与 Claude 模型系列紧密集成——尽管 ANTHROPIC_BASE_URL 确实允许你将其重定向到 Novita AI 的兼容端点。

推荐阅读