当前位置: 首页 > news >正文

LinkAGI:面向 Claude Code、Codex 与 Gemini CLI 的统一 API 接入服务

很多开发者并不是只使用一种 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 Codehttps://api.linktoagi.com/v1/messages
Codex / Responseshttps://api.linktoagi.com/v1/responses
Gemini CLIhttps://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 设置环境变量:

exportLINKTOAGI_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 Max2.4仅限 Claude Code 内使用
Claude Code Max-C1.8支持第三方客户端接入
Codex Sale0.12低价测试路线,稳定性较低
Codex Plus0.2日常使用路线
Codex Pro0.4可外接路线
Gemini / Grok1.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 的真实项目案例、报错排查记录和可复用配置。

http://www.jsqmd.com/news/1178040/

相关文章:

  • 系统架构师必知:3种最大流算法对比(Ford-Fulkerson vs Edmonds-Karp vs Dinic)
  • 九大网盘高速下载终极指南:LinkSwift 直链助手完整使用教程
  • AMD EPYC 9004系列与ARM服务器CPU:5项关键指标实测与混合云选型分析
  • PyTorch模型生产可观测性实战:Prometheus+Loki+Jaeger四层架构
  • 2026年7月哈尔滨玻璃/黑龙江钢化玻璃品牌选择策略_黑龙江屿泰玻璃制品有限公司 - 行业平台推荐
  • 宝玑中国官方售后服务中心|最新官方地址和维修热线权威信息通告(2026年7月更新) - 亨得利钟表维修中心
  • Granger因果检验:预测增强性检验而非真实因果推断
  • 2026年聚氨酯同步带厂家口碑榜:哪家质量更靠谱?
  • 2026年7月惠州快充适配器电源ATE测试设备/惠州工业控制电源ATE测试设备选厂核心技巧_扶光科技(惠州)有限公司 - 行业平台推荐
  • 产后私密清爽护理泡沫使用注意
  • 物理AI:打破虚拟边界,解锁AI落地物理世界的下一代革命
  • 差分隐私与可信执行环境协同实现数据可用不可见
  • Python遗传算法实战:100皇后问题工程化求解与调优
  • 多Agent设计与工程
  • Win10专业工作站版极简一键重装方案详解
  • 深度学习算法实战指南:从CNN到Transformer的场景选择与代码实现
  • SVD 手眼标定法:从 9 组数据求解 AX=XB 的 5 步核心推导
  • 亲身到店探访杭州亨得利官方名表服务中心|服务热线及全部维修地址(2026年7月更新) - 亨得利官方
  • 2026年7月江苏吨袋倒袋拆包机/吨袋拆包机工厂评估指南_南京共赢粉体设备有限公司 - 行业平台推荐
  • 为什么药品冷藏箱不能只看最低温度?——基于PMG MP8 6L压缩机药品冷藏箱的一次完整工程测试解析
  • Excel 2021/365 数据透视表实战:5分钟重构千行住宿表,实现多维度统计
  • 亲身到店探访杭州亨得利官方名表服务中心|官方热线及详细网点地址(2026年7月更新) - 亨得利官方
  • Windows 11终极清理指南:用Win11Debloat快速优化你的系统性能
  • 2026年7月六驱消防洒水车/六驱越野客车工厂行业评估_湖北神宇专用汽车有限公司 - 行业平台推荐
  • H3C交换机 Comware V7 光模块诊断:5个关键命令排查链路丢包与光衰
  • C++实现LBM-MRT模拟加热气泡脱离:从多相流到传热耦合
  • git-svn 迁移实战:1350次提交历史完整迁移,耗时1.5小时实测
  • Kickstarter预热内容怎么让AI搜索更容易识别品牌实体
  • 扩散模型与强化学习结合:生成可控3D胸部CT的关键技术与医学应用
  • 深度学习实战:CNN、RNN、Transformer、GAN八大核心算法项目实现