{"name":"CLAUDE_CODE_GATEWAY_HINT_HEADERS","slug":"claude-code-gateway-hint-headers","family":"env","title":"Environment variables","noun":"environment variable","description":"Set to `1` to send the [gateway hint headers](\/docs\/en\/llm-gateway-protocol#gateway-hint-headers), such as `x-claude-code-request-class` and `x-claude-code-compaction`, on a custom proxy or a third-party provider such as Amazon Bedrock or Claude Platform on AWS. Set to `0` to stop sending them on every connection, including a direct connection to the Anthropic API, where Claude Code sends them by default. Requires Claude Code v2.1.273 or later","description_source":"docs","described_by":{"doc":"claude-code\/env-vars","title":"Environment variables"},"presence":{"first_seen":"2.1.273","removed_in":null,"in_current_build":true,"newest_mined":"2.1.319","builds":43,"mined_builds":159,"first_cited":null},"aliases":[],"entries":[{"version":"2.1.283","anchor":"new-x-claude-code-prompt-id-request-header-behind-the-gatew","heading":"Requests can now carry a prompt id header for gateways","line":"API requests can carry a new `x-claude-code-prompt-id` header naming the prompt behind them, under the same rule as other gateway hint headers","released_at":"2026-09-25 18:46:11","reason":"found in this entry's text"},{"version":"2.1.273","anchor":"new-gate-for-gateway-hint-headers-on-first-party-surfaces","heading":"New gate for gateway hint headers on first-party surfaces","line":"A new internal check decides when Claude Code sends extra gateway hint headers on first-party requests","released_at":"2026-09-15 18:06:34","reason":"found in this entry's text, named in this entry"}],"entries_total":2,"docs":[{"source":"claude-code","path":"env-vars","title":"Environment variables","documented":true},{"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":3,"gates":[],"related":[{"name":"CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS","slug":"claude-code-gateway-model-discovery-timeout-ms","description":"Timeout in milliseconds for the [gateway model discovery](\/docs\/en\/llm-gateway-protocol#model-discovery) request that `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` turns on (default: `3000`). Raise it when your gateway needs longer than three seconds to answer `\/v1\/models` at startup. Takes plain digits only; `0`, negative values, and other spellings keep the default. Requires Claude Code v2.1.269 or later"},{"name":"CLAUDE_CODE_GATEWAY_TOKEN_FILE_DESCRIPTOR","slug":"claude-code-gateway-token-file-descriptor","description":"Auth tokens can now be handed to subprocesses over file descriptors instead of plaintext environment variables."}],"url":"https:\/\/changelogs.core-directive.com\/reference\/env\/claude-code-gateway-hint-headers","family_url":"https:\/\/changelogs.core-directive.com\/reference\/env.json"}