AI Tool Setup
Codex
使用 Felo 自定义模型 provider 配置 Codex CLI。
当你想让 Codex CLI 使用 Felo API Platform 进行模型调用，同时保留原有 Codex 终端工作流时，请使用本指南。
开始之前
你需要一个 Felo API Platform key。同一个 key 可用于模型协议、Agent 客户端、Search、Web Fetch、PPT、Mindmap、LiveDocs、X Search、YouTube Subtitling、Landing Page 和 SuperAgent API。
export FELO_API_KEY="YOUR_API_KEY"推荐配置
| 项目 | 值 |
|---|---|
| 最适合 | CLI 编码工作流、代码审查、仓库修改和非交互式自动化 |
| 协议 | OpenAI-compatible Responses API |
| Base URL | https://openapi.felo.ai/api/v1 |
| 模型示例 | gpt-5.6-sol |
| API key | 你的 FELO_API_KEY |
配置 Codex
先设置环境变量：
export FELO_API_KEY="YOUR_API_KEY"
export OPENAI_API_KEY="$FELO_API_KEY"
export OPENAI_BASE_URL="https://openapi.felo.ai/api/v1"用户级 Codex 配置
在用户级 Codex 配置文件 ~/.codex/config.toml 中加入 Felo provider。
model_provider = "felo"
model = "gpt-5.6-sol"
[model_providers.felo]
name = "Felo API Platform"
base_url = "https://openapi.felo.ai/api/v1"
env_key = "FELO_API_KEY"
wire_api = "responses"Codex provider 设置应放在用户级配置中。不要把 API key 放进项目文件。
如需做一次非交互式检查，可以运行：
codex exec --model gpt-5.6-sol "Review this repository and list the main files"验证配置
保存配置后，运行一个小任务：
codex --model gpt-5.6-sol如果工具能够启动，并使用所选模型返回回答，说明 provider 已配置完成。
故障排查
| 问题 | 检查项 |
|---|---|
| 认证失败 | 确认 key 已正确复制，并已导出为 FELO_API_KEY |
| 工具调用了错误的 provider | 检查当前 workspace 或 session 是否已选择 Felo provider |
| Base URL 错误 | OpenAI-compatible 客户端使用 https://openapi.felo.ai/api/v1，Anthropic-compatible 客户端使用 https://openapi.felo.ai/api |
| 找不到模型 | 选择一个出现在 Felo 模型列表中的模型 |
| 工具忽略本地配置 | 如果客户端要求用户级配置，请把 provider 设置移到用户级配置中 |