AI Tool Setup
Codex
Configure Codex CLI with a Felo custom model provider.
Use this guide when you want Codex CLI to use Felo API Platform for model calls while keeping the normal Codex terminal workflow.
Before You Start
You need one Felo API Platform key. The same key works across model protocols, agent clients, Search, Web Fetch, PPT, Mindmap, LiveDocs, X Search, YouTube Subtitling, Landing Page, and SuperAgent APIs.
export FELO_API_KEY="YOUR_API_KEY"Recommended Setup
| Item | Value |
|---|---|
| Best for | CLI coding workflows, code review, repo changes, and non-interactive automation |
| Protocol | OpenAI-compatible Responses API |
| Base URL | https://openapi.felo.ai/api/v1 |
| Model example | gpt-5.6-sol |
| API key | Your FELO_API_KEY |
Configure Codex
Set the environment variables first:
export FELO_API_KEY="YOUR_API_KEY"User-level Codex config
Add a Felo provider to your user-level Codex configuration at ~/.codex/config.toml.
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 settings should live in the user-level config. Do not put API keys in project files.
For a non-interactive check, run:
codex exec --model gpt-5.6-sol "Review this repository and list the main files"Verify the Setup
Run a small task after saving the configuration:
codex --model gpt-5.6-solIf the tool starts and answers with the selected model, the provider setup is ready.
Troubleshooting
| Issue | What to check |
|---|---|
| Authentication fails | Confirm the key is copied correctly and exported as FELO_API_KEY |
| Tool calls the wrong provider | Check that the Felo provider is selected for the current workspace or session |
| Base URL error | Use https://openapi.felo.ai/api/v1 for OpenAI-compatible clients and https://openapi.felo.ai/api for Anthropic-compatible clients |
| Model not found | Choose a model that appears in your Felo model list |
| The tool ignores local config | Move provider settings to the user-level config if the client requires it |