Gemini 配置

Gemini 的配置方式会根据你使用的客户端不同而变化。常见做法是先在 coding-play.codes 创建 API 密钥，再把接口地址、API Key 和模型名称填入支持 Gemini 协议的工具中。

使用前准备

第一次配置前，建议先完成 使用前环境配置，并确认已经在 API 密钥管理 中创建好可用密钥。

一、准备 API Key

进入 coding-play.codes 控制台，打开 API 密钥 页面，创建一个专门给 Gemini 使用的密钥。

建议命名为：

gemini-cli

或者：

gemini-desktop

这样后续查看日志和管理额度时更容易区分。

二、确认模型与接口地址

在配置 Gemini 前，需要确认三类信息：

配置项	说明
API Key	在 API 密钥页面创建并复制
Base URL	按后台或服务商提供的 Gemini 接口地址填写
模型名称	按模型广场或后台显示的 Gemini 模型名称填写

不同工具的字段名称可能略有区别，例如：

• API Key
• Base URL
• Model
• Gemini API Endpoint

只要含义一致，按对应位置填写即可。

三、配置后验证

配置完成后，建议先发一个简单问题测试：

你好，请用一句话介绍你当前使用的模型。

如果能正常回复，说明 Gemini 配置已经生效。

如果请求失败，优先检查：

• API Key 是否复制完整
• Base URL 是否填错
• 模型名称是否和后台一致
• 账户余额是否充足
• 当前工具是否支持自定义 Gemini 接口

后续补充

后续可以继续把 Gemini CLI、Cherry Studio、OpenCode 等具体客户端的 Gemini 配置步骤拆成独立小节。