{"name":"CLAUDE_CODE_REMOTE","slug":"claude-code-remote","family":"env","title":"Environment variables","noun":"environment variable","description":"Remote sessions started from review can skip writing some state to disk.","description_source":"entry","described_by":{"version":"2.1.221","anchor":"review-origin-remote-sessions-skip-some-disk-persistence"},"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.70","released_at":"2026-03-06 00:09:06","spans":9}},"aliases":[],"entries":[{"version":"2.1.307","anchor":"new-hidden-runner-declares-flag-lets-a-self-hosted-runner","heading":"Hidden option lets a self-hosted runner declare what it can handle","line":"A hidden --runner-declares option lets a self-hosted runner tell Claude Code it handles changes found in nested repositories","released_at":"2026-10-21 20:47:18","reason":"found in this entry's text"},{"version":"2.1.307","anchor":"runner-env-vars-claude-runner-update-bin-and-claude-runner-a","heading":"Two runner environment variables join Claude Code's remote session lists","line":"Claude Code now treats `CLAUDE_RUNNER_UPDATE_BIN` and `CLAUDE_RUNNER_ACTIVITY_FD` like its other remote session variables","released_at":"2026-10-21 20:47:18","reason":"found in this entry's text"},{"version":"2.1.307","anchor":"artifacts-off-setting-now-drops-artifacts-mcp-servers-in-rem","heading":"Turning Artifacts off now disconnects the Artifacts server in remote sessions","line":"In Claude Code Remote sessions, turning Artifacts off in settings now skips any MCP server that connects to the Artifacts server","released_at":"2026-10-21 20:47:18","reason":"named in this entry, found in this entry's text"},{"version":"2.1.307","anchor":"artifacts-mcp-server-can-be-filtered-out-by-a-new-gate-with","heading":"Remote sessions can leave out the Artifacts server when Artifacts are off","line":"In Claude Code Remote, servers that connect to Artifacts are not connected when Artifacts are turned off in settings","released_at":"2026-10-21 20:47:18","reason":"found in this entry's text"},{"version":"2.1.306","anchor":"well-known-credential-files-are-now-read-without-claude-code","heading":"Credential files at the standard path are now read in local sessions too","line":"Claude Code can now read a token from its well-known credential file even when CLAUDE_CODE_REMOTE is not set; saving and deleting those files still need it","released_at":"2026-10-21 02:28:47","reason":"found in this entry's text"},{"version":"2.1.305","anchor":"mcp-tasks-cloud-container-hold-capped-by-tengu-curious-rive","heading":"Long-running MCP tasks in cloud sessions stop holding the container up after a time limit","line":"In Anthropic cloud sessions, a running MCP task stops keeping its cloud container up after a set number of hours, 168 by default","released_at":"2026-10-20 19:29:36","reason":"found in this entry's text"},{"version":"2.1.305","anchor":"timeout-helper-ignores-zero-or-negative-override","heading":"A timeout ignores override values of zero or less","line":"A timeout override is now used only if it is above zero; otherwise the default of 2 minutes in remote sessions or 5 minutes elsewhere applies","released_at":"2026-10-20 19:29:36","reason":"found in this entry's text"},{"version":"2.1.305","anchor":"cloud-only-mcp-host-allowdeny-list-via-tengu-gleaming-creek","heading":"Cloud sessions can allow or block MCP servers by host","line":"In Anthropic cloud sessions, Claude Code can check each MCP server's host against an allow or deny list sent by the server","released_at":"2026-10-20 19:29:36","reason":"found in this entry's text"},{"version":"2.1.305","anchor":"remote-credential-file-read-now-requires-claude-code-remote","heading":"Token file is only read when CLAUDE_CODE_REMOTE is set","line":"Claude Code now reads a token from its well-known file only when the `CLAUDE_CODE_REMOTE` environment variable is set","released_at":"2026-10-20 19:29:36","reason":"found in this entry's text, named in this entry"},{"version":"2.1.305","anchor":"set-model-errors-split-into-finer-reason-codes","heading":"Failed model changes now report a more specific reason","line":"When a controlling program's request to change the model fails, Claude Code now reports a finer reason, such as rate limit or failed sign-in","released_at":"2026-10-20 19:29:36","reason":"found in this entry's text"}],"entries_total":138,"docs":[{"source":"api","path":"api\/compliance\/organizations","title":"Organizations","documented":false},{"source":"api","path":"api\/compliance\/organizations\/settings","title":"Settings","documented":false},{"source":"api","path":"api\/compliance\/organizations\/settings\/retrieve","title":"Get effective organization settings","documented":false},{"source":"claude-code","path":"cloud-environments","title":"Configure cloud environments","documented":false},{"source":"claude-code","path":"env-vars","title":"Environment variables","documented":false},{"source":"claude-code","path":"hooks","title":"Hooks reference","documented":false},{"source":"claude-code","path":"monitoring-usage","title":"Monitoring","documented":false},{"source":"claude-code","path":"self-hosted-environments-configuration","title":"Customize sessions in self-hosted environments","documented":false},{"source":"claude-code","path":"self-hosted-environments-testing","title":"Test self-hosted environments end to end","documented":false},{"source":"claude-code","path":"settings","title":"Claude Code settings","documented":false}],"docs_total":11,"gates":[],"related":[{"name":"CLAUDE_CODE_3P_PROBE_WROTE_HAIKU_DEFAULT","slug":"claude-code-3p-probe-wrote-haiku-default","description":"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"},{"name":"CLAUDE_CODE_3P_PROBE_WROTE_OPUS_DEFAULT","slug":"claude-code-3p-probe-wrote-opus-default","description":"Internal marker on third-party providers. When Claude Code itself writes `ANTHROPIC_DEFAULT_OPUS_MODEL` into its environment (the model availability probe on Bedrock, Vertex or Mantle, or a move down the model fallback ladder), it sets this variable to the same model ID. An `ANTHROPIC_DEFAULT_OPUS_MODEL` equal to it is treated as Claude Code's own choice rather than a user pin: it does not count as pinned, the probe does not skip it, and the fallback ladder may move it."},{"name":"CLAUDE_CODE_3P_PROBE_WROTE_SONNET_DEFAULT","slug":"claude-code-3p-probe-wrote-sonnet-default","description":"On third-party providers, Haiku model names are no longer skipped by the check that sets up the Sonnet default model"},{"name":"CLAUDE_CODE_3P_SEEDED_OPUS_DEFAULT","slug":"claude-code-3p-seeded-opus-default","description":"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"},{"name":"CLAUDE_CODE_3P_SEEDED_SONNET_DEFAULT","slug":"claude-code-3p-seeded-sonnet-default","description":"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"},{"name":"CLAUDE_CODE_ACCESSIBILITY","slug":"claude-code-accessibility","description":"Set to `1` to keep the native terminal cursor visible and disable the inverted-text cursor indicator. Allows screen magnifiers like macOS Zoom to track cursor position"},{"name":"CLAUDE_CODE_ACCOUNT_TAGGED_ID","slug":"claude-code-account-tagged-id","description":"Overrides the `user.account_id` attribute Claude Code attaches to its OpenTelemetry data. It applies only when an account UUID is known and `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` is not turned off (default on); when unset or empty, `user.account_id` is derived from the account UUID as a tagged ID of the form `user_01...`."},{"name":"CLAUDE_CODE_ACCOUNT_UUID","slug":"claude-code-account-uuid","description":"The device bridge is skipped entirely when the host's account UUID doesn't match the stored one."},{"name":"CLAUDE_CODE_ACT_DONT_REDERIVE","slug":"claude-code-act-dont-rederive","description":"Three existing feature gates moved position; their defaults are unchanged."},{"name":"CLAUDE_CODE_ACTION","slug":"claude-code-action","description":"Marks a run as coming from the Claude Code GitHub Action. A truthy value (`1`, `true`, `yes` or `on`) makes Claude Code set `CLAUDE_CODE_ENTRYPOINT` to `claude-code-github-action`, but only when `CLAUDE_CODE_ENTRYPOINT` is not already set and the command is not `claude mcp serve`. It is also reported as `isClaudeCodeAction` in the environment details attached to telemetry."}],"url":"https:\/\/changelogs.core-directive.com\/reference\/env\/claude-code-remote","family_url":"https:\/\/changelogs.core-directive.com\/reference\/env.json"}