Gemini CLI 配置

Gemini CLI 是 Google 推出的命令行 AI 工具。通过 Tokenhot 的 Gemini 兼容接口，可以在 Gemini CLI 中调用 Tokenhot 当前支持的 Gemini 协议模型。

Gemini CLI 可能读取当前项目文件并执行工具操作。请先确认权限设置，不要将 API Key 写入代码或提交到 Git 仓库。

前置要求

Node.js 20+

Tokenhot API Key

已安装 Gemini CLI 或 CC-Switch

配置步骤

1. 安装 Gemini CLI

验证安装：

2. 使用 CC-Switch 配置 Tokenhot

打开 CC-Switch，选择 Gemini CLI 应用，新增一个自定义服务商。

CC-Switch 的界面名称会随版本变化。请按“Gemini CLI / Custom Provider / Gemini-compatible”等名称选择，不要依赖固定选项序号。

填写以下内容：

配置项	值
服务商名称	`tokenhot`（可自定义）
API Base URL	`https://api.tokenhot.ai`
API Key	你的 Tokenhot API Key
模型	从 Tokenhot 模型列表复制完整模型 ID
写入通用配置	按需开启；仅在希望所有项目使用同一配置时开启

保存并启用该服务商后，关闭并重新打开终端，再启动 Gemini CLI。

3. 验证连接

进入 Gemini CLI 后，发送一条简单消息：

你好，请简要介绍你自己。

收到正常回复即表示连接成功。

不使用 CC-Switch 的手动配置

如果你不使用 CC-Switch，可在当前终端设置环境变量。

PowerShell：

$env:GOOGLE_GEMINI_BASE_URL = "https://api.tokenhot.ai"
$env:GEMINI_API_KEY = "你的 Tokenhot API Key"
gemini

macOS / Linux：

环境变量仅对当前终端会话生效。不要把真实 API Key 写入公开脚本、项目配置或 Git 仓库。

可用模型

请以 Tokenhot 模型列表中明确标注支持 Gemini 协议 的模型为准。

不同模型支持的上下文长度、图片/PDF 输入、工具调用和推理能力不同。请不要假设所有 Gemini 协议模型都支持 1M 上下文或多模态输入。

使用建议

代码生成与审查：选择明确标注支持代码能力的模型。

长文档分析：选择上下文长度满足任务要求的模型。

图片和 PDF 分析：先确认所选模型支持对应输入类型。

复杂任务：先用小任务验证模型、权限和成本，再处理真实项目。

常见问题

连接失败

请检查：

API Base URL 是否为 https://api.tokenhot.ai

API Key 是否有效。

所选模型是否支持 Gemini 协议。

修改配置后是否已重启终端和 Gemini CLI。

模型不可用

请从 Tokenhot 模型列表复制完整模型 ID，不要手动猜测名称。确认模型已在 CC-Switch 中启用，或已被 Gemini CLI 当前配置加载。

API Key 泄露怎么办

立即前往 Tokenhot 控制台删除或轮换该 API Key，并更新本地 CC-Switch 或环境变量配置。

Gemini CLI

Gemini CLI 配置#

前置要求#

配置步骤#

1. 安装 Gemini CLI#

2. 使用 CC-Switch 配置 Tokenhot#

3. 验证连接#

不使用 CC-Switch 的手动配置#

可用模型#

使用建议#

常见问题#

连接失败#

模型不可用#

API Key 泄露怎么办#