AI 工具设置
AI 工具接入总览
用一个 Felo API key,把终端编码工具、编辑器和 Agent 平台接入 Felo 模型。先选择客户端,再按对应指南设置 API key、协议地址和模型。
把你熟悉的编码工具、编辑器或 Agent 平台连接到 Felo API Platform,就能在原有工作流中调用 Felo 提供的模型。客户端负责对话、读取文件和执行工具,Felo 提供模型 API 接入;你需要配置的是 API key、Base URL 和模型 ID。
接入前准备
- 在 API Keys 页面创建并保存完整的 Felo API key。
- 确认账户有可用服务额度;计费方式见计费与额度。
- 安装并启动要使用的客户端,确认它支持自定义模型 provider 或兼容 API 地址。
- 从模型目录选择模型。编码 Agent 需要模型支持工具调用,模型 ID 请按目录完整填写。
API key 是访问凭证;Base URL 决定请求发送到哪里;模型 ID 决定调用哪个模型。Felo key 应填写在自定义 API provider 中,不要作为客户端的官方订阅凭证使用。
选择接入范围
- 使用 Felo 模型:配置客户端的模型 provider,模型调用消耗平台余额。Claude Code、Codex 等客户端的 CLI 自动配置方式以对应指南为准。
- 安装 Felo Skill:让现有模型调用 Felo 的工具能力。OpenCode 的
feloapi setup --agent opencode --skills-only --yes只安装 Skill;模型连接需按 OpenCode 指南单独设置。
CLI 安装、验证与恢复配置见 FeloAPI CLI 指南。
选择你的工具
| 使用场景 | 客户端设置指南 |
|---|---|
| 终端编码、代码审查与仓库修改 | Codex、Claude Code、OpenCode |
| 本地助手与 Agent 工作流 | OpenClaw、Hermes Agent |
| 编辑器内的模型接入 | Cursor、TRAE |
| 编辑器中的编码扩展 | Cline、Roo Code、Kilo Code |
| 通过本地网关管理多个 Agent 的模型连接 | Magpie |
| 其他支持自定义 API 地址的客户端 | 通用接入指南 |
每篇客户端指南会说明配置文件、环境变量、模型选择和验证步骤。客户端版本或账户方案可能影响自定义 provider 的可用性,请以对应指南和客户端当前设置为准。
选择正确的协议地址
| 客户端使用的协议 | Base URL | 常见客户端 |
|---|---|---|
| OpenAI-compatible Chat Completions | https://openapi.felo.ai/api/v1 | OpenCode,以及选择该模式的编辑器或扩展 |
| OpenAI-compatible Responses | https://openapi.felo.ai/api/v1 | Codex |
| Anthropic-compatible Messages | https://openapi.felo.ai/api | Claude Code,以及明确选择 Messages 模式的客户端 |
填写 Base URL 时不要自行追加 /chat/completions、/responses 或 /messages;客户端适配器会构造请求路径。协议由客户端的 provider 配置决定,不能只根据模型名称判断。
通用接入流程
- 打开上方对应客户端的指南,选择自定义 provider 或兼容 API 模式。
- 填入 Felo key、对应协议的 Base URL 和模型 ID。优先用环境变量保存 key,再按客户端要求引用变量。
- 在当前会话中选择 Felo provider 和配置好的模型;仅保存配置不一定会切换当前模型。
- 发送一条简短消息,确认模型能返回回答。
- 对编码 Agent,再运行一个简单的只读任务,例如「列出项目的主要目录」,验证工具调用。
环境变量的名称和加载方式因客户端而异。请按对应指南设置,不要假设所有工具都会自动读取 FELO_API_KEY 或 OPENAI_BASE_URL。
遇到连接问题
- 认证失败:检查 key 是否完整、有效,及客户端进程是否读取到了环境变量。
- 请求发往其他服务:检查当前模型的 provider,以及项目级配置是否覆盖了用户级配置。
- 接口路径或协议报错:核对 provider 的协议和上表中的 Base URL。
- 找不到模型或工具调用失败:核对模型 ID、当前可用性和工具调用支持。
接入模型之后
模型接入完成后,如果还需要联网搜索、网页提取、X 数据或 PPT,可以继续查看 Felo OpenAPI 接入指南。这些能力需要单独配置,不会因更换模型 provider 自动启用;不同 API 的扣费方式以对应文档为准。