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 插件
插件不带命令行,两步都要做:
- 先按命令行接入指南装好
claude,并让 IDE 能在 PATH 里找到它。找不到时,插件提示 Cannot launch Claude Code。可在 Settings → Tools → Claude Code [Beta] 里把 Claude command 设成claude的完整路径。 - 从 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,不要把别的键删掉。
{
"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),合并进下面这段(不要整文件覆盖):
{
"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 个。列表会变,用下面的命令自己拉,不要沿用旧表。
curl -s -H "Authorization: Bearer $MODELFOLD_API_KEY" \
https://modelfold.ai/anthropic/v1/modelsPowerShell 用 curl.exe,Key 用 $env:MODELFOLD_API_KEY。请求头必须是 Authorization: Bearer。名字就叫 apikey 的头会被 401 拒掉。这个接口只列模型,不产生生成费用。
| id(填进 ANTHROPIC_MODEL) | 显示名 | 最大输入 | 最大输出 |
|---|---|---|---|
claude-fable-5 | Claude Fable 5 | 1000000 | 128000 |
claude-opus-5-5 | Claude Opus 5.5 | 1000000 | 128000 |
claude-opus-5 | Claude Opus 5 | 1000000 | 128000 |
claude-sonnet-5-5 | Claude Sonnet 5.5 | 1000000 | 128000 |
claude-haiku-5-5 | Claude Haiku 5.5 | 1000000 | 128000 |
claude-sonnet-5 | Claude Sonnet 5 | 1000000 | 128000 |
claude-opus-4-8 | Claude Opus 4.8 | 1000000 | 128000 |
claude-opus-4-7 | Claude Opus 4.7 | 1000000 | 128000 |
claude-opus-4-6 | Claude Opus 4.6 | 1000000 | 128000 |
claude-sonnet-4-6 | Claude Sonnet 4.6 | 1000000 | 128000 |
claude-opus-4-5 | Claude Opus 4.5 | 接口未返回 | 接口未返回 |
claude-sonnet-4-5 | Claude Sonnet 4.5 | 接口未返回 | 接口未返回 |
claude-haiku-4-5 | Claude Haiku 4.5 | 200000 | 64000 |
怎么确认生效
列模型返回 200,只说明 Key 和地址能用,不代表生成已经走通。再发一条真实消息才会走生成,并消耗 ModelFold 积分。
改完文件或编辑器设置之后,要完全重启。VS Code 用 Reload Window 或整个退出。JetBrains 完全重启 IDE。只新开一个聊天不够。
- JetBrains 集成终端里的
claude:运行/status。Status 里应出现 Anthropic base URLhttps://modelfold.ai/anthropic,以及点名ANTHROPIC_AUTH_TOKEN的鉴权行。然后发一句短消息。 - VS Code:Reload Window 之后打开 Claude Code 面板,发一句短消息。若仍弹出 Claude 登录,说明
claudeCode.environmentVariables没被读到。 - 到 控制台的调用记录 看这笔请求是否记在你的 Key 上。
常见问题
| 现象 | 原因 |
|---|---|
401,或请求头里出现 Bearer Bearer | Key 写错、已作废,或在 ANTHROPIC_AUTH_TOKEN 里多写了 Bearer 。只填原始 mf- Key。名字叫 apikey 的请求头也会 401。 |
404,或地址变成 /v1/v1/messages | ANTHROPIC_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 Code | IDE 的 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 接入。
