docs

Linux 配置

在 Linux 上配置 Gemini CLI

ziyang

— 2 min read

Linux 配置指南

1. 创建配置目录

打开终端，运行以下命令创建配置文件夹：

mkdir -p ~/.gemini

2. 创建并编辑配置文件

在 ~/.gemini 目录下创建 .env 文件：

vi ~/.gemini/.env

选择访问线路

我们提供两个访问线路，请根据你的网络环境选择其中一个：

<Tabs items={['海外直连（推荐）', '国内线路（备用）']}>

适用于：大部分用户首选，通过 CF Tunnel 国内通常可直连，若不通可挂代理

按 i 进入编辑模式，写入以下配置内容：

# 这里的 Key 需要是在网站里面创建的 Key
GEMINI_API_KEY=your_api_key_here

# 中转服务地址（海外直连）
GOOGLE_GEMINI_BASE_URL=https://api.aicodewith.com/gemini_cli

# 模型名称，请从下方的支持列表中选择
GEMINI_MODEL=gemini-2.5-pro

按 Esc 退出编辑模式，然后输入 :wq 保存并退出。

适用于：海外直连不通且代理也不行时使用（链路较长：深圳→香港→日本）

按 i 进入编辑模式，写入以下配置内容：

# 这里的 Key 需要是在网站里面创建的 Key
GEMINI_API_KEY=your_api_key_here

# 中转服务地址（国内线路）
GOOGLE_GEMINI_BASE_URL=https://api.jiuwanliguoxue.com/gemini_cli

# 模型名称，请从下方的支持列表中选择
GEMINI_MODEL=gemini-2.5-pro

按 Esc 退出编辑模式，然后输入 :wq 保存并退出。

不确定选择哪个线路？查看 [线路选择指南](/docs/route-selection) 了解详情。

支持的模型列表

系列 模型名称 说明
Pro 3 gemini-3-pro-high 深度思考模式
gemini-3-pro-low 快速思考模式
Pro 2.5 gemini-2.5-pro 标准版本，平衡性能
gemini-2.5-pro-thinking 带推理过程输出
gemini-2.5-pro-nothinking 不显示推理过程
Flash 2.5 gemini-2.5-flash 快速响应版本
gemini-2.5-flash-thinking 带推理过程输出
gemini-2.5-flash-nothinking 不显示推理过程
gemini-2.5-flash-lite 极速轻量版本

3. 创建 settings.json 文件

在终端中运行以下命令创建 settings.json 文件：

vi ~/.gemini/settings.json

按 i 进入编辑模式，写入以下内容：

{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

按 Esc 退出编辑模式，然后输入 :wq 保存并退出。

4. 验证配置

在终端中运行：

gemini

如果看到交互界面并能正常回复，即表示配置成功！

Read more