优先推荐：日常稳定备用入口
SnakeGPT
适合国内用户把 GPT、DeepSeek、Gemini、Grok 放在同一个入口里，用于日常写作、学习、办公和模型切换。
- 支持 GPT-5.5 / DeepSeek-V3
- 支持 Gemini 3.1 Pro / Grok 4.3
- 国内邮箱可注册
- 已稳定运营 4 年，稳定性 4 星
Appearance
Gemini CLI 安装教程：Windows / Mac / VS Code、登录失败和 403 排查
如果你搜索 gemini cli、gemini cli安装、gemini cli教程、gemini cli登录失败、gemini code assist 登录失败、gemini code assist vscode 或 gemini cli 403，大概率已经在安装、登录或写代码时卡住了。本文按 官方入口、安装前检查、VS Code 使用、登录失败、403 排查、安全边界 的顺序整理。
先给官方入口：Gemini CLI 优先看 google-gemini/gemini-cli 官方 GitHub 和 Google Cloud Gemini CLI 文档；Gemini Code Assist 优先看 Google for Developers 概览 和官方 IDE 插件页面。不要从陌生网站复制“早期访问版安装命令”。
本站是独立中文教程，不提供 Gemini CLI 安装包，也不代替 Google 官方文档。终端命令、npm 包名、权限、配额和登录方式都应以官方 GitHub 与 Google 文档实时显示为准。
首推入口
写代码时也可以先用多模型入口做交叉验证
如果你只是解释代码、生成测试、比较实现思路，可以优先用 SnakeGPT 做日常模型切换；如果要同时测试 Gemini 3.1 Pro、Claude 4.8、GPT-5.5、Grok 4.3 和更多工作流，再看 GPTCat。不要上传私有密钥、客户数据或未公开项目资料。
完整多模型工作台
GPTCat
适合需要同时使用 GPT-5.5、Claude 4.8、Gemini 3.1 Pro、Grok 4.3、DeepSeek-V3 和 MJ 绘图的用户。
- 国内邮箱可注册
- 一比一还原官网体验
- 支持语音、视频和绘图工作流
- 稳定性 5 星
建议把这类平台作为多模型工作流和备用入口使用。不要输入账号密码、API Key、客户隐私、公司机密或未公开项目资料。
Gemini CLI 和 Gemini Code Assist 区别
| 工具 | 使用位置 | 适合任务 | 关键词意图 |
|---|---|---|---|
| Gemini CLI | 终端 | 阅读项目、修 bug、生成脚本、自动化任务 | 安装、GitHub、命令行、MCP |
| Gemini Code Assist | VS Code、JetBrains、Cloud Shell 等 | 代码补全、解释、重构、代码审查 | VS Code、登录失败、一直转圈 |
| Gemini API | 后端或脚本 | 自己接入模型能力 | API Key、调用、计费 |
| Gemini 网页版 | 浏览器 | 普通聊天、写作、分析 | 官网入口、国内怎么用 |
如果你只是写一段提示词，不一定要安装 CLI；如果你要让模型读取本地项目上下文，CLI 和 IDE 插件才更有价值。
Gemini CLI 安装前检查
- 是否打开官方 GitHub 或 Google Cloud 文档。
- 是否确认包名、仓库名和组织名来自 Google。
- 是否安装了合适的 Node.js 或文档要求的运行环境。
- 是否知道自己用 Google 登录还是 API Key。
- 是否准备在测试项目中先运行，而不是直接对生产仓库执行改动。
安全重点：不要运行来路不明的 PowerShell、curl、bash 管道命令。终端工具一旦被仿冒，风险比网页入口更高。
Gemini CLI 常见使用流程
| 阶段 | 操作 | 建议 |
|---|---|---|
| 安装 | 按官方 README 或文档执行 | 不从二手教程复制未知命令 |
| 登录 | 选择 Google 账号或 API Key 路径 | 账号权限以官方说明为准 |
| 进入项目 | 在测试仓库里启动 CLI | 先只读分析，后让它改文件 |
| 写提示词 | 明确目标、范围、文件路径和输出格式 | 避免“帮我优化整个项目” |
| 审核改动 | 人工看 diff、跑测试 | 不让 AI 自动提交敏感改动 |
适合第一条提示词：
text
请先只读分析这个项目，不要修改文件。
输出：
1. 项目结构概览
2. 主要入口文件
3. 可能的测试命令
4. 你还需要我提供哪些上下文Gemini Code Assist 在 VS Code 中怎么用
Gemini Code Assist 更适合 IDE 内的日常编程：解释当前文件、生成代码片段、补全函数、写测试、审查 PR。官方资料中也提到，它会根据代码和文档上下文给出回答。
建议用法：
- 先打开一个小文件，让它解释代码意图。
- 再让它写单元测试或边界条件。
- 大改之前要求它列计划，不要直接修改。
- 对生成代码跑测试和 lint。
- 对安全、鉴权、支付、数据删除等敏感逻辑必须人工复核。
登录失败、一直转圈、403 怎么排查
| 问题 | 可能原因 | 排查动作 |
|---|---|---|
| 登录失败 | 浏览器会话、账号权限、地区或组织策略 | 换浏览器、清缓存、确认账号可用 |
| 一直转圈 | 插件状态、网络、回调失败 | 重启 IDE、重新登录、查看扩展日志 |
| 403 | 权限不足、API/服务未启用、组织限制 | 查看官方文档、账号权限和项目设置 |
| 模型不可用 | 账号、地区、配额或模型状态 | 回到官方模型列表核查 |
| CLI 无响应 | 环境、代理、Node/npm、终端权限 | 用最小命令测试，检查版本 |
如果你是公司或学校账号，组织管理员策略可能影响可用性。个人账号能用，不代表 Workspace 账号也能用。
国内开发者的安全边界
- 不要把私有仓库完整粘贴到第三方平台。
- 不要让模型读取
.env、密钥、证书、客户数据。 - 不要把 API Key 写进提示词。
- 不要运行不明命令。
- 不要让 AI 直接改鉴权、支付、删除数据逻辑。
- 复杂改动一定看 diff、跑测试、再提交。
Gemini CLI 提示词模板
text
你是一个谨慎的代码审查助手。
项目目标：【一句话说明】
我希望你检查：【具体目录/文件】
要求：
1. 先列出你会查看的文件，不要直接修改
2. 找出最可能影响稳定性的 5 个问题
3. 每个问题给出文件位置、原因、修复建议
4. 修改建议要小步提交
5. 不要读取 .env、密钥、证书或客户数据常见问题
Gemini CLI 是 Google 官方的吗
优先以 google-gemini/gemini-cli GitHub 仓库 和 Google Cloud 文档为准。搜索结果里可能出现仿冒工具，安装前一定核查域名、组织名和包名。
Gemini Code Assist 支持 VS Code 吗
支持情况以官方插件页和 Google 文档为准。它面向 VS Code、JetBrains、Cloud Shell 等开发环境的能力可能随版本更新。
Gemini CLI 403 是什么意思
常见原因包括账号权限不足、服务未启用、组织策略、地区限制、配额或模型不可用。先看官方文档和扩展日志，再排查本地环境。
代码能直接交给 Gemini 自动改吗
可以让它辅助，但不建议无审核自动改生产代码。尤其是鉴权、支付、数据删除、权限、迁移脚本和安全逻辑，必须人工复核。