Skip to content

Free Claude Code 支持 VS Code 和 JetBrains 两种 IDE 接入,只需在对应配置文件中添加 ANTHROPIC_BASE_URLANTHROPIC_AUTH_TOKEN 两个环境变量。本文还介绍了 claude-pick 工具,让你在启动时交互式选择要使用的模型。

Free Claude Code 连接 IDE:VS Code 和 JetBrains 配置指南

VS Code 扩展配置

VS Code 的 Claude Code 扩展支持通过 settings.json 注入环境变量。

步骤:

  1. 打开 VS Code 设置(Ctrl+,
  2. 搜索 claude-code.environmentVariables
  3. 点击 Edit in settings.json
  4. 添加以下配置:
json
{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "http://localhost:8082" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "freecc" }
  ]
}
  1. 重新加载扩展或重启 VS Code

注意:首次加载时扩展可能仍会显示登录页面,选择 Anthropic Console 路径走一次即可。之后环境变量生效,所有模型流量都会通过本地代理。

如果你的代理跑在非 8082 端口或远程机器上,修改 value 为对应地址即可。

JetBrains ACP 配置

JetBrains 的 Claude ACP(Agent Coding Platform)通过 installed.json 配置文件管理 Agent 环境。

配置文件位置:

系统路径
WindowsC:\Users\%USERNAME%\AppData\Roaming\JetBrains\acp-agents\installed.json
macOS / Linux~/.jetbrains/acp.json

步骤:

  1. 找到并打开 installed.json
  2. 找到 acp.registry.claude-acp 对应的配置块
  3. 在其中添加 env 字段:
json
{
  "env": {
    "ANTHROPIC_BASE_URL": "http://localhost:8082",
    "ANTHROPIC_AUTH_TOKEN": "freecc"
  }
}
  1. 重启 IDE 让配置生效

注意:如果配置文件中已有 env 字段,合并即可,不要覆盖原有内容。

claude-pick:启动时交互式选模型

claude-pick 是项目自带的 Shell 脚本,配合 fzf 让你在启动 Claude Code 前交互式选择要使用的模型。

安装 fzf:

bash
# macOS
brew install fzf

# Linux(以 Ubuntu 为例)
sudo apt install fzf

# Windows(通过 Scoop)
scoop install fzf

配置 claude-pick:

bash
# 把路径改成你的实际路径
alias claude-pick="/absolute/path/to/free-claude-code/claude-pick"

把 alias 加到 .bashrc.zshrc 使其永久生效。

使用:

bash
claude-pick

它会列出你 .env 中配置的所有可用模型,用方向键选择后自动以对应模型启动 Claude Code。

快速启动别名

不想每次手动设环境变量?创建几个 Shell alias:

bash
# 默认模型
alias claude-free='ANTHROPIC_BASE_URL="http://localhost:8082" ANTHROPIC_AUTH_TOKEN="freecc" claude'

# 指定模型(通过 AUTH_TOKEN 传递模型名)
alias claude-kimi='ANTHROPIC_BASE_URL="http://localhost:8082" ANTHROPIC_AUTH_TOKEN="freecc:nvidia_nim/moonshotai/kimi-k2.5" claude'

alias claude-deepseek='ANTHROPIC_BASE_URL="http://localhost:8082" ANTHROPIC_AUTH_TOKEN="freecc:deepseek/deepseek-chat" claude'

ANTHROPIC_AUTH_TOKEN 中冒号后面的部分会作为模型覆盖,代理会解析成具体的 Provider/模型 路由。

FAQ

Q: VS Code 设置了环境变量但扩展还是连官方 API? A: 确认设置的是 claudeCode.environmentVariables(带 camelCase 的 Code),不是其他格式。保存后要 Reload Window(Ctrl+Shift+PDeveloper: Reload Window)。

Q: JetBrains 配置修改后不生效? A: JetBrains 需要完全退出再重启(不是只关闭项目窗口),才能重新读取 installed.json

Q: claude-pick 报错找不到 fzf? A: 确认 fzf 已安装且在 PATH 中。Windows 用户如果用 Git Bash 也能用 fzf,但 PowerShell 下建议用 scoop install fzf