用户指南
开发工具

Gemini CLI 使用指南

通过环境变量把 Gemini CLI 的原生请求转发到 Magick API,并设置默认模型

Gemini CLI 走的是 Gemini 原生协议面。接入 Magick API 时,核心就是把 Gemini CLI 的网关地址、API Key 和默认模型配置到环境变量里。

方案一(推荐):直接设置环境变量

Gemini CLI 当前推荐直接通过环境变量接入,通常不需要额外编辑配置文件。

Mac/Linux

export GOOGLE_GEMINI_BASE_URL="https://api.magickapi.com"
export GEMINI_API_KEY="后台生成的 API KEY"
export GEMINI_MODEL="gemini-3.1-pro-preview"

Windows CMD

set GOOGLE_GEMINI_BASE_URL=https://api.magickapi.com
set GEMINI_API_KEY=后台生成的 API KEY
set GEMINI_MODEL=gemini-3.1-pro-preview

PowerShell

$env:GOOGLE_GEMINI_BASE_URL="https://api.magickapi.com"
$env:GEMINI_API_KEY="后台生成的 API KEY"
$env:GEMINI_MODEL="gemini-3.1-pro-preview"

启动 Gemini CLI

执行完上面的 3 条命令后,进入你要开发的项目目录,直接运行:

gemini

说明

  • GEMINI_API_KEY 请填写 Magick API 后台生成的密钥
  • GOOGLE_GEMINI_BASE_URL 固定指向 https://api.magickapi.com
  • GEMINI_MODEL 可以作为 Gemini CLI 的默认模型;这里给出的示例值是 gemini-3.1-pro-preview
  • 如果你需要查看 Gemini 原生接口的请求路径与请求体格式,可以继续参考“通用模型 / Gemini 原生格式”

最后更新于

目录