Skip to content

VS Code 与 JetBrains ​

这篇写 VS Code 扩展和 JetBrains 插件。桌面 App 见Claude Code 桌面 App。命令行见Claude Code CLI 接入。

这两处跑的是同一套 Claude Code,不是 claude.ai 网页里的普通聊天。

客户端是什么配置读哪里
VS Code 扩展编辑器里的 Claude Code 面板。扩展自己带一份命令行和命令行共用 ~/.claude/settings.json 的 env。登录检查还要在 VS Code 用户设置里再写一遍变量
JetBrains 插件IntelliJ、PyCharm、WebStorm 等里面的 Claude Code插件不带命令行。它在 IDE 终端里启动本机的 claude,所以直接读同一份 ~/.claude/settings.json

claude.ai 网页和手机 App 里的普通聊天不能填第三方 Key。 桌面 App 也不读下面这份文件,要在应用里单独配,见Claude Code 桌面 App。

配置文件在哪 ​

用户级配置文件:

  • Mac:~/.claude/settings.json
  • Windows:%USERPROFILE%\.claude\settings.json,也就是 C:\Users\<你的用户名>\.claude\settings.json

从 Dock、开始菜单或桌面图标打开的程序,读不到终端里 export 的变量。VS Code 和 JetBrains 都要把变量写进上面的文件。JetBrains 只读这份文件就够。VS Code 的登录检查还要再写一处,见下文。

安装 ​

地址核对自 Anthropic 官方页面(2026-11-02):VS Code、JetBrains。

VS Code 扩展 ​

  • 需要 VS Code 1.94.0 或更高。
  • 在 VS Code 里按 Cmd+Shift+X(Mac)或 Ctrl+Shift+X(Windows),搜索 Claude Code,点 Install。
  • 市场页:Visual Studio Marketplace:Claude Code。
  • 官方一键链接:vscode:extension/anthropic.claude-code。Cursor 对应 cursor:extension/anthropic.claude-code。
  • 装不了 Visual Studio Marketplace 的编辑器,用 Open VSX。官方写明扩展市场是第三方,Anthropic 不为其背书。

扩展自带一份命令行,聊天面板不用另外安装。若要在 VS Code 的集成终端里运行 claude 这条命令,还要按命令行接入指南再装一份独立 CLI。

JetBrains 插件 ​

插件不带命令行,两步都要做:

  1. 先按命令行接入指南装好 claude,并让 IDE 能在 PATH 里找到它。找不到时,插件提示 Cannot launch Claude Code。可在 Settings → Tools → Claude Code [Beta] 里把 Claude command 设成 claude 的完整路径。
  2. 从 JetBrains Marketplace 安装并完全重启 IDE。插件页:Claude Code。也可以在 IDE 里打开 Settings → Plugins,搜索 Claude Code 后安装。

官方列出可用的 IDE:IntelliJ IDEA、PyCharm、Android Studio、WebStorm、PhpStorm、GoLand。远程开发时,插件要装在远程主机上(Settings → Plugin (Host)),不是只装在你自己的电脑上。

写入 settings.json 的 env ​

打开 控制台 → API Keys,创建一个 mf- 开头的 Key。下面只填原始 Key,不要自己加 Bearer 。

Mac 编辑 ~/.claude/settings.json,Windows 编辑 %USERPROFILE%\.claude\settings.json。没有这个文件就新建。文件里已有别的设置时,只合并 env,不要把别的键删掉。

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://modelfold.ai/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的 mf- Key",
    "ANTHROPIC_MODEL": "claude-sonnet-5"
  }
}
  • ANTHROPIC_BASE_URL 只写到 /anthropic。客户端自己会接上 /v1/messages。写成 https://modelfold.ai/anthropic/v1/messages 会拼错地址。
  • ANTHROPIC_AUTH_TOKEN 放原始 Key。客户端把它放进 Authorization: Bearer。值里再写 Bearer 会变成 Bearer Bearer …,接口返回 401。
  • ANTHROPIC_MODEL 填下面列表里的 id。示例 claude-sonnet-5 是撰写本文时列表中的一个 id,列表变了就换。不要拿客户端自带的别名碰运气。
  • 不要把 Key 写进项目里的 .claude/settings.json,那个文件会进仓库。用用户目录这份,或项目下不提交的 .claude/settings.local.json。
  • 同一个变量如果终端里也 export 了,以 settings 文件为准。
  • 不要同时再设 ANTHROPIC_API_KEY。那个变量走的是 X-Api-Key,和 Bearer 混在一起时,官方会提示两套凭据冲突。

JetBrains 插件启动的就是本机 claude,读这份文件。在另一个终端窗口里 export,进不了 IDE。

官方的网关接入说明写明:~/.claude/settings.json 里的值能到达 VS Code 扩展拉起的进程,但到不了扩展自己的登录检查。只写这一份文件时,VS Code 面板仍会要求登录 Claude 账号。JetBrains 没有这一层,写完文件并完全重启 IDE 即可。

