CLI accepts `--model astra`, shows `astra high`, then reports misleading ChatGPT-account error
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 125k
- Forks
- 19.4k
- PR merge metrics
- PR metrics pending
Description
What version of Codex CLI is running?
0.155.0
What subscription do you have?
ChatGPT account (exact subscription tier is not exposed by the CLI)
Which model were you using?
astra (user-facing name passed to --model; canonical ID is gpt-6-astra)
What platform is your computer?
Darwin 25.6.0 arm64 arm
What terminal emulator and version are you using (if applicable)?
Ghostty 1.3.1
Codex doctor report
Relevant sanitized fields: Codex 0.155.0; standalone macos-aarch64 installation; ChatGPT authentication; config loaded successfully; installation consistent. Full report omitted because it contains local filesystem paths unrelated to this reproduction.
What issue are you seeing?
The CLI accepts the user-facing model name astra as a raw model identifier and opens normally. The TUI header then displays astra high, which reinforces that the selection is valid.
On the first prompt, Codex prints:
Model metadata for 'astra' not found. Defaulting to fallback metadata; this can degrade performance and cause issues.
It then returns HTTP 400:
The 'astra' model is not supported when using Codex with a ChatGPT account.
The canonical model ID documented for the CLI is gpt-6-astra. The current behavior makes a bad model identifier look like an account-entitlement problem.
What steps can reproduce the bug?
- Sign in to Codex using a ChatGPT account.
- Run
codex --model astra. - Observe that the TUI opens and its header says
astra high. - Submit any prompt, such as
test. - Observe the fallback-metadata warning followed by the 400 account-support error.
The exact-error search in this repository returned no existing issue.
What is the expected behavior?
Codex should either:
- resolve the user-facing alias
astratogpt-6-astra; or - reject the unknown model before opening the session and suggest
gpt-6-astra.
The header should not present an unknown, fallback-metadata model as a valid selection, and the error should distinguish an invalid model ID from a subscription-access problem.
Additional information
The attached screenshot is redacted and shows the launch command, the astra high header, the metadata warning, and the 400 response.
Closest related report checked: #45408 uses the canonical gpt-6-astra ID and concerns a client-version/model-catalog rollout mismatch. This report concerns acceptance of the noncanonical astra name and the resulting misleading account-entitlement error.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start at the CLI's --model handling and follow how the selected name reaches model metadata lookup, TUI header rendering, and the first prompt request. Reproduce with codex --model astra; done means astra is resolved to gpt-6-astra or rejected before the session with a clear invalid-model message, rather than an account-entitlement error.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- rust
- Domain
- cli
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 58/100