AI Code WithAI Code With

macOS 配置

在 macOS 上配置 Gemini CLI

macOS 配置指南

1. 创建配置目录

打开终端(Terminal),运行以下命令创建配置文件夹:

mkdir -p ~/.gemini

2. 创建并编辑配置文件

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

vi ~/.gemini/.env

选择访问线路

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

适用于:大部分国内用户,无需代理

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 保存并退出。

适用于:国内直连不稳定时使用,需要自己挂代理

i 进入编辑模式,写入以下配置内容:

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

# 中转服务地址(CF 加速)
GOOGLE_GEMINI_BASE_URL=https://api.aicodewith.com/gemini_cli

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

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

不确定选择哪个线路?查看 线路选择指南 了解详情。

支持的模型列表

系列模型名称说明
Pro 3gemini-3-pro-high深度思考模式
gemini-3-pro-low快速思考模式
Pro 2.5gemini-2.5-pro标准版本,平衡性能
gemini-2.5-pro-thinking带推理过程输出
gemini-2.5-pro-nothinking不显示推理过程
Flash 2.5gemini-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

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