Gemini CLI 配置模型：切换 Gemini 模型与自定义接口地址

Gemini CLI 面向 Google 的 Gemini 模型设计。你可以在不同的 Gemini 模型之间切换，也可以修改接口地址让请求经过代理或网关，但官方并不支持直接换成其他厂商的模型。

切换模型

按优先级从高到低：

# 1. 命令行参数，只对本次会话生效（优先级最高）
gemini -m <模型名>

# 2. 环境变量
export GEMINI_MODEL=<模型名>

3. 写进配置文件。用户级配置在 ~/.gemini/settings.json，项目级配置在项目里的 .gemini/settings.json：

{
  "model": {
    "name": "<模型名>"
  }
}

用 Google 账号登录时，可用的模型由账号套餐决定；使用 API Key 登录可以更自由地指定模型。可用模型名以 Google 官方文档为准。

修改接口地址

需要经过公司代理、网关或区域镜像时，可以覆盖默认接口地址：

地址必须使用 HTTPS（localhost 除外）。网关需要兼容 Gemini API 的请求格式。

用 .env 文件管理变量

Gemini CLI 会依次查找并加载以下位置的 .env 文件：

1. 当前目录
2. 向上逐级查找父目录，直到项目根目录或用户主目录
3. 用户主目录下的 ~/.env

推荐把 Gemini CLI 专用的变量放在 .gemini/.env 里，避免和项目自己的 .env 混在一起。

想用其他模型？

如果需要在终端里自由切换 Claude、GPT、DeepSeek、Qwen 等模型，可以看看：

• Qwen Code：由 Gemini CLI 改造而来，支持任意 OpenAI 兼容接口
• OpenCode、Aider：开源、支持数十家模型提供方