An entry is only as true as the day it was written.
Flags move on the server after a release ships. Anthropic's own notes land days later and their documentation later still. Sometimes an entry turns out to be wrong and gets corrected by hand. All of that is recorded against the entry it happened to, and this is the whole of it in the order it happened.
Nothing here replaces an entry. Every line links to the page its release published, still saying what that release said, because a correction is added and dated rather than swapped in.
| When | Entry | What happened |
|---|---|---|
v2.1.248claude remote-control |
Documentation arrivedA small documentation edit on Continue local sessions from any device with Remote Control touched a line naming claude remote-control after this was published.
the line in the docsAll traffic travels through the Anthropic API over TLS, the same transport security as any Claude Code session. The connection uses multiple short-lived credentials, each scoped to a single purpose and expiring independently. When a `claud… |
|
v2.1.257max |
Documentation arrivedAnthropic's documentation has since written up max, on Model configuration.
the line in the docsFrontmatter effort applies when that skill or subagent is active, overriding the session level but not the environment variable. A [`maxEffortLevel`](/docs/en/settings-reference#maxeffortlevel) or [organization effort cap](#organization-ef… |
|
v2.1.257max |
Documentation arrivedAnthropic's documentation has since written up max, on Model configuration.
the line in the docsFrontmatter effort applies when that skill or subagent is active, overriding the session level but not the environment variable. A [`maxEffortLevel`](/docs/en/settings-reference#maxeffortlevel) or [organization effort cap](#organization-ef… |
|
v2.1.248max |
Documentation arrivedAnthropic's documentation has since written up max, on Model configuration.
the line in the docsFrontmatter effort applies when that skill or subagent is active, overriding the session level but not the environment variable. A [`maxEffortLevel`](/docs/en/settings-reference#maxeffortlevel) or [organization effort cap](#organization-ef… |
|
v2.1.229mode |
Documentation arrivedAnthropic's documentation has since written up mode, on Model configuration.
the line in the docs* The model doesn't support `xhigh` effort |
|
v2.1.257ultracode |
Documentation arrivedAnthropic's documentation has since written up ultracode, on Model configuration.
the line in the docs<span id="when-ultracode-is-available" /> |
|
v2.1.248/workflows |
Documentation arrivedAnthropic's documentation has since written up /workflows, on Model configuration.
the line in the docs* [Workflows are turned off](/docs/en/workflows#turn-workflows-off) |
|
v2.1.248high |
Documentation arrivedAnthropic's documentation has since written up high, on Model configuration.
the line in the docs* The model doesn't support `xhigh` effort |
|
v2.1.248workflows |
Documentation arrivedAnthropic's documentation has since written up workflows, on Model configuration.
the line in the docs* [Workflows are turned off](/docs/en/workflows#turn-workflows-off) |
|
v2.1.239--effort |
Documentation arrivedAnthropic's documentation has since written up --effort, on Model configuration.
the line in the docsIn those cases `--effort ultracode` starts the session with ultracode off, at the highest effort level the model and any cap allow, up to `xhigh`. |
|
v2.1.257xhigh |
Documentation arrivedAnthropic's documentation has since written up xhigh, on Model configuration.
the line in the docs* The model doesn't support `xhigh` effort |
|
v2.1.257xhigh |
Documentation arrivedAnthropic's documentation has since written up xhigh, on Model configuration.
the line in the docs* The model doesn't support `xhigh` effort |
|
v2.1.257xhigh |
Documentation arrivedAnthropic's documentation has since written up xhigh, on Model configuration.
the line in the docs* The model doesn't support `xhigh` effort |
|
v2.1.248xhigh |
Documentation arrivedAnthropic's documentation has since written up xhigh, on Model configuration.
the line in the docs* The model doesn't support `xhigh` effort |
|
v2.1.239xhigh |
Documentation arrivedAnthropic's documentation has since written up xhigh, on Model configuration.
the line in the docs* The model doesn't support `xhigh` effort |
|
v2.1.242fallbacks |
Documentation arrivedAnthropic's documentation has since written up fallbacks, on Deploy managed settings.
the line in the docs`allowedHttpHookUrls` and `httpHookAllowedEnvVars` merge across settings files, so entries in your user, project, or local settings still apply while the managed list is empty. The fallbacks for those two keys and for `allowedChannelPlugin… |
|
v2.1.257allowedHttpHookUrls |
Documentation arrivedAnthropic's documentation has since written up allowedHttpHookUrls, on Deploy managed settings.
the line in the docs| `allowedHttpHookUrls` | Claude Code enforces an empty managed [allowlist](/docs/en/settings-reference#allowedhttphookurls) until you fix the value, so an HTTP hook runs only if another settings file lists its URL. If only an individual e… |
|
v2.1.239force |
Documentation arrivedAnthropic's documentation has since written up force, on Deploy managed settings.
the line in the docs| `allowedHttpHookUrls` | Claude Code enforces an empty managed [allowlist](/docs/en/settings-reference#allowedhttphookurls) until you fix the value, so an HTTP hook runs only if another settings file lists its URL. If only an individual e… |
|
v2.1.236file_path |
Documentation arrivedAnthropic's documentation has since written up file_path, on Error reference.
the line in the docsfile_path: the source file is not valid UTF-8 text (first invalid byte at line 12, column 40). It may be saved in another encoding or contain binary data. Rewrite it as UTF-8, then publish again. Nothing was published. |
|
v2.1.247/artifacts |
Documentation arrivedAnthropic's documentation has since written up /artifacts, on Error reference.
the line in the docsClaude tried to publish an [artifact](/docs/en/artifacts) from a file whose bytes don't decode as text, or whose text already contains the replacement character `U+FFFD`, so Claude Code refused the publish before uploading anything. The me… |
|
v2.1.246/artifacts |
Documentation arrivedAnthropic's documentation has since written up /artifacts, on Error reference.
the line in the docsClaude tried to publish an [artifact](/docs/en/artifacts) from a file whose bytes don't decode as text, or whose text already contains the replacement character `U+FFFD`, so Claude Code refused the publish before uploading anything. The me… |
|
v2.1.239/artifacts |
Documentation arrivedAnthropic's documentation has since written up /artifacts, on Error reference.
the line in the docsClaude tried to publish an [artifact](/docs/en/artifacts) from a file whose bytes don't decode as text, or whose text already contains the replacement character `U+FFFD`, so Claude Code refused the publish before uploading anything. The me… |
|
v2.1.236/artifacts |
Documentation arrivedAnthropic's documentation has since written up /artifacts, on Error reference.
the line in the docsClaude tried to publish an [artifact](/docs/en/artifacts) from a file whose bytes don't decode as text, or whose text already contains the replacement character `U+FFFD`, so Claude Code refused the publish before uploading anything. The me… |
|
v2.1.236/artifacts |
Documentation arrivedAnthropic's documentation has since written up /artifacts, on Error reference.
the line in the docsClaude tried to publish an [artifact](/docs/en/artifacts) from a file whose bytes don't decode as text, or whose text already contains the replacement character `U+FFFD`, so Claude Code refused the publish before uploading anything. The me… |
|
v2.1.234/artifacts |
Documentation arrivedAnthropic's documentation has since written up /artifacts, on Error reference.
the line in the docsClaude tried to publish an [artifact](/docs/en/artifacts) from a file whose bytes don't decode as text, or whose text already contains the replacement character `U+FFFD`, so Claude Code refused the publish before uploading anything. The me… |
|
v2.1.232artifact |
Documentation arrivedAnthropic's documentation has since written up artifact, on Error reference.
the line in the docsClaude tried to publish an [artifact](/docs/en/artifacts) from a file whose bytes don't decode as text, or whose text already contains the replacement character `U+FFFD`, so Claude Code refused the publish before uploading anything. The me… |
|
v2.1.265format |
Documentation arrivedAnthropic's documentation has since written up format, on Error reference.
the line in the docs* If the message asks you to convert the image, convert it to PNG, JPEG, GIF, or WebP and attach it again. Claude Code can verify dimensions for these formats from the file header, without decoding the image. |
|
v2.1.242replace |
Documentation arrivedAnthropic's documentation has since written up replace, on Error reference.
the line in the docs| `the source file has the replacement character U+FFFD` | [Tool errors](#the-source-file-is-not-valid-utf-8-text) | |
|
v2.1.229domain |
Documentation arrivedAnthropic's documentation has since written up domain, on Configure cloud environments.
the line in the docsSessions in this environment can now reach `api.example.com`, any subdomain of `internal.example.com`, and `registry.example.com`, and no other domains through the session's network. [GitHub traffic](#github-proxy), [MCP connector traffic]… |
|
v2.1.260hosted |
Documentation arrivedAnthropic's documentation has since written up hosted, on Configure cloud environments.
the line in the docs* **The Anthropic API and public package registries**: `api.anthropic.com`, `registry.npmjs.org`, `jsr.io`, `npm.jsr.io`, `pypi.org`, `files.pythonhosted.org`, `index.crates.io`, and `proxy.golang.org` |
|
v2.1.257max |
Documentation arrivedA small documentation edit on CLI reference touched a line naming max after this was published.
the line in the docs| `--effort` | Set the [effort level](/docs/en/model-config#adjust-effort-level) for the current session. Options: `low`, `medium`, `high`, `xhigh`, `max`, or `ultracode`. Available levels depend on the model. `ultracode` requests `xhigh` … |
|
v2.1.257max |
Documentation arrivedA small documentation edit on CLI reference touched a line naming max after this was published.
the line in the docs| `--effort` | Set the [effort level](/docs/en/model-config#adjust-effort-level) for the current session. Options: `low`, `medium`, `high`, `xhigh`, `max`, or `ultracode`. Available levels depend on the model. `ultracode` requests `xhigh` … |
|
v2.1.248max |
Documentation arrivedA small documentation edit on CLI reference touched a line naming max after this was published.
the line in the docs| `--effort` | Set the [effort level](/docs/en/model-config#adjust-effort-level) for the current session. Options: `low`, `medium`, `high`, `xhigh`, `max`, or `ultracode`. Available levels depend on the model. `ultracode` requests `xhigh` … |
|
v2.1.248medium |
Documentation arrivedA small documentation edit on CLI reference touched a line naming medium after this was published.
the line in the docs| `--effort` | Set the [effort level](/docs/en/model-config#adjust-effort-level) for the current session. Options: `low`, `medium`, `high`, `xhigh`, `max`, or `ultracode`. Available levels depend on the model. `ultracode` requests `xhigh` … |
|
v2.1.239--effort |
Documentation arrivedA small documentation edit on CLI reference touched a line naming --effort after this was published.
the line in the docs| `--effort` | Set the [effort level](/docs/en/model-config#adjust-effort-level) for the current session. Options: `low`, `medium`, `high`, `xhigh`, `max`, or `ultracode`. Available levels depend on the model. `ultracode` requests `xhigh` … |
|
v2.1.239modelSettings |
Documentation arrivedA small documentation edit on CLI reference touched a line naming modelSettings after this was published.
the line in the docs| `--effort` | Set the [effort level](/docs/en/model-config#adjust-effort-level) for the current session. Options: `low`, `medium`, `high`, `xhigh`, `max`, or `ultracode`. Available levels depend on the model. `ultracode` requests `xhigh` … |
|
v2.1.239modelSettings |
Documentation arrivedA small documentation edit on CLI reference touched a line naming modelSettings after this was published.
the line in the docs| `--effort` | Set the [effort level](/docs/en/model-config#adjust-effort-level) for the current session. Options: `low`, `medium`, `high`, `xhigh`, `max`, or `ultracode`. Available levels depend on the model. `ultracode` requests `xhigh` … |
|
v2.1.242replace |
Documentation arrivedA small documentation edit on Share session output as artifacts touched a line naming replace after this was published.
the line in the docs| Source file types | The published file must be `.html`, `.htm`, or `.md`, and must decode as UTF-8, or as little-endian UTF-16 by its byte-order mark. Markdown files render as styled HTML. A file that doesn't decode, or that contains the… |
|
v2.1.236type |
Documentation arrivedA small documentation edit on Share session output as artifacts touched a line naming type after this was published.
the line in the docs| Source file types | The published file must be `.html`, `.htm`, or `.md`, and must decode as UTF-8, or as little-endian UTF-16 by its byte-order mark. Markdown files render as styled HTML. A file that doesn't decode, or that contains the… |
|
v2.1.257ultracode |
Documentation arrivedA small documentation edit on Agent SDK reference - TypeScript touched a line naming ultracode after this was published.
the line in the docs`effortLevel` accepts an [effort level](/docs/en/model-config#adjust-effort-level) name. It also accepts `"ultracode"`, which requests `xhigh` effort with [ultracode](/docs/en/workflows#let-claude-decide-with-ultracode) on. `applyFlagSetti… |
|
v2.1.248/workflows |
Documentation arrivedA small documentation edit on Agent SDK reference - TypeScript touched a line naming /workflows after this was published.
the line in the docs`effortLevel` accepts an [effort level](/docs/en/model-config#adjust-effort-level) name. It also accepts `"ultracode"`, which requests `xhigh` effort with [ultracode](/docs/en/workflows#let-claude-decide-with-ultracode) on. `applyFlagSetti… |
|
v2.1.248high |
Documentation arrivedA small documentation edit on Agent SDK reference - TypeScript touched a line naming high after this was published.
the line in the docs`effortLevel` accepts an [effort level](/docs/en/model-config#adjust-effort-level) name. It also accepts `"ultracode"`, which requests `xhigh` effort with [ultracode](/docs/en/workflows#let-claude-decide-with-ultracode) on. `applyFlagSetti… |
|
v2.1.248workflows |
Documentation arrivedA small documentation edit on Agent SDK reference - TypeScript touched a line naming workflows after this was published.
the line in the docs`effortLevel` accepts an [effort level](/docs/en/model-config#adjust-effort-level) name. It also accepts `"ultracode"`, which requests `xhigh` effort with [ultracode](/docs/en/workflows#let-claude-decide-with-ultracode) on. `applyFlagSetti… |
|
v2.1.257xhigh |
Documentation arrivedA small documentation edit on Agent SDK reference - TypeScript touched a line naming xhigh after this was published.
the line in the docs`effortLevel` accepts an [effort level](/docs/en/model-config#adjust-effort-level) name. It also accepts `"ultracode"`, which requests `xhigh` effort with [ultracode](/docs/en/workflows#let-claude-decide-with-ultracode) on. `applyFlagSetti… |
|
v2.1.257xhigh |
Documentation arrivedA small documentation edit on Agent SDK reference - TypeScript touched a line naming xhigh after this was published.
the line in the docs`effortLevel` accepts an [effort level](/docs/en/model-config#adjust-effort-level) name. It also accepts `"ultracode"`, which requests `xhigh` effort with [ultracode](/docs/en/workflows#let-claude-decide-with-ultracode) on. `applyFlagSetti… |
|
v2.1.257xhigh |
Documentation arrivedA small documentation edit on Agent SDK reference - TypeScript touched a line naming xhigh after this was published.
the line in the docs`effortLevel` accepts an [effort level](/docs/en/model-config#adjust-effort-level) name. It also accepts `"ultracode"`, which requests `xhigh` effort with [ultracode](/docs/en/workflows#let-claude-decide-with-ultracode) on. `applyFlagSetti… |
|
v2.1.248xhigh |
Documentation arrivedA small documentation edit on Agent SDK reference - TypeScript touched a line naming xhigh after this was published.
the line in the docs`effortLevel` accepts an [effort level](/docs/en/model-config#adjust-effort-level) name. It also accepts `"ultracode"`, which requests `xhigh` effort with [ultracode](/docs/en/workflows#let-claude-decide-with-ultracode) on. `applyFlagSetti… |
|
v2.1.239xhigh |
Documentation arrivedA small documentation edit on Agent SDK reference - TypeScript touched a line naming xhigh after this was published.
the line in the docs`effortLevel` accepts an [effort level](/docs/en/model-config#adjust-effort-level) name. It also accepts `"ultracode"`, which requests `xhigh` effort with [ultracode](/docs/en/workflows#let-claude-decide-with-ultracode) on. `applyFlagSetti… |
|
v2.1.239effortLevel |
Documentation arrivedA small documentation edit on Agent SDK reference - TypeScript touched a line naming effortLevel after this was published.
the line in the docs`effortLevel` accepts an [effort level](/docs/en/model-config#adjust-effort-level) name. It also accepts `"ultracode"`, which requests `xhigh` effort with [ultracode](/docs/en/workflows#let-claude-decide-with-ultracode) on. `applyFlagSetti… |
|
v2.1.239effortLevel |
Documentation arrivedA small documentation edit on Agent SDK reference - TypeScript touched a line naming effortLevel after this was published.
the line in the docs`effortLevel` accepts an [effort level](/docs/en/model-config#adjust-effort-level) name. It also accepts `"ultracode"`, which requests `xhigh` effort with [ultracode](/docs/en/workflows#let-claude-decide-with-ultracode) on. `applyFlagSetti… |