Appearance
Free Claude Code 支持 VS Code 和 JetBrains 两种 IDE 接入,只需在对应配置文件中添加 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 两个环境变量。本文还介绍了 claude-pick 工具,让你在启动时交互式选择要使用的模型。
Free Claude Code 连接 IDE:VS Code 和 JetBrains 配置指南
VS Code 扩展配置
VS Code 的 Claude Code 扩展支持通过 settings.json 注入环境变量。
步骤:
- 打开 VS Code 设置(
Ctrl+,) - 搜索
claude-code.environmentVariables - 点击 Edit in settings.json
- 添加以下配置:
json
{
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "http://localhost:8082" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "freecc" }
]
}- 重新加载扩展或重启 VS Code
注意:首次加载时扩展可能仍会显示登录页面,选择 Anthropic Console 路径走一次即可。之后环境变量生效,所有模型流量都会通过本地代理。
如果你的代理跑在非 8082 端口或远程机器上,修改 value 为对应地址即可。
JetBrains ACP 配置
JetBrains 的 Claude ACP(Agent Coding Platform)通过 installed.json 配置文件管理 Agent 环境。
配置文件位置:
| 系统 | 路径 |
|---|---|
| Windows | C:\Users\%USERNAME%\AppData\Roaming\JetBrains\acp-agents\installed.json |
| macOS / Linux | ~/.jetbrains/acp.json |
步骤:
- 找到并打开
installed.json - 找到
acp.registry.claude-acp对应的配置块 - 在其中添加
env字段:
json
{
"env": {
"ANTHROPIC_BASE_URL": "http://localhost:8082",
"ANTHROPIC_AUTH_TOKEN": "freecc"
}
}- 重启 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+P → Developer: Reload Window)。
Q: JetBrains 配置修改后不生效? A: JetBrains 需要完全退出再重启(不是只关闭项目窗口),才能重新读取 installed.json。
Q: claude-pick 报错找不到 fzf? A: 确认 fzf 已安装且在 PATH 中。Windows 用户如果用 Git Bash 也能用 fzf,但 PowerShell 下建议用 scoop install fzf。