Claude Code、Codex、Gemini CLI 三合一接入教程

开始前准备

建议为 Claude Code、Codex、Gemini CLI 分别创建独立令牌，便于后续查看调用记录、额度消耗和权限管理。

• 官网入口：https://api.keygc.top/newhome
• 控制台入口：https://api.keygc.top/console
• 统一接口地址：https://api.keygc.top/v1

一、Claude Code 配置

Claude Code 可以通过环境变量指定 Anthropic 兼容接口。将基础地址设置为根块 API，并把令牌替换成你自己的 API Key。

macOS / Linux bash

echo 'export ANTHROPIC_BASE_URL="https://api.keygc.top/v1"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="替换为您的API Key"' >> ~/.bashrc
source ~/.bashrc

macOS / Linux zsh

echo 'export ANTHROPIC_BASE_URL="https://api.keygc.top/v1"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="替换为您的API Key"' >> ~/.zshrc
source ~/.zshrc

Windows PowerShell

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://api.keygc.top/v1', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', '替换为您的API Key', 'User')

二、Codex 接入思路

Codex 类工具通常支持自定义接口地址和密钥。你可以把根块 API 作为统一的模型入口，按工具要求填写 Base URL 和 API Key。

Base URL: https://api.keygc.top/v1
API Key: 替换为您在根块 API 控制台创建的令牌

如果你的工具支持 OpenAI compatible 或自定义 API 地址模式，优先选择该模式。配置完成后，建议先发送一个短请求测试连通性，再进行长任务调用。

三、Gemini CLI 配置

Gemini CLI 的配置方式会随版本变化，但核心仍然是模型接口地址和密钥。可以在 CLI 的配置文件或环境变量中填入根块 API 的接口地址。

GEMINI_BASE_URL=https://api.keygc.top/v1
GEMINI_API_KEY=替换为您的API Key

如果当前 Gemini CLI 要求使用 Google 原生字段，请按 CLI 文档映射密钥字段；如果支持 OpenAI 兼容或自定义代理模式，则直接使用根块 API 的统一入口。

常见错误排查

• 401 或认证失败：确认 API Key 没有多余空格，且令牌状态正常。
• 404 或路径错误：确认 Base URL 使用 https://api.keygc.top/v1，不要重复拼接 /v1。
• 模型不可用：在控制台检查模型分组、渠道状态和当前账号可用分组。
• 请求很慢：查看渠道状态、模型价格页和调用日志，确认所选模型线路是否正常。

常见问题

根块 API 的 Claude Code Base URL 是什么？

Claude Code 推荐使用 https://api.keygc.top/v1，并将 ANTHROPIC_AUTH_TOKEN 替换为你在控制台创建的 API Key。

Codex 可以使用同一个 API Key 吗？

可以。建议在根块 API 控制台按用途单独创建令牌，方便后续查看调用记录、额度消耗和权限管理。

Gemini CLI 需要单独配置吗？

Gemini CLI 通常需要配置模型接口地址和密钥。具体参数以当前 Gemini CLI 版本为准，教程中提供的是通用接入思路。