VS Code 还要写编辑器自己的设置 ​

从 Dock 打开的 VS Code 也继承不到终端里的 export。命令面板运行 Preferences: Open User Settings (JSON),合并进下面这段(不要整文件覆盖):

json
{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://modelfold.ai/anthropic" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "你的 mf- Key" },
    { "name": "ANTHROPIC_MODEL", "value": "claude-sonnet-5" }
  ]
}

改完执行 Developer: Reload Window。只关聊天面板不够。

若 Reload 之后仍然停在 Claude 登录页,再打开官方的 Disable Login Prompt(设置项 claudeCode.disableLoginPrompt)。官方把它标为第三方接入时用来跳过 Anthropic 登录提示。Key 只放用户设置,不要放进会提交的工作区 .vscode/settings.json。

可用模型 ​

下表来自 GET https://modelfold.ai/anthropic/v1/models。撰写本文时 has_more 为 false,共 13 个。列表会变,用下面的命令自己拉,不要沿用旧表。

bash
curl -s -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  https://modelfold.ai/anthropic/v1/models

PowerShell 用 curl.exe,Key 用 $env:MODELFOLD_API_KEY。请求头必须是 Authorization: Bearer。名字就叫 apikey 的头会被 401 拒掉。这个接口只列模型,不产生生成费用。

id(填进 ANTHROPIC_MODEL)显示名最大输入最大输出
claude-fable-5Claude Fable 51000000128000
claude-opus-5-5Claude Opus 5.51000000128000
claude-opus-5Claude Opus 51000000128000
claude-sonnet-5-5Claude Sonnet 5.51000000128000
claude-haiku-5-5Claude Haiku 5.51000000128000
claude-sonnet-5Claude Sonnet 51000000128000
claude-opus-4-8Claude Opus 4.81000000128000
claude-opus-4-7Claude Opus 4.71000000128000
claude-opus-4-6Claude Opus 4.61000000128000
claude-sonnet-4-6Claude Sonnet 4.61000000128000
claude-opus-4-5Claude Opus 4.5接口未返回接口未返回
claude-sonnet-4-5Claude Sonnet 4.5接口未返回接口未返回
claude-haiku-4-5Claude Haiku 4.520000064000

怎么确认生效 ​

列模型返回 200,只说明 Key 和地址能用,不代表生成已经走通。再发一条真实消息才会走生成,并消耗 ModelFold 积分。

改完文件或编辑器设置之后,要完全重启。VS Code 用 Reload Window 或整个退出。JetBrains 完全重启 IDE。只新开一个聊天不够。

  • JetBrains 集成终端里的 claude:运行 /status。Status 里应出现 Anthropic base URL https://modelfold.ai/anthropic,以及点名 ANTHROPIC_AUTH_TOKEN 的鉴权行。然后发一句短消息。
  • VS Code:Reload Window 之后打开 Claude Code 面板,发一句短消息。若仍弹出 Claude 登录,说明 claudeCode.environmentVariables 没被读到。
  • 到 控制台的调用记录 看这笔请求是否记在你的 Key 上。

常见问题 ​

现象原因
401,或请求头里出现 Bearer BearerKey 写错、已作废,或在 ANTHROPIC_AUTH_TOKEN 里多写了 Bearer 。只填原始 mf- Key。名字叫 apikey 的请求头也会 401。
404,或地址变成 /v1/v1/messagesANTHROPIC_BASE_URL 写成了带 /v1 或 /v1/messages 的完整地址。只写 https://modelfold.ai/anthropic。
VS Code 仍要求登录 Claude 账号只写了 settings.json,登录检查读不到。还要写用户设置里的 claudeCode.environmentVariables,然后 Reload Window。仍停在登录页时打开 Disable Login Prompt。从 Dock 打开的 VS Code 读不到终端里的 export。
JetBrains 提示 Cannot launch Claude CodeIDE 的 PATH 里没有 claude。先按命令行接入指南安装,或在 Settings → Tools → Claude Code [Beta] 里填完整路径,然后完全重启 IDE。
JetBrains 仍走 Claude 账号用户级 settings.json 没被读到,或只在另一个终端里 export 了。改文件后完全重启 IDE。
402,billing_error,提示积分不足ModelFold 账户积分不够(余额小于 1,或本次预扣超过余额)。到控制台充值。这不是 Key 格式错误。
提示模型不可用ANTHROPIC_MODEL 不在列模型接口的 id 里。重新拉列表再填。
网页或手机上的 claude.ai 聊天不能用这个 Key普通聊天界面不接受第三方 Key。用本页的扩展或插件,桌面 App,或命令行。

命令行的其他坑见 Claude Code CLI 接入。

ModelFold — 一个 API,接入所有主流 AI 模型。