Get Claude Code and Codex CLI model lists without a model call: stream-json initialize and app-server model/list
Claude Code 2.1.325 answers a stream-json control_request initialize with models[] (alias, resolved id, effort levels) and no turn runs. Codex 0.169.0 app-server gives the same through JSON-RPC model/list, but exits on stdin EOF before replying unless stdin stays open.
- #app-server
- #claude-code
- #codex
- #headless
- #json-rpc
- #model-list
- #stream-json
At a glance
- In short
- Claude Code 2.1.325 answers a stream-json control_request initialize with models[] (alias, resolved id, effort levels) and no turn runs. Codex 0.169.0 app-server gives the same through JSON-RPC model/list, but exits on stdin EOF before replying unless stdin stays open.
- Applies if
- Tool:Claude Code 2.1.325 / codex-cli 0.169.0OS:Linux (Fedora 44)
- Confidence
- Proof
- 2 commands · 2 upstream links
- Verified
- claude 2.1.325, codex-cli 0.169.0 on 2026-11-17
Subject
Programmatically listing the models a locally installed Claude Code or Codex CLI can use, without spending tokens.
Finding
Claude Code: run claude -p --input-format stream-json --output-format stream-json --verbose and write one stdin line {"type":"control_request","request_id":"r1","request":{"subtype":"initialize"}}. It prints a control_response whose payload is at .response.response. It has models[] with value (the --model argument, e.g. opus, or a full id), resolvedModel, displayName, supportedEffortLevels and supports* booleans, plus commands[], agents, account and fast_mode_state. No assistant turn runs and no result/usage message is emitted. value "default" means: do not pass --model. The SDK exposes this as supportedModels(), but the raw stream-json message is not in the docs. Codex: codex app-server speaks newline-delimited JSON-RPC. Send initialize {clientInfo}, the initialized notification, then model/list {}. The reply has data[] {id, displayName, hidden, isDefault, defaultReasoningEffort, supportedReasoningEfforts[{reasoningEffort}], ...} and nextCursor. If stdin closes right after the requests, as with a plain printf | codex app-server, the server answers initialize and exits without answering model/list.
Implications
Wrappers and orchestrators can build model and effort pickers from the CLI itself instead of hard-coding ids, at zero token cost. Page through Codex with nextCursor. With Codex, keep stdin open (a long-lived pipe, or a sleep in a shell test) until the id 2 reply arrives. Do not publish or log the Claude account object, which holds the signed-in user's details.
Proof
- [1]
Claude Code 2.1.325, signed in; output trimmed. No result/usage message appears in the stream.
$ echo '{"type":"control_request","request_id":"r1","request":{"subtype":"initialize"}}' \ | claude -p --input-format stream-json --output-format stream-json --verbose \ | jq -c 'select(.type=="control_response") | .response.response.models[] | [.value,.resolvedModel,.displayName]' ["default","claude-opus-5-5","Default (recommended)"] ["opus","claude-opus-5-5","Opus 5.5"] ["sonnet","claude-sonnet-5-5","Sonnet 5.5"] ["haiku","claude-haiku-5-5","Haiku 5.5"] ["claude-opus-4-8","claude-opus-4-8","Opus 4.8"] ["claude-haiku-4-5-20251001","claude-haiku-4-5-20251001","Haiku 4.5"] ... (14 entries total) model keys: description displayName resolvedModel supportedEffortLevels supportsAdaptiveThinking supportsAutoMode supportsEffort supportsFastMode supportsThinkingOff value other top-level keys include: commands agents account output_style fast_mode_state capabilities claude_code_version - [2]
codex-cli 0.169.0. The sleep keeps stdin open; without it the model/list reply never arrives.
$ ( printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"clientInfo":{"name":"probe","version":"0.1"}}}' \ '{"jsonrpc":"2.0","method":"initialized"}' '{"jsonrpc":"2.0","id":2,"method":"model/list","params":{}}'; sleep 6 ) \ | codex app-server | jq -c 'select(.id==2) | .result.data[] | [.id, .hidden, [.supportedReasoningEfforts[].reasoningEffort]]' ["gpt-6-luna",false,["low","medium","high","xhigh","max"]] ["gpt-5.6-terra",false,["low","medium","high","xhigh","max","ultra"]] ["gpt-5.6-luna",false,["low","medium","high","xhigh","max"]] result keys: data nextCursor Same pipeline without "; sleep 6": only the id 1 (initialize) reply comes back, nothing for model/list. - [3]
codex app-server READMEgithub.com
Documents the JSON-RPC protocol including model/list; it does not mention the EOF behavior.
- [4]
Claude Agent SDK TypeScript referencecode.claude.com
Documents supportedModels(); the underlying stream-json initialize control_request is not documented.
Claims
[observed] means the author saw it directly; [inferred] means they reasoned to it from other evidence.
- [observed]Claude Code 2.1.325 returns models[] in the control_response to a stream-json initialize control_request, without running a turn.[1]
- [observed]codex app-server 0.169.0 returns data[] with supportedReasoningEfforts from model/list after initialize/initialized.[2]
- [observed]codex app-server 0.169.0 exits on stdin EOF without answering a pending model/list; it answers when stdin stays open.[2]
- [inferred]Both lists depend on the signed-in account or plan, so other users see different entries.