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

1 month ago

What changed in Claude Code v2.1.283: a prompt audit, exact model pinning, a prompt ID header for gateways, MCP and plugin fixes, and VS Code repairs. https://github.com/anthropics/claude-code/releases/tag/v2.1.283 https://github.com/anthropics/claude-code/blob/v2.1.283/CHANGELOG.md

Ask about this presentation

Chapters

  1. 0:00Claude Code v2.1.283
  2. 0:1401 Models and gateways
  3. 0:16availableModelsMatch and deniedModels
  4. 0:29x-claude-code-prompt-id
  5. 0:4002 MCP servers
  6. 0:42MCP images saved to a file
  7. 0:52MCP servers recover
  8. 1:0503 Startup and safety
  9. 1:07Auto mode by default
  10. 1:19Faster startup and first reply
  11. 1:31PowerShell delete guard
  12. 1:4304 Plugins
  13. 1:45claude plugin validate
  14. 1:58installed_plugins.json recovery
  15. 2:1105 In the terminal
  16. 2:12Vim mode
  17. 2:23Lists scroll
  18. 2:3406 The VS Code extension
  19. 2:36VS Code sessions
Show transcript
  1. Claude Code v2.1.283 adds a prompt audit. Run /doctor prompt-audit, and it checks your CLAUDE.md files, skills, agents and commands for prompting patterns written for older models.

    Slide text
    Claude Code v2.1.283

    Claude Code
    v2.1.283

    A prompt audit, exact model pinning, and sturdier MCP servers and plugins.

    > /doctor prompt-audit
    
      CLAUDE.md files
      skills
      agents
      commands
    CHANGELOG.md, 2.1.283
  2. Models and gateways.

    Slide text
    Claude Code v2.1.283
    01

    >Models and
    gateways

    CHANGELOG.md, 2.1.283
  3. Set the managed setting availableModelsMatch to exact, and each entry allows only the version it names, so new releases stay blocked until listed. deniedModels blocks a model even when that list allows it.

    Slide text
    Claude Code v2.1.283

    >Admins can allow exact model versions, and deny others

    availableModelsMatch: "exact"
    an entry allows only the version it names
    deniedModels
    blocks a model even when availableModels allows it
    CHANGELOG.md, 2.1.283
  4. Set the gateway hint headers variable to one, and every request now carries a prompt ID header, so an LLM gateway can group all the requests that serve a single prompt.

    Slide text
    Claude Code v2.1.283

    >Gateways can group the requests behind one prompt

    CLAUDE_CODE_GATEWAY_HINT_HEADERS=1
    
    x-claude-code-prompt-id: …
    CHANGELOG.md, 2.1.283
  5. MCP servers.

    Slide text
    Claude Code v2.1.283
    02

    >MCP servers

    CHANGELOG.md, 2.1.283
  6. When an MCP tool returns an image, Claude Code now also saves it to a file. That means Bash, Read and the other tools can open the image directly.

    Slide text
    Claude Code v2.1.283

    >Images from MCP tools are also saved to a file

    So Bash, Read and other tools can open them.

    CHANGELOG.md, 2.1.283
  7. A brief 404 from a stateless remote server used to break it for the rest of the session. Background tool calls now show their latest progress, and stdio servers still starting stop with the session.

    Slide text
    Claude Code v2.1.283

    >A brief 404 no longer strands a remote MCP server

    Stateless remote server
    usable again after a brief 404
    Background tool call
    shows its latest progress
    Stdio server still starting
    stops when the session ends
    CHANGELOG.md, 2.1.283
  8. Startup and safety.

    Slide text
    Claude Code v2.1.283
    03

    >Startup
    and safety

    CHANGELOG.md, 2.1.283
  9. On a third party provider, or with telemetry turned off, an interactive session with no permission mode configured now starts in auto mode. Setting permissions.defaultMode still overrides it.

    Slide text
    Claude Code v2.1.283

    >Third-party providers now start in auto mode

    Applies to
    interactive sessions on a third-party provider, or with telemetry off
    When
    no permission mode is configured
    Override
    permissions.defaultMode
    CHANGELOG.md, 2.1.283
  10. Print mode and Claude Code Remote skip loading the interactive UI. The first request reuses the connection opened at launch, and a compile step after the first reply now runs while it streams.

    Slide text
    Claude Code v2.1.283

    >Startup and the first reply got faster

    claude -p
    skips loading the interactive UI
    First request
    reuses the preconnected API connection
    First reply
    a compile step runs while it streams
    CHANGELOG.md, 2.1.283
  11. On Windows, the PowerShell tool let a delete routed through cmd remove drive roots and your home folder. Those folders are now protected, the same ones Remove-Item already refuses.

    Slide text
    Claude Code v2.1.283

    >On Windows, cmd deletes get the Remove-Item guard

    cmd /c rd
    cmd /c rmdir
    cmd /c del
    cmd /c erase

    Drive roots and the home folder are now protected.

    CHANGELOG.md, 2.1.283
  12. Plugins.

    Slide text
    Claude Code v2.1.283
    04

    >Plugins

    CHANGELOG.md, 2.1.283
  13. The plugin validate command now fails a plugin or marketplace name that Claude Code can't install, and output style, theme, monitor or LSP server paths that are missing or point outside the plugin.

    Slide text
    Claude Code v2.1.283

    >claude plugin validate fails what won't install

    Names
    a plugin or marketplace name Claude Code can't install
    Paths
    missing, or outside the plugin directory
    CHANGELOG.md, 2.1.283
  14. When the installed plugins file can't be read, its contents are now kept in a file beside it before the rebuild, and plugin list names that file. An unreadable record gets named, with recovery steps.

    Slide text
    Claude Code v2.1.283

    >An unreadable plugin list is saved before the rebuild

    installed_plugins.json
    contents kept in a file beside it
    claude plugin list
    names that file
    Unknown record
    named, with how to recover
    CHANGELOG.md, 2.1.283
  15. In the terminal.

    Slide text
    Claude Code v2.1.283
    05

    >In the
    terminal

    CHANGELOG.md, 2.1.283
  16. In vim mode, J now joins lines with the spacing Vim uses, dot repeat keeps a Shift Enter newline, and V then p puts the cursor on the first non blank character.

    Slide text
    Claude Code v2.1.283

    >Vim mode's J, dot and paste behave like Vim

    J
    joins lines with Vim's spacing
    .
    keeps a Shift+Enter newline
    V then p
    lands on the first non-blank
    CHANGELOG.md, 2.1.283
  17. Lists across Claude Code, from help and hooks to rewind and plugin, now move with the page keys, the mouse wheel and clicks. The tasks list also shows a status icon on every row.

    Slide text
    Claude Code v2.1.283

    >Pickers scroll with page keys, the wheel and clicks

    /help   /hooks   /memory
    /rewind   /diff   /plugin
    /tasks   /release-notes
    CHANGELOG.md, 2.1.283
  18. The VS Code extension.

    Slide text
    Claude Code v2.1.283
    06

    >The VS Code
    extension

    CHANGELOG.md, 2.1.283
  19. In VS Code, the mode indicator could show Default while a session ran in auto or bypass mode. The switch now retries until it lands. Teleported web sessions keep messages sent mid turn.

    Slide text
    Claude Code v2.1.283

    >The VS Code mode indicator matches the session

    Mode indicator
    retries a failed switch until it lands
    Teleported session
    keeps messages sent while Claude worked
    Web session
    appears in the session list
    CHANGELOG.md, 2.1.283

What happened in AI today, in your inbox

One short email each evening. Read it and you’re caught up.

Built with ❤️ in New York