跳到主要内容
快速上手API 参考接入与支持
工具接入

Gemini CLI 接入指南

当前仅作排查参考。Gemini CLI 直连 AnideaAI 截至 2026-03-08 仍未验证通过。

Gemini CLI 接入指南

当前不作为推荐接入路径（2026-03-08）
  • 文档早期默认写死的 gemini-2.5-pro 不在本次测试账号的 /v1/models 列表里
  • 即使换成账号可见的 Gemini 模型，CLI 流式链路仍会报 Incomplete JSON segment at the end
  • 如果你只是想先用 Gemini 系列模型，优先改用 @google/genai 这类已验证过的 SDK
  • 如果你只是想先接命令行编程助手，优先改用 Claude Code 或 Codex CLI

这页保留主站快速开始里的 Gemini CLI 教程，作为排查参考。主站原页不会删除，但当前不要把它当成稳定接入方案。

先记住这 3 个变量​

  • GEMINI_API_KEY=sk-xxxxx
  • GEMINI_MODEL=<your-visible-gemini-model>
  • GOOGLE_GEMINI_BASE_URL=https://anideaai.com

本次测试账号里，已经能用 SDK 跑通的可见 Gemini 模型示例是 gemini-3.1-pro-preview。

但请注意，这不等于 Gemini CLI 这条链路已经一起跑通。

重要说明​

GEMINI_API_KEY 和 GEMINI_MODEL 是 Gemini CLI 官方文档公开写明的变量。
GOOGLE_GEMINI_BASE_URL 目前没有出现在 Gemini CLI 官方公开文档里，但官方仓库代码和 issue 里能看到这条未公开的 base URL 变量在社区代理场景中被使用。

这意味着：

  • 这套直连 AnideaAI 的写法目前只适合作为排查参考
  • 它不是 Gemini CLI 官方公开承诺的稳定配置入口
  • 截至 2026-03-08，这条 CLI 链路仍未完成回归验证
  • 以后升级 Gemini CLI 时，优先复核这一项

如果你只是想先把 Gemini 模型接进项目，先去看 开发框架与 SDK 接入指南 里的 Google GenAI SDK 示例。

1. 先装 Node.js 20 或更高版本​

可以任选一种方式：

  1. 打开 https://nodejs.org/ 下载最新版本，确保版本不低于 20
  2. 或在 PowerShell 里运行 winget install OpenJS.NodeJS

安装后检查：

node --version
npm --version

2. 安装 Gemini CLI​

npm install -g @google/gemini-cli
gemini --version

如果遇到权限问题，建议用管理员身份打开 PowerShell。

3. 配置环境变量​

当前会话临时生效：

$env:GOOGLE_GEMINI_BASE_URL = "https://anideaai.com"
$env:GEMINI_API_KEY = "sk-xxxxx"
$env:GEMINI_MODEL = "<your-visible-gemini-model>"

用户级永久生效：

[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://anideaai.com", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "sk-xxxxx", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_MODEL", "<your-visible-gemini-model>", [System.EnvironmentVariableTarget]::User)

检查变量：

echo $env:GOOGLE_GEMINI_BASE_URL
echo $env:GEMINI_API_KEY
echo $env:GEMINI_MODEL

清除变量：

Remove-Item Env:GOOGLE_GEMINI_BASE_URL -ErrorAction Ignore
Remove-Item Env:GEMINI_API_KEY -ErrorAction Ignore
Remove-Item Env:GEMINI_MODEL -ErrorAction Ignore
[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", $null, [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", $null, [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_MODEL", $null, [System.EnvironmentVariableTarget]::User)

4. 启动 Gemini CLI​

cd C:\path\to\your\project
gemini

5. 常见问题​

gemini 命令不存在：

先检查 Node.js 版本是不是至少 20。
再重新执行安装命令。

如果启动后没有走 AnideaAI：

先检查 GOOGLE_GEMINI_BASE_URL 是否已经生效。
再确认当前版本是否仍支持这条未公开变量。

如果报 Incomplete JSON segment at the end：

这通常不是变量名抄错，而是当前 CLI 流式链路本身还没兼容完成。
建议先改用 @google/genai SDK，或者先换 Claude Code / Codex CLI。

快速排错顺序​

  1. 先确认 GEMINI_API_KEY 和 GEMINI_MODEL 是否生效
  2. 再确认 GOOGLE_GEMINI_BASE_URL 是否已经进入当前 shell
  3. 再确认 GEMINI_MODEL 填的是你账号在 /v1/models 里真正可见的 Gemini 模型
  4. 如果仍报 Incomplete JSON segment at the end，先停止继续照抄本页，改用已验证工具或 SDK
  5. 如果升级后失效，优先怀疑这条未公开变量发生了变化
这页有帮助吗？
本页目录