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-codefree-claude-codeFCC是一个本地代理工具能让 Claude Code、Codex、OpenCode 等 9 款编程智能体免费接入 50 多家模型服务商每月 1.3B 免费 tokens。其中Google Vertex AI是比较特殊的接入方式它不需要 API Key而是通过ADCApplication Default Credentials应用默认凭证完成认证。本文用最短的篇幅讲清 Vertex AI 的两个核心设置——ADC 认证与项目 IDVERTEX_PROJECT_ID帮新手一次配通。为什么 Free Claude Code 值得接入 Vertex AIFCC 的设计思路是本地起一个代理服务把各大服务商的模型统一成一个目录所有客户端终端、IDE、桌面端、甚至 Discord/Telegram共用一份配置。Vertex AI 接入 FCC 后的优势无需申请 API KeyGoogle 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.pyglobal→ 使用 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整个过程无需改任何代码启动 FCCmacOS/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_CREDENTIALS401 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_IDVERTEX_LOCATION留默认本机跑一次gcloud auth application-default loginAdmin 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），仅供参考 Free Claude Code Vertex AI配置详解：ADC认证与项目ID设置
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-codefree-claude-codeFCC是一个本地代理工具能让 Claude Code、Codex、OpenCode 等 9 款编程智能体免费接入 50 多家模型服务商每月 1.3B 免费 tokens。其中Google Vertex AI是比较特殊的接入方式它不需要 API Key而是通过ADCApplication Default Credentials应用默认凭证完成认证。本文用最短的篇幅讲清 Vertex AI 的两个核心设置——ADC 认证与项目 IDVERTEX_PROJECT_ID帮新手一次配通。为什么 Free Claude Code 值得接入 Vertex AIFCC 的设计思路是本地起一个代理服务把各大服务商的模型统一成一个目录所有客户端终端、IDE、桌面端、甚至 Discord/Telegram共用一份配置。Vertex AI 接入 FCC 后的优势无需申请 API KeyGoogle 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.pyglobal→ 使用 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整个过程无需改任何代码启动 FCCmacOS/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_CREDENTIALS401 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_IDVERTEX_LOCATION留默认本机跑一次gcloud auth application-default loginAdmin 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），仅供参考