gemini cli,AI 编程工具
命令行交互的 AI 编程工具，和 claude code 一样。
全局安装
bash
pnpm i -g @google/gemini-cli申请 key
新建 Google 项目：
查看已经有的 Google 项目：
获取自己的 gemini API key：
在相关的文章中，都称呼为 gemini API key。特指在 aistudio.google.com/apikey 内申请的 key。
查看 key 的使用额度
如下图所示，在用量这里查看：
设置 key 环境变量
bash
# gemini-cli 的 api key
# https://github.com/google-gemini/gemini-cli#use-a-gemini-api-key
$env:GEMINI_API_KEY="***"相关的 vscode 插件
- https://marketplace.visualstudio.com/items?itemName=Google.geminicodeassist
- https://developers.google.com/gemini-code-assist/docs/overview?hl=zh-cn
设置 mcp
在全局的用户文件 C:\Users\pc\.gemini\settings.json 内设置即可。
整体体验
对于 gemini cli 免费提供的 gemini pro 2.5 模型，体验如下：
智障、傻逼、废物、八嘎。
- gemini cli 阅读文档不完全： 给他很多提示词，阅读起来缺斤少两，很多细节都有缺失。需要我反复提醒，反复拉扯，才能得到一个勉强的结果。
- 无法阅读 ide 提供的报错信息： 无法阅读 ide 提供的 typescript 类型报错信息，导致我无法使用 gemini cli 完成 typescript 类型报错的修复。相反，claude code 在配套的 vscode 插件的帮助下，能够阅读 ide 提供的报错信息，并针对性的修复故障。
想办法订阅谷歌的会员
参考资料：
套餐购买入口
谷歌套餐是包含一揽子工具链的：
获得 Gemini 3 Pro 的免费使用权限
因为添加自己在等待列表内，所以现在拥有了免费的使用权限。
手动设置 gemini 3 权限
在 gemini 内给账号授权
参考资料
github issue ： Permission 'cloudaicompanion.companions.generateChat' denied谷歌云文档 ： 在 Google Cloud 项目中授予 IAM 角色- https://console.cloud.google.com/iam-admin/iam
按照 issue 说明和文档教程，我进入到谷歌云的 iam 设置界面内，设置角色：
处理 403 错误
我遇到这样的错误：
log
[API Error: [{
"error": {
"code": 403,
"message": "Permission 'cloudaicompanion.companions.generateChat' denied on resource
'//cloudaicompanion.googleapis.com/projects/83565277083/locations/global' (or it may not
exist).",
"errors": [
{
"message": "Permission 'cloudaicompanion.companions.generateChat' denied on
resource '//cloudaicompanion.googleapis.com/projects/83565277083/locations/global' (or it
may not exist).",
"domain": "global",
"reason": "forbidden"
}
],
"status": "PERMISSION_DENIED",
"details": [
{
"@type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "IAM_PERMISSION_DENIED",
"domain": "cloudaicompanion.googleapis.com",
"metadata": {
"resource": "projects/83565277083/locations/global",
"permission": "cloudaicompanion.companions.generateChat"
}
}
]
}
}
]]注意到关键的项目 id 83565277083 。关闭掉我的全局 $env:GOOGLE_CLOUD_PROJECT 环境变量即可。
贡献者
ruan-cat