Local Codex lets Leafage generate images through the ChatGPT plan active on your Mac without using Leafage credits. Hosted models still work with credits when Codex is unavailable.
Check the status in Leafage
Open Settings > Codex and look at Local Codex. Leafage checks the Codex app and common standalone CLI locations.
Click Check Codex again after installing, updating, or signing in to Codex.
Codex is not installed
Install the Codex desktop app or standalone Codex CLI from OpenAI, open it, and sign in. Return to Leafage after the Codex setup works on the same Mac.
Leafage can use the CLI bundled inside the Codex desktop app, so a failed codex --version command in Terminal does not prove the app connection is missing. Trust the status shown in Leafage.
Codex is installed but signed out
Open Codex and sign in with the ChatGPT account whose plan you want to use. A successful sign-in does not guarantee generation capacity; OpenAI applies the plan’s current availability and fair-usage terms.
If you installed the standalone CLI, these commands can help:
codex login
codex login statusCodex uses a custom path
If Codex works in Terminal but Leafage cannot find it, run:
which codexCopy the returned path, open Settings > Codex, click Change, and enter the path under Custom path. Leave the field blank to return to automatic detection.
Codex is ready but generation fails
OpenAI may reject a request because the account needs authentication, has reached a usage limit, or cannot use the requested feature. Try a small image generation in Codex itself.
You can also select an enabled hosted model in Leafage. Hosted generation uses Leafage credits and does not depend on your local Codex session.
Contact support
Send support your macOS version, Leafage version, the Local Codex status, and the output of codex --version, codex login status, and which codex when those commands work. Do not send Codex credentials or session tokens.