Felo API PlatformFelo API Platform

开始

FeloAPI CLI

安装 FeloAPI CLI，用 npx feloapi-cli setup 配置 Codex、Claude Code、模型和 Felo Skills。

在终端里为 Codex 或 Claude Code 配置 Felo 模型和 Felo Skills，也可以继续使用 Felo 搜索、幻灯片、网页提取和 LiveDocs 等命令。

一条命令开始配置

先安装 Node.js 22 或更高版本，然后运行：

npx feloapi-cli setup

如果 npm 提示安装软件包，确认即可。无需 npm 账号，也无需全局安装。Codex 或 Claude Code 需单独安装；配置 Codex 模型需要 Codex CLI 0.134.0+。

获取 API Key 并完成向导

  1. 打开 Felo 控制台 API Keys 页面，登录 Felo 账号。
  2. 创建一个 Key，从创建成功的结果中复制完整 Key。列表只显示脱敏值，无法还原完整内容；如果没有保存原来的完整 Key，请新建一个。
  3. 在终端运行 npx feloapi-cli setup，选择 Codex 或 Claude Code。
  4. 选择 Models + Skills（模型和技能）、Skills only（仅技能） 或 Models only（仅模型）。按提示粘贴完整 Key，输入时不会显示内容。
  5. 配置模型时，选择账号可用的模型。Codex 需要支持 Responses 的文本模型，Claude Code 需要支持 Anthropic Messages 的文本模型。模型出现在列表里不代表一定兼容所选客户端。
  6. 查看配置预览，确认后保存。

Key 保存在本机 ~/.feloapi/state.json，该文件未加密，请勿提交到 Git 或同步到共享目录。不要把 Key 写进命令参数或公开日志。向导需要的是完整 API Key，不是 Felo 账户 Token，也不是 Key ID。

启动已配置的工具

完成配置后，启动对应工具：

npx feloapi-cli run codex

使用 Claude Code 时运行：

npx feloapi-cli run claude-code

通过上述启动命令，CLI 会把保存的 Key 和 Felo 配置传给工具。向导创建独立的 Felo 配置，不会切换你的默认模型提供商。安装 Skills 后，需要开启新的工具会话才能加载。

全局安装与按需配置

经常使用时，可以全局安装 feloapi-cli npm 包。安装后的命令名称是 feloapi：

npm install -g feloapi-cli
feloapi setup
feloapi run codex

只安装 Felo Skills：

npx feloapi-cli setup --agent codex --skills-only

预览模型连接而不保存配置；请把 YOUR_MODEL_ID 换成可用的模型 ID：

npx feloapi-cli models
npx feloapi-cli connect codex --model YOUR_MODEL_ID --dry-run

添加 --no-skills 可只配置模型。重新运行向导会用新选择替换该工具的 Felo 连接；选择“仅技能”会移除此前由 CLI 管理的模型配置。

使用 Felo 工具与检查配置

保存 Key 后，可以使用已有的 Felo 工具。API 请求可能消耗账号额度：

npx feloapi-cli search "AI agent trends" --json
npx feloapi-cli web-fetch --url https://example.com --format markdown

检查本地配置、查看全部命令：

npx feloapi-cli doctor
npx feloapi-cli --help

doctor 只做本地检查，不调用付费 API。doctor --online 会额外检查模型列表访问；doctor --probe --agent codex 会在确认后发送小型模型请求，可能产生费用。

问题处理方式
找不到 npx 或 Node 版本过旧安装 Node.js 22+，重新打开终端，用 node --version 检查版本。
Key 无效使用创建结果中的完整 Key，通过 npx feloapi-cli auth login 更新。
工具仍使用其他模型提供商通过 npx feloapi-cli run codex 或 run claude-code 启动，并检查项目设置和显式覆盖参数。
配置文件冲突查看提示中的文件。CLI 会保留不属于它管理的文件，以及被外部修改过的文件。
解除连接运行 npx feloapi-cli disconnect codex 或 disconnect claude-code。

npx feloapi-cli auth logout 只删除本地 Key。需要撤销 Key 时，请到 Felo 控制台操作。

如需手动配置，请查看 Codex 指南和 Claude Code 指南。