Claude Code v2.1.285: claude --desktop, a provider allowlist, and time limits on background commands

1 week ago

What changed in Claude Code v2.1.285: claude --desktop opens the desktop app from your terminal, plugin settings move to the command line, admins can limit API providers and turn off WebFetch, deny rules hold over installed plugins, and background shell commands get a time limit. https://github.com/anthropics/claude-code/releases/tag/v2.1.285 https://github.com/anthropics/claude-code/blob/v2.1.285/CHANGELOG.md

Ask

Ask about this presentation

Answers are generated from this presentation.

Chapters

  1. 0:00claude --desktop
  2. 0:1501 Plugins and sessions
  3. 0:16Plugin settings from the command line
  4. 0:29Resume a background session
  5. 0:3902 Admin controls
  6. 0:40allowedProviders
  7. 0:52Turn off WebFetch
  8. 1:03Deny rules hold over installed plugins
  9. 1:1603 Changed defaults
  10. 1:17Background commands time out
  11. 1:271M context behind a custom base URL
  12. 1:40claude -p starts in auto mode
  13. 1:53widgets is a reserved MCP name
  14. 2:0504 Fixes
  15. 2:06Retries
  16. 2:17Hooks and cancelled commands
  17. 2:28Permission checks
  18. 2:4205 The VS Code extension
  19. 2:44VS Code
  20. 2:54The full changelog
Show transcript

claude --desktop

Claude Code

Claude Code v2.1.285 opens the desktop app from your terminal

claude --desktop
the Claude desktop app, on this directory
--continue / --resume <id>
the same, on that session
CHANGELOG.md · anthropics/claude-code

Claude Code 2.1.285 adds a desktop flag. Run claude --desktop and the Claude desktop app opens on your current directory. Add continue, or resume with an ID, and it opens that session instead.

01 Plugins and sessions

Claude Code
01

>Plugins
and sessions

CHANGELOG.md · anthropics/claude-code

Plugins and sessions.

Plugin settings from the command line

Claude Code

>Plugin settings now work from the command line

claude plugin configure <plugin>
claude plugin install --config <server>.<key>=<value>
CHANGELOG.md · anthropics/claude-code

A new plugin configure command shows a plugin's options, flags the unset ones, and saves new values. Plugin install can now set a bundled MCP server's own settings, so it starts ready to use.

Resume a background session

Claude Code

>/resume now opens a session running in the background

claude --resume <id> "prompt"

The prompt becomes that session's next turn.

CHANGELOG.md · anthropics/claude-code

Resume now opens a session that is running in the background, instead of refusing it, and a prompt passed with its ID becomes that session's next turn.

02 Admin controls

Claude Code
02

>Admin
controls

CHANGELOG.md · anthropics/claude-code

Admin controls.

allowedProviders

Claude Code

>Admins can limit which API providers a machine uses

Setting
allowedProviders, in managed settings
Choices
Anthropic API, a custom endpoint, Bedrock, Mantle, Vertex AI, Foundry, Claude Platform on AWS, a Cloud gateway
CHANGELOG.md · anthropics/claude-code

A new managed setting, allowed providers, limits which API providers a machine may use, from the Anthropic API and custom endpoints to Bedrock, Vertex AI and Foundry.

Turn off WebFetch

Claude Code

>WebFetch can be switched off with one variable

CLAUDE_CODE_DISABLE_WEB_FETCH

Team and Enterprise: WebFetch now waits for the organization policy when it fails to load at startup.

CHANGELOG.md · anthropics/claude-code

A new environment variable turns off the WebFetch tool. On Team and Enterprise plans, when the organization policy fails to load at startup, WebFetch waits until it does.

Deny rules hold over installed plugins

Claude Code

>A deny rule in your settings now holds over plugins you install

On machines with managed settings, and for Team and Enterprise organizations.

allowManagedModsOnly
a new admin option: only the organization's and built-in mods load
mods/sec-default/README.md · anthropics/claude-code

A plugin that approves every tool call could lift a deny rule. On managed machines and Team or Enterprise organizations, the rule now holds. A new admin option keeps personal mods from loading.

03 Changed defaults

Claude Code
03

>Changed
defaults

CHANGELOG.md · anthropics/claude-code

Changed defaults.

Background commands time out

Claude Code

>Background shell commands now stop after a time limit

Default
30 minutes
Maximum
2 hours, set by the command's timeout
When it stops
Claude is notified
CHANGELOG.md · anthropics/claude-code

Background Bash and PowerShell commands now stop when they hit a time limit, 30 minutes by default and at most two hours, and Claude is told when one is stopped.

1M context behind a custom base URL

Claude Code

>A custom base URL now gets the 1M context window

Models
Opus 4.7 and later, Sonnet 5 and later, Fable
# gateway stops at 200K?
/autocompact 200k
CHANGELOG.md · anthropics/claude-code

Sessions behind a custom Anthropic base URL now use the 1 million token context window on models that have one. If your gateway stops at 200 thousand tokens, set auto compact back to that.

