claudekit / updates / claude-code-2-1-142
[ PATCH · ]

Claude Code 2.1.142

Added new `claude agents` flags — `--add-dir`, `--settings`, `--mcp-config`, `--plugin-dir`, `--permission-mode`, `--model`, `--effort`, and `--dangerously-skip-permissions` — to configure dispatched background sessions. Fast mode now uses Opus 4.7 by default (set `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1` to pin to Opus 4.6). Plugins with a root-level `SKILL.md` and no `skills/` subdirectory are now surfaced as a skill, the `/plugin` details pane and `claude plugin details` show LSP servers a plugin provides, and `/web-setup` warns before replacing an existing GitHub App connection. Bug fixes span `MCP_TOOL_TIMEOUT` not raising the per-request fetch timeout for remote HTTP and SSE MCP servers, background sessions disappearing and daemon reconnect failing after macOS sleep/wake, the daemon not exiting cleanly after `brew upgrade`, plus a wide sweep of `claude agents`, plugin, session-title, and UI regressions.

Claude Code
Official announcement →

This article is a summary based on official documentation.

What changed

Claude Code 2.1.142 shipped on May 14, 2026. The release adds eight new flags to claude agents so dispatched background sessions can be configured at the call site — --add-dir, --settings, --mcp-config, --plugin-dir, --permission-mode, --model, --effort, and --dangerously-skip-permissions — and bumps fast mode’s default model from Opus 4.6 to Opus 4.7 (set CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1 to pin fast mode to Opus 4.6). On the plugin side, plugins with a root-level SKILL.md and no skills/ subdirectory are now surfaced as a skill, the /plugin details pane and claude plugin details show LSP servers a plugin provides, and /web-setup warns before replacing an existing GitHub App connection. The release also fixes MCP_TOOL_TIMEOUT not raising the per-request fetch timeout for remote HTTP and SSE MCP servers (which capped tool calls at 60 seconds regardless of the configured value), background sessions disappearing and daemon reconnect failing after macOS sleep/wake, the daemon not exiting cleanly after the binary is upgraded (e.g. brew upgrade) — which caused dispatched agents to crash-loop on the deleted path — and a long tail of claude agents, plugin, session-title, and UI regressions.

New features

  • Eight new claude agents dispatch flags — --add-dir, --settings, --mcp-config, --plugin-dir, --permission-mode, --model, --effort, --dangerously-skip-permissions

    Configuring a dispatched background session previously meant adjusting your shell or environment before launching it. claude agents now accepts --add-dir, --settings, --mcp-config, --plugin-dir, --permission-mode, --model, --effort, and --dangerously-skip-permissions so a dispatched background session can be configured directly at the call site.

  • Fast mode now uses Opus 4.7 by default

    Fast mode previously defaulted to Opus 4.6. It now defaults to Opus 4.7. Set CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1 to pin fast mode to Opus 4.6.

  • Plugins with a root-level SKILL.md are surfaced as a skill

    Plugins that wanted to provide a skill needed a skills/ subdirectory containing a SKILL.md. Plugins with a root-level SKILL.md and no skills/ subdirectory are now surfaced as a skill themselves, simplifying the layout for single-skill plugins.

  • /plugin details and claude plugin details show LSP servers

    The plugin component inventory didn’t include LSP servers, so the LSPs a plugin enabled had to be tracked separately. The /plugin details pane and claude plugin details now show the LSP servers a plugin provides.

  • /web-setup warns before replacing an existing GitHub App connection

    /web-setup previously replaced an existing GitHub App connection without confirmation, which made it easy to overwrite a working connection by accident. It now warns before replacing an existing GitHub App connection.

Improvements

  • Reactive compaction seeds the first summarize attempt from the original request’s overflow size

    Reactive compaction’s first summarize attempt started near the context limit, so it commonly needed a near-full-context retry. The first attempt is now seeded from the original request’s overflow size, so a single summarize attempt is more likely to succeed.

  • Hook configuration error: clearer message when the wrong hook type is configured for SessionStart / Setup / SubagentStart

    Configuring a prompt- or agent-type hook for SessionStart, Setup, or SubagentStart silently failed. The configuration now shows a clear “use a command-type hook instead” error.

  • Removed stale /model claude-sonnet-4-20250514 suggestion from Usage Policy refusal messages

    Usage Policy refusal messages still suggested switching to /model claude-sonnet-4-20250514, which no longer exists. The stale suggestion has been removed.

Bug fixes

MCP

  • MCP_TOOL_TIMEOUT not raising the per-request fetch timeout for remote HTTP and SSE MCP servers — tool calls were capped at 60 seconds regardless of the configured value. Fixed.

Background sessions & daemon

  • Background sessions not recognizing pre-existing git worktrees — Edit was blocked while EnterWorktree refused to create a duplicate. Fixed.
  • Background sessions disappearing and daemon reconnect failing after macOS sleep/wake — the daemon now detects clock jumps instead of treating them as elapsed idle time.
  • Daemon not exiting cleanly after the binary is upgraded (e.g. brew upgrade), causing dispatched agents to crash-loop on the deleted path — fixed.
  • Background agents crash-looping when the Claude-in-Chrome extension is connected without a shared tab — fixed.
  • claude --bg --dangerously-skip-permissions not persisting across retire/wake — fixed.

claude agents attached UI

  • Clicking links in an attached claude agents session — the background worker’s headless browser shim no longer applies while attached.
  • claude agents “v to open in editor” using the daemon’s default editor instead of your shell’s $EDITOR / $VISUAL — fixed.
  • claude agents deadlocking on Windows with network-drive working directories — fixed; Ctrl+C now works during startup.
  • Background-color bleed when attaching to a claude agents session from Apple Terminal or other 256-color-only terminals — fixed.

Session titles & /model breadcrumbs

  • Session titles being derived from the URL when the first message is a link — fixed.
  • Redundant set_model requests from remote clients injecting duplicate /model breadcrumbs into the transcript — fixed.

Plugins

  • Plugins using skills: ["./"] showing a false “path escapes plugin directory” error — fixed.
  • Plugin cache cleanup deleting the active plugin version directory when no installation metadata is present — fixed.
  • /plugin browse pane showing “0 installs” for newly published plugins — fixed.
  • Plugin advisories not naming every plugin.json key that shadows a default folder — fixed.

Notes

  • Configuring dispatched claude agents sessions — --add-dir, --settings, --mcp-config, --plugin-dir, --permission-mode, --model, --effort, and --dangerously-skip-permissions can now be set directly at the call site, so different sessions can carry different configurations without preconfiguring the shell or environment.
  • Fast mode default change — fast mode now defaults to Opus 4.7. If you need Opus 4.6 for regression tests or determinism, set CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1.
  • Single-skill plugin layout — plugins with a root-level SKILL.md and no skills/ subdirectory are surfaced as a skill, so a single-skill plugin no longer needs a skills/ directory. Existing plugins that put SKILL.md under skills/ continue to work as before.
  • MCP_TOOL_TIMEOUT actually applies — remote HTTP / SSE MCP tool calls are no longer capped at 60 seconds when MCP_TOOL_TIMEOUT is raised. Workarounds that split long-running calls to avoid the cap can be removed.
  • macOS sleep/wake stability for background sessions — the daemon now detects clock jumps instead of treating them as elapsed idle time, so background sessions no longer disappear after sleep/wake on laptops.
  • brew upgrade no longer leaves dispatched agents crash-looping — the daemon now exits cleanly after the binary is upgraded, so dispatched agents won’t crash-loop on the deleted path. Manual daemon-restart workarounds after upgrade are no longer needed.