跳转至

Gemini CLI 配置教程

Gemini CLI 是 Google 官方的命令行 AI 工具，可以通过配置 .env 文件来使用中转服务。

安装

npm i -g @google/gemini-cli@latest

安装完成后验证：

gemini --version

前提条件

安装前请先完成 环境检查，确保 Node.js 已正确安装。

配置

方式一：使用 CC-Switch（推荐）

使用 CC-Switch 可以一键完成 Gemini CLI 的配置，参考 CC-Switch Gemini 配置。

方式二：手动配置 .env 文件

  1. 键盘按下 Win+R，输入以下内容后回车，打开 Gemini CLI 配置目录
%userprofile%\.gemini
  1. 如果目录下没有 .env 文件，请新建一个 .env，写入以下内容
  1. 打开终端，进入 Gemini CLI 配置目录
cd ~/.gemini
  1. 如果目录下没有 .env 文件，请新建一个 .env，写入以下内容

.env 文件内容：

GOOGLE_GEMINI_BASE_URL=https://api.yunxicodes.com
GEMINI_API_KEY=sk-你的密钥
GEMINI_MODEL=gpt-5.3-codex

说明

  • .env：Gemini CLI 的配置文件，主要设置自定义端点、API Key 和所用模型
  • GOOGLE_GEMINI_BASE_URL：中转服务地址，注意不需要加 /v1
  • GEMINI_API_KEY：替换为你的 sk- 开头的 API 密钥
  • GEMINI_MODEL：根据你的套餐选择对应模型，推荐 gpt-5.3-codex 或 gpt-5.4

配置信息汇总

项目 值
配置文件 ~/.gemini/.env
GOOGLE_GEMINI_BASE_URL https://api.yunxicodes.com
GEMINI_API_KEY 你的 sk- 开头的密钥
GEMINI_MODEL 根据套餐选择（推荐 gpt-5.3-codex）

验证配置

配置完成后，在终端运行：

gemini

如果正常进入对话界面并能获得回复，说明配置成功。

推荐模型

目前可用的模型请参考 可用模型 页面。

已知问题

注意事项

  • Gemini CLI 目前存在一些兼容性问题（模型调用失败、图片粘贴问题等）
  • 如果遇到问题，可以参考 Gemini 常见问题
  • 建议使用 CC-Switch 进行配置，或者换用其他支持的客户端工具