使用文档工具接入

Gemini CLI 接入 CoderPlan 教程

将 Gemini CLI 接入 CoderPlan，配置 API Key、模型和 GOOGLE_GEMINI_BASE_URL，并排查登录或调用失败。

Gemini CLI 配置

Gemini CLI 使用 CoderPlan 时，把 GEMINI_API_KEY 设置为 CoderPlan API Key，把 GOOGLE_GEMINI_BASE_URL 指向 CoderPlan endpoint，再选择可用模型。配置后用小任务验证认证、余额和模型权限。

前置条件

先准备 CoderPlan 账号、可用余额和 `sk-` 开头的 API Key。建议用小额余额完成一次验证。

填对服务地址

Gemini CLI 中的 Base URL、Endpoint 或 OpenAI Compatible URL 按工具要求填写。Gemini CLI 覆盖 Gemini API base URL 时使用 GOOGLE_GEMINI_BASE_URL，填写 CoderPlan API endpoint。

Gemini CLI 配置示例

GEMINI_API_KEY=sk-your-api-keyGOOGLE_GEMINI_BASE_URL=https://api.coderplan.aiGEMINI_MODEL=gemini-2.5-pro

配置步骤

  1. 1

    准备 API Key、余额和模型名

    在 CoderPlan 控制台创建 API Key，确认余额可用，并从价格页选择可用的 Gemini 模型。

  2. 2

    写入 Gemini CLI 配置

    把 Gemini CLI 的 GOOGLE_GEMINI_BASE_URL 或等价 endpoint 指向 CoderPlan，并使用 CoderPlan API Key。

  3. 3

    先验证登录和认证

    如果工具同时支持网页登录和 API Key，先确认当前命令实际读取的是 CoderPlan API Key，而不是旧的本地登录状态。

  4. 4

    运行一次小任务

    用短提示词确认 Gemini CLI 能返回结果，再把它用于长上下文分析、代码解释或文档生成任务。

验证调用

保存配置后先发起一个简短请求，例如解释短函数。成功返回后，再交给它处理正式任务。

排查顺序

如果失败，先检查 GEMINI_API_KEY、GOOGLE_GEMINI_BASE_URL、余额、模型名称和本地登录状态是否生效。
查看排查教程选择编程模型

常见问题

Gemini CLI 可以接入 CoderPlan 吗？

可以。配置时让 API Key、GOOGLE_GEMINI_BASE_URL 和模型名都指向 CoderPlan，并先用小任务确认能正常返回。

Gemini CLI 中转站应该怎么理解？

在 CoderPlan 里，Gemini CLI 中转站指的是工具级第三方 API 接入：把 GOOGLE_GEMINI_BASE_URL 或等价 endpoint 指向 CoderPlan。这里不是系统代理配置，也不需要改浏览器代理。

Gemini CLI 登录失败和 API 调用失败应该怎么区分？

登录失败通常发生在工具账号会话阶段；API 调用失败更多与 endpoint、API Key、余额或模型名有关。先确认命令读取的配置，再看错误是否来自认证或模型请求。