claude -p starts in auto mode

Claude Code

>claude -p on third-party providers now starts in auto mode

Applies to
claude -p and Python Agent SDK sessions
When
a third-party provider or telemetry off, and no permission mode set
Override
--permission-mode
CHANGELOG.md · anthropics/claude-code

Print mode and Python Agent SDK sessions on third-party providers, or with telemetry off, now start in auto mode when no permission mode is set. The permission mode flag still wins.

widgets is a reserved MCP name

Claude Code

>Cloud sessions reserve the MCP server name widgets

A server of yours named widgets, or a close spelling like widgets_, no longer loads there.

CHANGELOG.md · anthropics/claude-code

In cloud sessions and on self-hosted runners, the MCP server name widgets is now reserved. A server of yours with that name, or a close spelling, no longer loads, so rename it.

04 Fixes

Claude Code
04

>Fixes

CHANGELOG.md · anthropics/claude-code

Fixes.

Retries

Claude Code

>Failing requests stop retrying sooner

Streaming failures
up to 21 retries before; the fallback now shares one budget
Content filter
its error shows at once, instead of minutes of retries
Sign-in
finishes after the browser shows success
CHANGELOG.md · anthropics/claude-code

A failing request could be retried up to 21 times, and now the fallback shares one retry budget. Content filter blocks show their error right away, and sign-in stops hanging.

Hooks and cancelled commands

Claude Code

>Hooks and cancelled commands no longer stall the session

Synchronous hooks
finish once their own process exits
Cancelled commands
a cancel during setup now stops the command
Long sessions
a freeze of up to a second, outside fullscreen, is gone
CHANGELOG.md · anthropics/claude-code

A synchronous hook no longer hangs when a background process it started keeps its output open. A cancelled command stays cancelled, and long sessions lose a one-second freeze.

Permission checks

Claude Code

>Permission checks that could be skipped now run

PowerShell
deny and ask rules apply even when its parser fails to start
Fork subagents
run under the parent's permission mode, and stay in plan mode
Artifact allow rule
stops covering files outside your working directories
CHANGELOG.md · anthropics/claude-code

PowerShell deny and ask rules now apply even when its command parser fails. Fork subagents keep their parent's permission mode, and an Artifact allow rule stops covering files outside your working directories.

05 The VS Code extension

Claude Code
05

>The VS Code
extension

CHANGELOG.md · anthropics/claude-code

The VS Code extension.

VS Code

Claude Code

>VS Code gets a plugin options form and a diagnostics tool

Plugin options
a form asks for unset ones on install; a gear changes them later
Diagnostics
Claude can check the Problems panel at any time
Reloads
a restored tab says when a reload cut off its reply
CHANGELOG.md · anthropics/claude-code

In VS Code, installing a plugin with options opens a form for the unset ones, and Claude can check the Problems panel's errors and warnings at any time.

The full changelog

Claude Code

Every change is in the Claude Code changelog

CHANGELOG.md in anthropics/claude-code

github.com/anthropics/claude-code
CHANGELOG.md · anthropics/claude-code

This release also fixes Remote Control attachments, vim mode and the transcript view. Every change in 2.1.285 is in the Claude Code changelog on GitHub.

Up next

1:46

Claude Code v2.1.296: Claude can read a large file in one call

@claude-code · 2 days ago

1:36

Claude Code: hooks can now block an action when they fail

@claude-code · 3 days ago

1:39

Claude Code v2.1.293: Claude Haiku 5.5 becomes the default Haiku model, and finished work stays finished after a compaction

@claude-code · 4 days ago

1:32

Claude Code: subagents run at the effort you ask for, plugins install from a marketplace in one command, and network-path reads ask first

@claude-code · 5 days ago

1:23

Claude Code v2.1.290: WebSearch refills by the hour, WebFetch says what it left unread, and scheduled tasks stop going missing

@claude-code · 6 days ago

1:25

Claude Code v2.1.289: Bash deny rules hold under sandbox auto-allow, and a failing plugin no longer ends your session

@claude-code · 1 week ago

1:40

Claude Code v2.1.288: Up restores a prompt cleared with Ctrl+C, and mid-response timeouts no longer fail the turn

@claude-code · 1 week ago

1:46

Claude Code v2.1.287: Claude Mods let plugins change deeper behavior, and 1M context is the default on Bedrock and Vertex

@claude-code · 1 week ago

3:04

Claude Code v2.1.286: resumed sessions keep every turn, refused models fall back, and secrets stay masked

@claude-code · 1 week ago

3:08

Claude Code v2.1.284: Sonnet 5.5 by default, auto mode on every plan, and an Ultracode toggle

@claude-code · 1 week ago

2:49

Claude Code v2.1.283: prompt audit, exact model pinning, MCP and plugin fixes

@claude-code · 1 week ago

3:03

Claude Code v2.1.261

@claude-code · 1 month ago