{"name":"ANTHROPIC_DEFAULT_HAIKU_MODEL","slug":"anthropic-default-haiku-model","family":"env","title":"Environment variables","noun":"environment variable","description":"Model ID that the `haiku` alias resolves to, also used for [background functionality](\/docs\/en\/costs#background-token-usage). See [Model configuration](\/docs\/en\/model-config#environment-variables)","description_source":"docs","described_by":{"doc":"claude-code\/env-vars","title":"Environment variables"},"presence":{"first_seen":"2.1.138","removed_in":null,"in_current_build":true,"newest_mined":"2.1.308","builds":149,"mined_builds":149,"first_cited":{"version":"2.1.261","released_at":"2026-09-04 17:49:34","spans":3}},"aliases":[],"entries":[{"version":"2.1.296","anchor":"prompt-hooks-always-use-the-default-small-model","heading":"Prompt hooks no longer pick the main model on gateway setups","line":"Prompt hooks now use their own configured model or the default small model, without a gateway special case","released_at":"2026-10-09 16:58:10","reason":"found in this entry's text"},{"version":"2.1.295","anchor":"gateway-provider-falls-back-to-a-gateway-default-model-when","heading":"Gateway users without a small model set fall back to the default model","line":"With a gateway provider and no Haiku-class model set, hooks use the main model and failed side requests retry on the default","released_at":"2026-10-08 18:22:58","reason":"found in this entry's text"},{"version":"2.1.285","anchor":"third-party-model-env-vars-haiku-handled-like-opussonnet","heading":"Cloud accounts fall back to another model when one is not enabled","line":"If your cloud account cannot use a model, Claude Code can step down to the next one; `CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK` turns this off","released_at":"2026-09-29 17:32:09","reason":"found in this entry's text"},{"version":"2.1.285","anchor":"haiku-joins-the-3p-default-model-probeseed-tracking","heading":"A Haiku model that Claude Code picked for you no longer counts as your choice","line":"On third-party providers, a Haiku model Claude Code set itself is no longer treated as one you set in `ANTHROPIC_DEFAULT_HAIKU_MODEL`","released_at":"2026-09-29 17:32:09","reason":"found in this entry's text, named in this entry"},{"version":"2.1.283","anchor":"disable-prompt-caching-haiku-now-matches-the-configured-haik","heading":"DISABLE_PROMPT_CACHING_HAIKU now matches your configured Haiku model","line":"`DISABLE_PROMPT_CACHING_HAIKU` now also turns off caching for any request whose model resolves to the configured Haiku model","released_at":"2026-09-25 18:46:11","reason":"found in this entry's text"},{"version":"2.1.261","anchor":"bedrock-count-tokens-fallback-no-longer-uses-haiku-probe","heading":"Bedrock count_tokens fallback no longer uses Haiku probe","line":"Bedrock token counting fallback now uses your own model instead of a Haiku probe.","released_at":"2026-09-04 17:49:34","reason":"found in this entry's text, named in this entry"},{"version":"2.1.227","anchor":"bedrock-and-vertex-share-one-stale-model-check","heading":"Bedrock and Vertex share one stale-model check","line":"Bedrock and Vertex now share one check for outdated pinned model variables.","released_at":"2026-08-10 20:56:57","reason":"found in this entry's text"},{"version":"1.0.114","anchor":"environment-variable-support-for-default-haiku-model","heading":"Environment Variable Support for Default Haiku Model","line":null,"released_at":"2025-09-15 21:08:05","reason":"found in this entry's text"}],"entries_total":8,"docs":[{"source":"claude-code","path":"env-vars","title":"Environment variables","documented":true},{"source":"claude-code","path":"agent-view","title":"Manage multiple agents with agent view","documented":false},{"source":"claude-code","path":"amazon-bedrock","title":"Claude Code on Amazon Bedrock","documented":false},{"source":"claude-code","path":"changelog","title":"Claude Code changelog","documented":false},{"source":"claude-code","path":"claude-platform-on-aws","title":"Claude Code on Claude Platform on AWS","documented":false},{"source":"claude-code","path":"goal","title":"Keep Claude working toward a goal","documented":false},{"source":"claude-code","path":"google-vertex-ai","title":"Claude Code on Google Cloud's Agent Platform","documented":false},{"source":"claude-code","path":"llm-gateway-connect","title":"Connect Claude Code to an LLM gateway","documented":false},{"source":"claude-code","path":"llm-gateway-protocol","title":"Claude Code gateway compatibility guide","documented":false},{"source":"claude-code","path":"llm-gateway-rollout","title":"Roll out an LLM gateway for your organization","documented":false}],"docs_total":13,"gates":[],"related":[{"name":"ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION","slug":"anthropic-default-haiku-model-description","description":"Display description for the pinned Haiku model in the `\/model` picker. When not set, the row shows a default description that begins `Custom Haiku model`. See [Model configuration](\/docs\/en\/model-config#customize-pinned-model-display-and-capabilities)"},{"name":"ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME","slug":"anthropic-default-haiku-model-name","description":"Display name for the pinned Haiku model in the `\/model` picker. When not set, the row shows the model's name if Claude Code recognizes the pinned ID, and the pinned ID otherwise. See [Model configuration](\/docs\/en\/model-config#customize-pinned-model-display-and-capabilities)"}],"url":"https:\/\/changelogs.core-directive.com\/reference\/env\/anthropic-default-haiku-model","family_url":"https:\/\/changelogs.core-directive.com\/reference\/env.json"}