适用环境
操作系统:macOS
平台:VS Code + Kilo Code 扩展
功能:集成 Google Gemini CLI
问题背景
在 macOS 上,Gemini CLI 命令行可正常用,但在 Kilo Code (VSCode 插件) 环境下报 403 权限错误。主要是环境变量和 Google Cloud API 权限导致。
常见报错及成因
1. Permission denied on resource project default
原因:
Kilo Code 读取不到正确的 GOOGLE_CLOUD_PROJECT 环境变量,导致默认项目为“default”。
Mac 专属操作指引
1.
打开终端终端 (Terminal),进入配置目录:
Bash
cd ~/.gemini2.
新建或编辑
.env 文件,用文本编辑器写入:Bash
export GOOGLE_CLOUD_PROJECT="你的Google Cloud 项目ID"推荐命令:
Bash
touch ~/.gemini/.env
open -e ~/.gemini/.env # 打开文本编辑器3.
保存并关闭。
4.
重启 VS Code,重启后 Kilo Code 才会加载
.env。2. Gemini for Google Cloud API has not been used...
原因
你的 Google Cloud 项目尚未启用 Gemini for Google Cloud API (cloudaicompanion.googleapis.com)。
Mac 下启用方法
推荐在 Mac 上用浏览器直接点此链接,手动启用:
Plain Text
<https://console.developers.google.com/apis/api/cloudaicompanion.googleapis.com/overview?project=你的项目ID>命令行也可(macOS 默认内置 gcloud 工具时):
Bash
gcloud services enable cloudaicompanion.googleapis.com --project=你的项目ID等三五分钟,云端权限变更才会在本机生效!
认证方式说明 (适用 macOS)
OAuth 认证(通常 Mac 用户都选择,需有订阅/官方邀请):
需生成
~/.gemini/oauth_creds.json要配置
~/.gemini/.env 文件必须启用
cloudaicompanion.googleapis.com否则会频繁
403API Key 认证(需要自助申请 API Key):
从 AI Studio 获取 API Key
设置后走
generativelanguage.googleapis.com 不必配置 Cloud 项目配置检查清单(Mac 专属)
~/.gemini/oauth_creds.json 已生成(OAuth认证)~/.gemini/.env 文件已设置、内容为正确的项目IDGemini API 在 Google Cloud 控制台内已启用
常见问题与建议
终端(Terminal)可用但 Kilo Code 报错?一定要显式写
.env,Mac 的 VS Code APP 不会自动承接 shell 环境变量!如果你 OAuth 凭证路径自定义,
.env 也要放进 ~/.gemini/未订阅 Gemini Code Assist 时,API 用量可能单独计费
验证流程
在 Mac 终端输入
gemini,看 CLI 工作是否正常VS Code 中重启 Kilo Code,测试一个基本指令
gemini auth status 检查认证总结
在 macOS 下配置 VS Code 插件 Kilo Code 搭配 Gemini CLI 时,只要
正确配置
~/.gemini/.env 指定 Cloud 项目ID云端启用 Gemini for Google Cloud API
即可让 CLI 与插件都无缝可用。如果还是报错,建议逐步核查账号类型、Google Cloud 权限与本地文件路径设置。
