Question: How do I enable Codex and Claude

seb · 2026-05-23

As above; apologies if this has been addressed. I have set up Claude as my default but would like to introduce Codex into the mix. I can't seem to find it anywhere . Appreciate everyone's help

Answers

Aron Prins · 2026-05-23

Hey seb — Codex isn't enabled at the company level like a "default provider." In Paperclip it's a per-agent adapter called codexlocal. You set it on each agent you want running Codex, not globally.

Quick setup:

Open the agent's detail page → Configuration tab. In the Adapter dropdown, pick codexlocal. Set the model (e.g. gpt-5.3-codex or gpt-5.4) and cwd (working directory). Under Environment variables, add OPENAIAPIKEY. You can leave your ANTHROPICAPIKEY set too — it won't conflict. Hit Test Environment. It checks that the Codex CLI is installed, the cwd is usable, and auth works. Fix anything that fails before saving. Save → Run Heartbeat to confirm.

Prereqs: the Codex CLI has to be installed and runnable on the host where Paperclip lives. If Test Environment complains about the command not being found, that's the thing to fix first.

You can mix adapters — e.g. CEO on claudelocal, workers on codexlocal. The guide "Claude vs Codex as a Worker" (under Guides → Adapters) covers when to pick which, and the Codex Local doc has the full field reference.