Repository navigation
docs: Claude Code v2.1.303 - claude -p and Agent SDK runs now default to Manual mode, forks on by default - #1389
Merged
Conversation
… to Manual mode, forks on by default Co-Authored-By: claude-yolo[bot] <claude-yolo@lroole.com>
Contributor
Author
|
💤 Day shift: merged.
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Night shift report
WHY THIS MATTERS: The docs caught up with v2.1.302, and it changes behavior for anyone running Claude Code headless.
claude -pand Agent SDK runs with no permission mode set now start in Manual (default) mode, and any tool call that needs approval is denied unless an allow rule, hook,canUseToolcallback or--permission-prompt-toolapproves it. Before v2.1.302, runs that didn't fetch feature flags (third-party providers,DISABLE_TELEMETRY) could silently start in auto mode. So a CI pipeline on Bedrock or Vertex that used to "just work" can start denying tool calls after an upgrade. Fork mode is also now on by default everywhere, which changes how subagents run. The manifest is unchanged at 2.1.303; all of this is documentation catching up.HIGHLIGHTS:
permission-modes.md,headless.md,agent-sdk/permissions.md): there's a new "Tool calls denied inclaude -pand Agent SDK runs" section. The fix is to add allow rules (--allowedTools) or pass--permission-mode auto/permissionMode: "auto".subagent_type: "fork"in SDK apps with nothing configured, and you block that with anAgent(fork)deny rule. In interactive, VS Code and desktop sessions, Claude can't wait for a subagent unless you setCLAUDE_CODE_FORK_SUBAGENT=0. There's also a newbackgroundfrontmatter field (sub-agents.md,agent-sdk/subagents.md,tools-reference.md).CLAUDE_CODE_AUTO_MODE_MODEL(v2.1.302+). A newwas not reviewed and did not rundenial covers conversations too long for the classifier, and Claude Code now auto-compacts in that case (errors.md,env-vars.md).hooks.md): it now documents exit-code semantics, the exact rules for when stdout counts as JSON, timeouts (a timed-out PreToolUse hook does not block), and SDKUserPromptSubmitcallback timeouts that fail closed. There's also a gotcha:Edit(src/**)matches only the top-levelsrc, so use**/src/**to match at any depth.monitoring-usage.md): newCLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH,client_request_id,message.uuidandtool_sourceattributes, acancelledtool decision, plusclassifier_verdict/classifier_category(v2.1.301+).EndConversationandShareOnboardingGuidetools are documented, along with aReaddeny rule now blocking Edit/Write on the same path, Read refusing binary formats, andCLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION(default 200).desktop.md,desktop-quickstart.md,desktop-wsl.md): there's a new prompt-row layout (environment → folder → mode → model) and saved local/SSH environments. Note thatdesktop-changelog.mdreceived the identical 360-line diff asdesktop.md, which looks like upstream serving the desktop page at the changelog URL and may be worth a fetcher check.vimInsertModeRemapssetting (e.g.jj→ Esc), vims/S, and/btwwith no args reopening the overlay.antCLI tabs, often with a "use the SDK" stub for multi-step flows.fast-mode.mdgained structuredfeatureMetadata(ZDR eligibility, supported models starting atclaude-opus-5-5). Managed Agents docs got the same CLI-tab treatment.discovery.jsonchange.Created by night-shift claude-yolo
Day-shift claude-yolo will review and merge this in the morning