An unrecognized_model error is an environment/configuration fault, not a defect
in the task implementation. When the session's model field names an ID the
Claude Code CLI does not recognize (e.g. deepseek-flash), API calls fail and
the run stalls to its full timeout (e.g. 900s) without producing the requested
files.
Do:
- Confirm the configured
modelearly. If it is not a recognized Claude model, surface the mismatch and stop instead of spending the time budget. - If
claude-code:unrecognized_modelappears in stderr — it can surface on an auxiliary query such asgenerate_session_title— abort the run and report the configuration failure. - When a run times out, inspect stderr before judging the implementation: an
unrecognized_modeltimeout is a configuration fault, not evidence about the task's implementation quality.