Free Claude Code Vertex AI配置详解：ADC认证与项目ID设置
【免费下载链接】free-claude-codeUse Claude Code, Codex, Pi, and OpenCode and more for free (1.3B+ free tokens) from your terminal, app, IDE, or phone like OpenClaw (voice supported + ToS friendly)项目地址: https://gitcode.com/GitHub_Trending/fr/free-claude-code
free-claude-code（FCC）是一个本地代理工具，能让 Claude Code、Codex、OpenCode 等 9 款编程智能体免费接入 50 多家模型服务商（每月 1.3B+ 免费 tokens）。其中Google Vertex AI是比较特殊的接入方式：它不需要 API Key，而是通过ADC（Application Default Credentials，应用默认凭证）完成认证。本文用最短的篇幅讲清 Vertex AI 的两个核心设置——ADC 认证与项目 ID（VERTEX_PROJECT_ID），帮新手一次配通。
为什么 Free Claude Code 值得接入 Vertex AI
FCC 的设计思路是：本地起一个代理服务，把各大服务商的模型统一成一个目录，所有客户端（终端、IDE、桌面端、甚至 Discord/Telegram）共用一份配置。Vertex AI 接入 FCC 后的优势：
- 无需申请 API Key，Google Cloud 账号 + ADC 即可，配置门槛更低
- 免费额度友好：Gemini 系列模型在 Vertex AI 上提供每月免费调用额度
- 原生模型发现：FCC 会自动拉取 Vertex 的模型列表，模型下拉框直接可搜
- 自动故障切换：配了 Fallback 模型后，Vertex 挂掉会自动切到下一家，无需重启会话
两大核心设置：项目 ID 与地域
Vertex AI 的接入只需要两个变量（在 FCC 的设置中定义为 settings.py 里的vertex_project_id与vertex_location字段）：
| 设置项 | 必填 | 默认值 | 说明 |
|---|---|---|---|
VERTEX_PROJECT_ID | ✅ | 无 | 你的 Google Cloud 项目 ID，用于请求计费与权限隔离 |
VERTEX_LOCATION | ❌ | global | 服务地域，global或us-central1之类的区域名（必须小写） |
这两个值会被拼成 Vertex 的 OpenAI 兼容端点，逻辑见 endpoint.py：
global→ 使用 Google 的全球端点- 具体区域（如
us-central1）→ 使用对应的区域性端点
💡 新手建议：保持
VERTEX_LOCATION为默认的global即可，无需修改。
ADC 认证：三种方式任选其一
与大多数服务商不同，Vertex AI 走的是 Google 的ADC 认证体系（实现位于 auth.py）。FCC 内部会自动处理访问令牌的获取与无感刷新，你只需把凭证准备好。三种方式按推荐顺序排列：
方式一：本地 gcloud 登录（新手首选）
gcloud auth application-default login运行一次后会打开浏览器授权，之后本机所有 ADC 请求都可用，适合个人开发机。
方式二：服务账号密钥文件
如果你已有服务账号 JSON 密钥文件，设置环境变量指向它即可：
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json方式三：附加的服务账号
在 GCE、Cloud Run 等 Google 云环境中，实例附加的服务账号会被 ADC 自动识别，无需任何额外操作。
⚠️ 权限提示：ADC 需要
https://www.googleapis.com/auth/cloud-platform范围（FCC 加载凭证时会显式申请），服务账号至少要有 Vertex AI User 角色。
Admin UI 四步完成配置
FCC 启动后会自动打开管理界面（Admin UI），整个过程无需改任何代码：
- 启动 FCC：macOS/Windows 直接打开Free Claude Code应用；Linux 运行
fcc-server - 在Providers面板找到Google Cloud Project ID输入框，填入项目 ID；如换地域再填Vertex AI Location
- 点击Validate验证凭证与项目连通性，通过后点Apply
- 在模型下拉框搜索
vertex/google/gemini-3.5-flash（或列表中任意 Vertex 模型）作为MODEL
配置完成后：在 Claude Code 里选择 Vertex 模型
运行fcc-claude启动 Claude Code，在会话里输入/model，即可在原生选择器中看到 FCC 网关推送的 Vertex 模型：
选中后所有请求都会经 FCC 代理转发到 Vertex AI 的 OpenAI 兼容接口，令牌由 ADC 自动维护，长期挂机也不用手动续期。
常见认证错误与排查
FCC 对 ADC 异常做了精细分类（见 test_vertex.py 的契约测试），对照错误信息快速定位：
| 现象 | 原因 | 解决 |
|---|---|---|
| 401 + "ADC were not found" | 本机没有任何 ADC 凭证 | 执行gcloud auth application-default login，或设置GOOGLE_APPLICATION_CREDENTIALS |
| 401 + "could not be refreshed" | 凭证过期且刷新失败 | 重新执行 gcloud 登录，或检查服务账号文件是否有效 |
| 503 + "temporarily unavailable" | 刷新令牌时网络抖动 | 可重试，FCC 会自动按可重试错误处理 |
| 启动报 "VERTEX_PROJECT_ID is not set" | 项目 ID 未填 | 回到 Admin UI → Providers 补填 |
| 启动报 "VERTEX_LOCATION must be..." | 地域写了大写或含非法字符 | 改为小写区域名，如us-central1 |
小结
Vertex AI 是 FCC 支持的 50 多家服务商里配置最"反直觉"的一家：没有 API Key，只有项目 ID + ADC。记住三点即可：
- 填好
VERTEX_PROJECT_ID，VERTEX_LOCATION留默认 - 本机跑一次
gcloud auth application-default login - Admin UI 里Validate → Apply，模型选
vertex/google/gemini-3.5-flash或列表中的任意 Gemini 模型
配通之后，Gemini 的免费额度就并入了你的 FCC 模型目录，配合 Fallback 机制可以和其他免费服务商无缝互补——这正是 free-claude-code "多服务商冗余、断供不断线" 的核心价值。
【免费下载链接】free-claude-codeUse Claude Code, Codex, Pi, and OpenCode and more for free (1.3B+ free tokens) from your terminal, app, IDE, or phone like OpenClaw (voice supported + ToS friendly)项目地址: https://gitcode.com/GitHub_Trending/fr/free-claude-code
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
