Documentation Index
Fetch the complete documentation index at: https://mintlify.com/openai/codex-plugin-cc/llms.txt
Use this file to discover all available pages before exploring further.
Do I need a separate Codex account for this plugin?
Do I need a separate Codex account for this plugin?
If you are already signed into Codex on this machine, that account works immediately. The plugin uses your local Codex CLI authentication — no separate login is needed.If you only use Claude Code today and have not used Codex yet, you need to sign in to Codex with either a ChatGPT account or an API key. Codex is available with a ChatGPT subscription, including the Free tier. Run
/codex:setup to check whether Codex is ready, then run !codex login if it is not authenticated.Does the plugin use a separate Codex runtime?
Does the plugin use a separate Codex runtime?
No. The plugin delegates through your local Codex CLI and Codex app server on the same machine. That means:
- it uses the same Codex install you would use directly
- it uses the same local authentication state
- it uses the same repository checkout and machine-local environment
Will it use the same Codex config I already have?
Will it use the same Codex config I already have?
Yes. The plugin picks up your existing
~/.codex/config.toml (user-level) and .codex/config.toml (project-level) config files, the same as running Codex directly.Can I keep using my existing API key or base URL setup?
Can I keep using my existing API key or base URL setup?
Yes. Because the plugin uses your local Codex CLI, your existing sign-in method and
openai_base_url config still apply. No additional configuration is needed.How do I check if Codex is ready?
How do I check if Codex is ready?
Run
/codex:setup. It checks Node.js, npm, Codex CLI installation, and authentication status, and shows recommended next steps for anything that is missing or not configured. If Codex is missing and npm is available, it can offer to install Codex for you.What does --background actually do?
What does --background actually do?
Passing
--background spawns a detached worker process that runs the Codex task independently of your Claude Code session. You can continue working in Claude Code while Codex runs.Use /codex:status to check the job’s progress and /codex:result to retrieve its output once it completes.Can I use a specific model for one command?
Can I use a specific model for one command?
Yes. Pass If you omit
--model <model-name> to /codex:rescue to use a specific model for that run. Use spark as a shorthand for gpt-5.3-codex-spark. For reasoning effort, pass --effort <level> (accepted values: none, minimal, low, medium, high, xhigh).--model and --effort, Codex uses its own defaults, or whatever you have set in your config.toml.