docs: sync to Claude Code v2.1.263 (#181)

Audit against the 2.1.258-2.1.263 delta and current official docs.

The release delta produced one contradiction: keybindingFlavor was
deprecated to a no-op in v2.1.261, but 10-cli and 09-advanced-features
still documented it as selecting between "classic" and "readline" with
classic as the default. Readline conventions are now unconditional.

Re-reading the enterprise MCP section against the current managed-mcp
docs found it structurally wrong, independent of the delta:

- allowedMcpServers, deniedMcpServers and allowAllClaudeAiMcps were
  presented as fields of managed-mcp.json. They are settings keys;
  managed-mcp.json holds an mcpServers map in .mcp.json format.
- Linux and Windows deployment paths were per-user (~/.config/ClaudeCode,
  %APPDATA%) where the real ones are system paths. An admin deploying to
  the documented path got no enforcement.
- The denylist example used serverName "untrusted-*". Name matching is
  exact and never expands wildcards, so that pattern blocks nothing.
- Allow/deny entries paired two keys in one object and wrote
  serverCommand as a bare string; both forms are invalid.

Mirrored into vi, ja and uk. zh has no enterprise MCP section.

Also removed a claim in 09-advanced-features and 10-cli that the settings
reference does not list modelPricing. It documents it, along with every
other key in that table.

New in this release range: /skill-doctor, /diff fullscreen panel,
/advisor text form and /reload-plugins in headless sessions,
managedMcpServers, --permission-prompts none,
--append-subagent-system-prompt-file, bashOutputMaxChars,
taskOutputMaxChars, and claude plugin validate --json.

Validation: pre-commit run --all-files, 23/23 hooks pass.

Claude-Session: https://claude.ai/code/session_01PAXabzMfDJxom9JPXtkK5o
This commit is contained in:
Luong NGUYEN
2026-09-06 11:04:12 +02:00
committed by GitHub
parent 1e16914a8d
commit 97bfb0685e
12 changed files with 231 additions and 136 deletions
+8 -4
View File
@@ -188,6 +188,7 @@ claude --model opusplan "design and implement the caching layer"
| `--system-prompt-file` | Load prompt from file (print mode) | `claude -p --system-prompt-file ./prompt.txt "query"` |
| `--append-system-prompt` | Append to default prompt | `claude --append-system-prompt "Always use TypeScript"` |
| `--append-subagent-system-prompt` | Append text to every subagent's system prompt (non-interactive) | `claude -p --append-subagent-system-prompt "Cite sources" "query"` |
| `--append-subagent-system-prompt-file` | (v2.1.261) Load that appended text from a file instead, for prompts too long to pass on the command line. Non-interactive only, and **cannot be combined** with `--append-subagent-system-prompt` | `claude -p --append-subagent-system-prompt-file ./subagent-rules.txt "query"` |
### System Prompt Examples
@@ -222,6 +223,7 @@ claude -p --system-prompt-file ./prompts/code-reviewer.txt "review main.py"
| `--dangerously-skip-permissions` | Skip all permission prompts | `claude --dangerously-skip-permissions` |
| `--permission-mode` | Begin in specified permission mode | `claude --permission-mode auto` |
| `--permission-prompt-tool` | MCP tool for permission handling | `claude -p --permission-prompt-tool mcp_auth "query"` |
| `--permission-prompts` | (v2.1.259) Who answers permission prompts in print mode. Default `host` sends them to the Agent SDK host or the `--permission-prompt-tool` tool; pass `none` when nobody can answer and Claude Code denies them instead | `claude -p --permission-prompts none "query"` |
> **v2.1.111 update**: `--enable-auto-mode` was removed; auto mode is now in the `Shift+Tab` cycle by default — use `--permission-mode auto` to start in it directly.
@@ -932,8 +934,10 @@ These keys live in a `settings.json` file (`~/.claude/settings.json` for user sc
| `modelPicker` | (v2.1.243) Choose which models the `/model` picker lists, in your own order and with your own labels. One of the few settings that **replaces rather than merges** across settings layers. |
| `promptCacheTtl` | (v2.1.243) Choose the prompt cache lifetime for the main conversation. |
| `subagentPromptCacheTtl` | (v2.1.243) The same choice for subagents and other requests outside the main conversation. |
| `modelPricing` | (v2.1.243) **Managed setting.** Supplies your organization's contracted rates so `/cost`, the status line, and telemetry report those instead of list price. **Changelog-sourced** — the settings reference does not yet list this key. |
| `keybindingFlavor` | (v2.1.238) `"classic"` (default) or `"readline"`. `readline` makes `Ctrl+W` delete back to the previous whitespace, as Bash does; v2.1.239 extended it to `Alt+F`, `Ctrl`/`Option+→`, and `Alt+D`. |
| `modelPricing` | (v2.1.243) **Managed setting.** Supplies your organization's contracted rates so `/cost`, the status line, and telemetry report those instead of list price. |
| `keybindingFlavor` | **Deprecated since v2.1.261 and has no effect.** The prompt's word-editing keys always follow readline conventions, as Bash does: `Ctrl+W` deletes back to whitespace, `Alt+F` and `Alt+D` stop at word end, and punctuation separates words. Claude Code still accepts the key, so a settings file that sets it stays valid. (In v2.1.238–v2.1.260 it chose between `"classic"` and `"readline"`.) |
| `bashOutputMaxChars` | (v2.1.261) How many characters of a **successful** Bash or PowerShell command's output Claude receives inline, up to 128K. Past the limit Claude Code saves the output to a file and Claude gets a short preview plus the path. Setting it makes Claude Code ignore `BASH_MAX_OUTPUT_LENGTH`. |
| `taskOutputMaxChars` | (v2.1.261) How many characters of a **background task's** output Claude receives inline when reading it with the `TaskOutput` tool, up to 128K. For a longer finished task Claude receives the most recent characters. Setting it makes Claude Code ignore `TASK_MAX_OUTPUT_LENGTH`. |
```json
{
@@ -1047,8 +1051,8 @@ claude -p --output-format json "query"
---
**Last Updated**: September 2, 2026
**Claude Code Version**: 2.1.257
**Last Updated**: September 6, 2026
**Claude Code Version**: 2.1.263
**Sources**:
- https://code.claude.com/docs/en/cli-reference
- https://code.claude.com/docs/en/env-vars