Skip to main content
Configure Codex CLI, OpenAI’s open-source local coding agent, to use Eden AI for access to 500+ models behind a single API key.

​
Overview

Codex CLI runs in your terminal and edits code in your project. Pointing it at Eden AI gives you:
  • 500+ models: switch between Codex variants, Claude, Gemini, and more without reinstalling
  • One API key: unified billing and monitoring across providers
  • Provider failover: keep working when an upstream provider has an incident

​
Prerequisites

​
Setup

​
1. Configure ~/.codex/config.toml

Codex CLI reads its provider settings from ~/.codex/config.toml. Add an edenai provider and point Codex at it:

​
2. Export your API key

To make it permanent, add the export line to ~/.bashrc or ~/.zshrc and reload your shell.

​
3. Launch Codex

Codex now sends requests to Eden AI using the model you set in config.toml.

​
Switching models

Eden AI uses the provider/model format. Update the model field in ~/.codex/config.toml (or pass --model on the command line) to switch:
Browse the full catalog via List Models or GET https://api.edenai.run/v3/models.

​
Expert Models as Tools (MCP)

Eden AI also hosts an MCP server that exposes the expert model catalog (OCR, web search, speech, translation and more) as tools. Add it to ~/.codex/config.toml:
Codex reads EDENAI_API_KEY from the environment at connect time and sends it as an Authorization: Bearer header, which keeps the key out of a config file that may be committed. The CLI equivalent is:
See the MCP server page for the full tool catalog and the conventions its tools share.

​
Troubleshooting

​
Authentication errors

Verify the API key is loaded in your shell and that it has LLM access:

​
Model not found

Use the full provider/model string (e.g. openai/gpt-5.1-codex, not gpt-5.1-codex). Confirm the ID is in the catalog returned by GET /v3/models.

​
Connection issues

Confirm base_url is exactly https://api.edenai.run/v3 — Codex appends /chat/completions itself. Check Eden AI status at app-edenai.instatus.com.

​
Next Steps

  • Claude Code — Anthropic’s official CLI on Eden AI
  • OpenCode — terminal coding agent with auto-generated config
  • Chat Completions — full reference for the underlying endpoint