很多开发者并不是只使用一种 AI 工具：写代码时可能在 Claude Code 和 Codex 之间切换，处理轻量任务时又会使用 Gemini CLI，项目里还可能需要 OpenAI-compatible 或 Anthropic-compatible API。

问题也随之出现：账号分散、Key 分散、充值记录分散，而且不同客户端对 Base URL 的要求并不一致。少写或多写一层 /v1，就可能遇到 401、404 或返回 HTML 页面等问题。

LinkAGI 是一个面向 AI 编程工具与常用客户端的统一 API 接入服务，目标是用一个控制台完成令牌创建、模型选择、余额管理和调用记录查询。

控制台：https://api.linktoagi.com

使用文档：https://docs.linktoagi.com

LinkAGI 主要解决什么问题

1. 一套控制台管理多种客户端

目前文档和接口重点覆盖：

• Claude Code 与 Anthropic Messages API；
• Codex CLI、IDE 扩展与 OpenAI Responses API；
• Gemini CLI 与 Gemini-compatible API；
• Cherry Studio、ChatBox 等常用第三方客户端；
• OpenAI-compatible、Anthropic-compatible 等应用接入方式。

用户可以在控制台创建令牌、查看可用模型、选择令牌分组，并通过调用记录定位认证失败、模型无权限和额度不足等问题。

2. 按使用量充值，不绑定固定月度套餐

LinkAGI 采用按量充值方式，适合使用频率不固定、需要先验证工具效果，或者同时维护多个 AI 客户端的开发者。

当前公开政策包括：

• 支持微信、支付宝充值；
• 余额和每次调用记录可以在控制台查看；
• 支持未消耗余额退款，退款金额按“实充金额减去实际消耗”计算；
• 消费满 50 元可以联系客服申请开票；
• 提供问题反馈、商务咨询和企业技术支持入口。

具体规则以控制台实时显示为准。

3. 国内网络环境可以直接接入

客户端统一连接 LinkAGI API 地址，可以减少直接连接不同境外模型平台时需要分别处理网络环境、账号地区和多个 Key 的麻烦。

Codex 使用自定义模型提供方后，可以直接读取 LinkAGI 令牌，不要求先登录 ChatGPT 账号；Claude Code 和 Gemini CLI 也可以通过对应环境变量完成配置。

三种客户端的 Base URL 怎么填

这里是最容易混淆，也最值得单独说明的地方。

客户端	Base URL	客户端继续追加的路径
Claude Code	https://api.linktoagi.com	/v1/messages
Codex / Responses	https://api.linktoagi.com/v1	/responses
Gemini CLI	https://api.linktoagi.com	/v1beta/models/...

Base URL 并不是最终请求地址，客户端还会继续拼接协议路径。

例如 Claude Code 如果错误地填写：

https://api.linktoagi.com/v1

客户端再次追加 /v1/messages 后，最终可能得到：

https://api.linktoagi.com/v1/v1/messages

这种重复路径会返回 404。Codex 则相反，它通常只追加 /responses，所以 Base URL 需要保留 /v1。

Claude Code 配置示例

macOS、Linux 或 Windows 均可使用 settings.json。文件内容如下：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.linktoagi.com",
    "ANTHROPIC_AUTH_TOKEN": "替换为在 LinkAGI 创建的 API Key",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  }
}

配置完成后重新打开终端，再启动 claude。

Codex 配置示例

编辑 ~/.codex/config.toml：

model_provider = "linkagi"
model = "替换为控制台中实际可用的模型名"

[model_providers.linkagi]
name = "LinkAGI"
base_url = "https://api.linktoagi.com/v1"
wire_api = "responses"
env_key = "LINKTOAGI_API_KEY"

macOS、Linux 或 WSL 设置环境变量：

export LINKTOAGI_API_KEY="替换为在 LinkAGI 创建的 API Key"

Windows PowerShell 可以写入当前用户环境变量：

[Environment]::SetEnvironmentVariable(
  "LINKTOAGI_API_KEY",
  "替换为在 LinkAGI 创建的 API Key",
  "User"
)

完成后进入代码项目运行 codex，再使用 /status 检查模型提供方、模型名称和权限设置。

Gemini CLI 配置示例

编辑 ~/.gemini/.env：

GOOGLE_GEMINI_BASE_URL="https://api.linktoagi.com"
GEMINI_API_KEY="替换为在 LinkAGI 创建的 API Key"
GEMINI_MODEL="替换为控制台中实际可用的模型名"

不要把 Codex 的 /v1 地址直接复制给 Gemini CLI，否则可能形成错误协议路径。

当前公开模型路线与分组

LinkAGI 当前公开模型路线覆盖 Claude、GPT / Codex、Gemini 和 Grok。不同分组面向低成本测试、日常使用、Claude Code 专用和第三方客户端接入等场景。

部分当前公开分组倍率如下：

路线	分组倍率	适用说明
Claude Code 补贴渠道	0.8	当前推荐的性价比路线
Claude Code 廉价渠道	0.72	价格较低，偶尔可能缺号
Claude Code Max	2.4	仅限 Claude Code 内使用
Claude Code Max-C	1.8	支持第三方客户端接入
Codex Sale	0.12	低价测试路线，稳定性较低
Codex Plus	0.2	日常使用路线
Codex Pro	0.4	可外接路线
Gemini / Grok	1.0	对应协议路线

需要注意：分组倍率不是所有模型的最终单价。实际扣费还会受到具体模型的输入倍率、输出倍率、缓存与按次计费规则影响，请以模型广场和调用记录显示为准。

第一次使用建议

建议按下面的顺序验证：

1. 使用邮箱完成注册和验证；
2. 在“令牌管理”创建一个 API Key；
3. 在“模型广场”确认令牌分组允许使用的模型名称；
4. 根据客户端填写正确 Base URL；
5. 先执行一个小型、只读任务；
6. 回到控制台检查调用记录和实际消耗；
7. 确认模型、响应速度和计费符合预期后再继续使用。

常见错误排查

401 Unauthorized

通常说明请求已经到达认证环节。检查 API Key 是否完整、环境变量是否被客户端读取、令牌是否启用以及账户是否还有余额。

404 或 endpoint not found

检查 Base URL 是否重复包含 /v1，Codex 是否遗漏 /v1，以及 Codex 是否设置了 wire_api = "responses"。

返回 HTML 而不是 JSON

请求可能落到了控制台前端页面，而不是 API 路由。浏览器能打开某个地址，不代表客户端访问的是正确 API 端点。

模型不存在或无权限

回到模型广场查看令牌分组允许的模型，把配置中的模型名称改成完全一致的值。

适合与不适合的场景

LinkAGI 更适合个人开发者、小团队、AI 应用原型、多客户端统一管理，以及希望按使用量充值的场景。

如果业务只能接受模型厂商官方直连，或者请求包含不能经过第三方服务的敏感数据，应优先选择模型厂商官方接口并建立自己的安全与合规方案。

入口汇总

• LinkAGI 控制台：https://api.linktoagi.com
• 完整接入文档：https://docs.linktoagi.com
• 问题反馈与技术支持：https://docs.linktoagi.com/about.html#support
• 联系邮箱：linktoagi@163.com

后续文档还会继续补充 Claude Code、Codex 和 Gemini CLI 的真实项目案例、报错排查记录和可复用配置。