Integrations
Codex CLI
Connect XEDOC through the Responses API and keep your terminal workflow.
Use Codex with an independent API gateway
#This guide connects Codex to the XEDOC API as a custom model provider. Codex sends Responses API requests to https://api.xedoc.top/v1 using your XEDOC API key. An XEDOC account, enabled API access and enough available token balance are required for generation.
XEDOC is an independent service, not the official OpenAI API and not affiliated with OpenAI. Compatibility depends on the selected model and endpoint; an OpenAI or ChatGPT subscription does not provide XEDOC token credit.
For direct application requests instead of the Codex client, follow the API reference. Check model IDs and multipliers and token pricing before generating.
Connect automatically
#Install Node.js 20 or later, fully quit the selected client, and run this command. The assistant checks your key, shows the files it will update, and saves a private backup before applying changes.
npx.cmd --yes https://xedoc.top/downloads/xedoc-setup-1.0.1.tgz --clients codex-clinpx --yes https://xedoc.top/downloads/xedoc-setup-1.0.1.tgz --clients codex-clinpx --yes https://xedoc.top/downloads/xedoc-setup-1.0.1.tgz --clients codex-cliStart the XEDOC profile
#codex --profile xedocUse /model to select a model and reasoning level. The assistant creates a catalog from XEDOC’s current model list, so canonical Claude and DeepSeek IDs can appear alongside GPT models.
Configure manually
#Create xedoc.config.toml in your Codex configuration directory: %USERPROFILE%\.codex on Windows, or ~/.codex on macOS/Linux. If CODEX_HOME is set, use that directory. Separate profile files require Codex 0.134 or later.
model = "gpt-5.6-terra"
model_provider = "xedoc"
[model_providers.xedoc]
name = "XEDOC"
base_url = "https://api.xedoc.top/v1"
env_key = "XEDOC_API_KEY"
wire_api = "responses"$env:XEDOC_API_KEY = "sk-xedoc-YOUR_KEY"
codex --profile xedocexport XEDOC_API_KEY="sk-xedoc-YOUR_KEY"
codex --profile xedocexport XEDOC_API_KEY="sk-xedoc-YOUR_KEY"
codex --profile xedocCustom model picker
xedoc-models.json and sets model_catalog_json. With the minimal manual profile, choose a known model explicitly using codex --profile xedoc -m claude-opus-5.Keep your existing configuration
#CLI-only automatic setup leaves the global config.toml and other providers in place. If you also select Codex App, XEDOC becomes the active provider in the shared global configuration. Existing explicit context or compaction settings can override model catalog defaults.
Reference: Codex configuration.