为你的编程智能体或 IDE 选择 API 接入指南

客户端与接入方式

• DeepSeek Harness

  在 DeepSeek Harness 中打开 Settings → Models → Add model provider → Custom model API，选择 OpenAI Chat Completions，地址填写 https://apiclo.com/v1。Harness 是客户端，费用由所选 ApiClo 模型与费率决定。此配置不会接入 DeepSeek 网页聊天的联网搜索服务。

• OpenCode

  通过自定义 OpenAI 兼容供应商将 OpenCode 接入 ApiClo，地址为 https://apiclo.com/v1，密钥放入 APICLO_API_KEY。OpenCode v1 与 v2 的配置字段不同，复制配置前先运行 opencode --version。

• Oh My Pi (OMP)

  Oh My Pi 通过 ~/.omp/agent/models.yml 配置 ApiClo。设置 baseUrl=https://apiclo.com/v1、api=openai-completions，apiKey 填环境变量名 APICLO_API_KEY。OMP 与 Pi 使用不同的配置文件和密钥语法。

• Pi

  通过 ~/.pi/agent/models.json 将 Pi 编程智能体接入 ApiClo：baseUrl 为 https://apiclo.com/v1，api 为 openai-completions，apiKey 为 $APICLO_API_KEY。打开 /model 重新读取文件并选择自定义供应商。这里的 Pi 指编程智能体。

• Kimi Code

  Kimi Code 可配置指向 ApiClo /v1 地址的 OpenAI 兼容供应商。ApiClo 与 Kimi Code 的兼容性仍在测试中，本页提供待验证的配置方法，不代表自主任务已通过验证。Kimi Code 的凭据与 Kimi 网页聊天、联网搜索服务应分别看待。

• Orca

  在 Orca 中使用 ApiClo 时，应配置 Orca 启动的编程智能体，例如 Codex CLI、Claude Code、OpenCode 或 Pi。Orca 管理会话与工作树，API 地址、密钥和模型由子智能体配置。

• Crush

  在当前 Crush 的全局 crushrc 中添加 openai-compat 类型的 ApiClo 供应商，地址为 https://apiclo.com/v1，密钥来自 APICLO_API_KEY。当前配置使用 Crush 内置 Bash 命令，旧 JSON 示例属于另一种配置格式。

• Goose

  Goose 可通过自定义 OpenAI 兼容供应商接入 ApiClo。在 Settings → Models 或 goose configure 中配置供应商，使用其凭据流程保存 ApiClo 密钥，并添加准确模型 ID。请确认界面需要完整 API URL，还是分别填写 host 与 path。

• Codex CLI / IDE

  Responses API；用户级 config.toml 与 env_key。

• 克劳德·科德

  Anthropic Messages；根地址与 ANTHROPIC_AUTH_TOKEN。

• VS Code: Cline / Roo Code / Kilo Code

  扩展中的供应商设置；/v1 与准确模型 ID。

• Cursor

  自定义 API；核对 Cursor 专用模型 ID 和功能限制。

• Trae

  若当前版本和账户提供该选项，可在 Trae 的 Settings → Models → Add Model → Custom Config 中接入 ApiClo。先选择 API Format：OpenAI 兼容 Chat Completions 与 Anthropic Messages 使用不同的请求路径。

• 继续

  config.yaml：provider、apiBase、apiKey 与模型角色。

• VS Code 原生 BYOK

  Custom Endpoint 模型配置；需验证工具和视觉能力。

• OpenClaw

  区分 OpenAI 与 Anthropic 供应商模式，使用匹配的地址和输入类型。

• 奎文密码

  在支持时使用 OpenAI 兼容模式与 OPENAI_* 环境变量。

• Aider

  OpenAI 兼容接口与模型选择器的 openai/ 前缀。

• 打开 WebUI / LibreChat

  自托管聊天界面；在服务端配置 API 连接与凭据。

• 爱马仕代理

  托管工作空间；托管与模型 token 用量分别计费。

• 双子座命令行界面

  有条件支持：直接接入需要允许兼容自定义接口的版本。

• ApiClo 桌面/本地路由器

  本地路由选项；核对当前可用版本与客户端要求。

开始之前

• 确认准确的客户端和版本；名称相似不代表配置相同。
• 创建 ApiClo 密钥，核对模型能力及当前输入、输出、缓存费率。

操作步骤

1. 选择协议

   OpenAI 兼容 Base URL 通常为 https://apiclo.com/v1。Claude Code 使用 https://apiclo.com 并自行追加 /v1/messages。要求完整请求 URL 的字段需要包含具体接口路径。

2. 验证实际请求

   分别测试文本、工具和图片。并行或无人值守任务前，在 Logs 中核对准确模型与用量。

3. 比较完整 token 成本

   计入输入、输出、缓存读取和写入。40/40/20 示例假设一百万总 token：0.4 × 输入费率 + 0.4 × 读取费率 + 0.2 × 输出费率，不含初次写入。自己的平均成本应依据实际 Logs。

检查结果

按所选指南完成配置，并将成功请求与 ApiClo Logs 对照。有文档不代表每个版本、模型和功能都已通过集成测试。

常见问题

• DeepSeek Harness 是客户端，DeepSeek 网页聊天中的联网搜索是独立服务。
• Kimi Code 是编程客户端，接入 ApiClo 不包含 Kimi 订阅或 Kimi 搜索工具。
• GLM、Kimi、DeepSeek 模型是否可用，应查询 ApiClo 当前模型目录；客户端名称不代表这里销售同名模型。

兼容性与计费

ApiClo 独立于上述客户端和 AI 供应商。Kimi Code 仍在测试；Orca 通过子智能体调用；Gemini CLI 需要兼容的自定义接口支持。API 余额、客户端订阅和托管分别计费，不保证缓存命中比例或所有任务的最低价格。