通过修改 VS Code 的 settings.json 或 JetBrains 的 installed.json 文件，添加 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 这两个环境变量，即可将 Free Claude Code 代理接入对应 IDE。本文将提供具体的配置片段、claude-pick 工具用法及 Shell alias 示例，助你快速在 IDE 中免费使用 Claude Code。

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

Free Claude Code 的核心是将对 Anthropic 官方 API 的请求，重定向到你部署的本地或远程代理服务。连接 IDE 的关键，在于正确设置两个环境变量。本文将分别说明如何在 VS Code 和 JetBrains 中完成配置。如果你还未部署代理，可参考安装部署教程。

VS Code 扩展配置

VS Code 的 Claude Code 扩展支持通过 settings.json 直接注入环境变量，无需修改系统全局配置。

配置步骤：

打开 VS Code 设置界面（快捷键 Ctrl+, 或 Cmd+,）。
在搜索框中输入 claude-code.environmentVariables。
点击该设置项旁边的 在 settings.json 中编辑 图标。
在打开的 settings.json 文件中，添加以下 JSON 配置：
```
{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "http://localhost:8082" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "freecc" }
  ]
}
```
配置说明：
- ANTHROPIC_BASE_URL：你的 Free Claude Code 代理服务地址。示例中为本地默认地址。
- ANTHROPIC_AUTH_TOKEN：代理服务的认证令牌。使用 Free Claude Code 默认值 freecc 即可。
保存 settings.json 文件，并重新加载 VS Code 窗口（Ctrl+Shift+P 执行 Developer: Reload Window）。

验证与注意事项：

重启后，首次使用 Claude Code 扩展时，它可能会短暂显示一个登录页面。此时选择 Sign in with Anthropic Console 路径，让流程走一次即可。后续请求将自动通过你配置的代理。
此方法的优势在于配置作用域限于 VS Code，不影响系统环境。

JetBrains ACP 配置

JetBrains 系列 IDE（如 IntelliJ IDEA, PyCharm）通过其 Agent Coding Platform (ACP) 管理 Claude Code 的 Agent。配置需要直接编辑一个 JSON 文件。

定位配置文件：

根据你的操作系统，找到 installed.json 文件：

系统	文件路径
Windows	`C:\Users\%USERNAME%\AppData\Roaming\JetBrains\acp-agents\installed.json`
macOS / Linux	`~/.jetbrains/acp.json`

配置步骤：

使用文本编辑器打开上述路径的 installed.json 文件。
在 JSON 结构中，找到标识为 acp.registry.claude-acp 的配置对象。
在该对象内，添加 env 字段及其值：
```
{
  // ... 其他字段 ...
  "env": {
    "ANTHROPIC_BASE_URL": "http://localhost:8082",
    "ANTHROPIC_AUTH_TOKEN": "freecc"
  }
}
```
关键提示： 如果该对象内已存在 env 字段，请将 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 合并进去，不要覆盖整个 env 字段以免丢失其他配置。
保存文件，并 完全重启 你的 JetBrains IDE（仅关闭项目窗口无效，需退出整个应用程序）。

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

claude-pick 是项目提供的一个 Shell 脚本，它结合了 fzf 工具，让你在命令行启动 Claude Code 前，可以交互式地从配置的多个模型中选择一个。

第一步：安装 fzf

你需要先安装 fzf 这个模糊查找器。

# macOS (使用 Homebrew)
brew install fzf

# Ubuntu/Debian Linux
sudo apt install fzf

# Windows (使用 Scoop 包管理器)
scoop install fzf

第二步：配置 claude-pick 别名

在你的 Shell 配置文件（如 ~/.bashrc 或 ~/.zshrc）中，为 claude-pick 脚本创建一个别名，并指向其绝对路径。

# 请将 /path/to 替换为你的 free-claude-code 仓库的实际克隆路径
alias claude-pick="/path/to/free-claude-code/claude-pick"

保存后，运行 source ~/.bashrc 或 source ~/.zshrc 使别名生效。

第三步：使用 claude-pick

在终端中直接运行：

claude-pick

脚本会读取你项目 .env 文件中配置的所有模型列表，通过 fzf 展示一个交互式选择界面。使用方向键选择模型后回车，它将以所选模型自动启动 Claude Code CLI。

快速启动别名

如果你经常在命令行使用 Claude Code，创建几个 Shell 别名可以省去每次手动设置环境变量的麻烦。

在你的 .bashrc 或 .zshrc 中添加：

# 使用代理默认模型启动
alias claude-free='ANTHROPIC_BASE_URL="http://localhost:8082" ANTHROPIC_AUTH_TOKEN="freecc" claude'

# 指定使用 NVIDIA NIM 上的 Kimi 模型
# ANTHROPIC_AUTH_TOKEN 的格式为 "freecc:<provider>/<model>"
alias claude-kimi='ANTHROPIC_BASE_URL="http://localhost:8082" ANTHROPIC_AUTH_TOKEN="freecc:nvidia_nim/moonshotai/kimi-k2.5" claude'

# 指定使用 DeepSeek 模型
alias claude-deepseek='ANTHROPIC_BASE_URL="http://localhost:8082" ANTHROPIC_AUTH_TOKEN="freecc:deepseek/deepseek-chat" claude'

这些别名的工作原理是：ANTHROPIC_AUTH_TOKEN 中冒号 (:) 后面的部分会被代理解析为模型路由，从而覆盖默认的模型选择。这让你能快速切换不同的后端模型。

FAQ

Q: VS Code 中设置了环境变量，但扩展仍连接官方 API？ A: 请确认 settings.json 中的键名是 claudeCode.environmentVariables（注意 camelCase 拼写）。修改后，必须通过命令面板（Ctrl+Shift+P）执行 Developer: Reload Window 重新加载窗口才能生效。

Q: JetBrains 修改 installed.json 后配置不生效？ A: JetBrains IDE 需要完全退出并重启（而不仅仅是关闭当前项目窗口）才能重新加载 installed.json 配置。请确保保存文件后彻底重启 IDE。

Q: claude-pick 命令报错提示找不到 fzf？ A: 首先确认 fzf 已成功安装（终端执行 fzf --version 测试）。如果已安装但仍报错，请检查 fzf 所在路径是否已添加到系统的 PATH 环境变量中。Windows 用户在 Git Bash 中使用 fzf 通常可行，在 PowerShell 中推荐通过 scoop install fzf 安装。

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

VS Code 扩展配置 #

JetBrains ACP 配置 #

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

快速启动别名 #

FAQ #

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

VS Code 扩展配置

JetBrains ACP 配置

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

快速启动别名

FAQ