Update Claude Code docs - 2025-08-22 | Updated: data-usage.md,hooks-guide.md hooks.md,mcp.md troubleshooting.md

github-actions[bot] · github-actions[bot] · commit 50eead6dbbcf · 2025-08-22T21:04:07.000Z
diff --git a/docs/data-usage.md b/docs/data-usage.md
@@ -34,7 +34,7 @@ For full details, please review our [Commercial Terms of Service](https://www.an
 
 ## Data flow and dependencies
 
-![Claude Code data flow diagram](https://mintlify.s3.us-west-1.amazonaws.com/anthropic/images/claude-code-data-flow.png)
+<img src="https://mintcdn.com/anthropic/images/claude-code-data-flow.png?maxW=1597&auto=format&n=TJyVEsJNS7-wcDQw&q=85&s=fa613fe5084e8c714de3e8251344135d" alt="Claude Code data flow diagram" width="1597" height="1285" data-path="images/claude-code-data-flow.png" srcset="https://mintcdn.com/anthropic/images/claude-code-data-flow.png?w=280&maxW=1597&auto=format&n=TJyVEsJNS7-wcDQw&q=85&s=9b98f9447b3fa42f12bdabf890062c72 280w, https://mintcdn.com/anthropic/images/claude-code-data-flow.png?w=560&maxW=1597&auto=format&n=TJyVEsJNS7-wcDQw&q=85&s=edc5e1f783fae53f9067ba51dcb87d87 560w, https://mintcdn.com/anthropic/images/claude-code-data-flow.png?w=840&maxW=1597&auto=format&n=TJyVEsJNS7-wcDQw&q=85&s=b675e341c4797dbfe8a1c2d32838b6c8 840w, https://mintcdn.com/anthropic/images/claude-code-data-flow.png?w=1100&maxW=1597&auto=format&n=TJyVEsJNS7-wcDQw&q=85&s=e0c22bc2577235900e7b08b351ce9d59 1100w, https://mintcdn.com/anthropic/images/claude-code-data-flow.png?w=1650&maxW=1597&auto=format&n=TJyVEsJNS7-wcDQw&q=85&s=174115b36520b289b985968bf90ad1d7 1650w, https://mintcdn.com/anthropic/images/claude-code-data-flow.png?w=2500&maxW=1597&auto=format&n=TJyVEsJNS7-wcDQw&q=85&s=753faf09b799b3087fdda86d86796a36 2500w" data-optimize="true" data-opv="2" />
 
 Claude Code is installed from [NPM](https://www.npmjs.com/package/@anthropic-ai/claude-code). Claude Code runs locally. In order to interact with the LLM, Claude Code sends data over the network. This data includes all user prompts and model outputs. The data is encrypted in transit via TLS and is not encrypted at rest. Claude Code is compatible with most popular VPNs and LLM proxies.
 
diff --git a/docs/docs_manifest.json b/docs/docs_manifest.json
@@ -39,8 +39,8 @@
     "data-usage.md": {
       "original_url": "https://docs.anthropic.com/en/docs/claude-code/data-usage",
       "original_md_url": "https://docs.anthropic.com/en/docs/claude-code/data-usage.md",
-      "hash": "7a8fd4e7dd09cb1735c9cf62d633d8e43bf5f4cb7c23a389ba0ae64c34185ed6",
-      "last_updated": "2025-08-06T00:04:51.571452"
+      "hash": "60bf155d6ba8dbbaede4bd98c03cea0daa25a81db2f3c3dd9e01176bc1eb34fa",
+      "last_updated": "2025-08-22T21:03:53.426497"
     },
     "devcontainer.md": {
       "original_url": "https://docs.anthropic.com/en/docs/claude-code/devcontainer",
@@ -63,14 +63,14 @@
     "hooks.md": {
       "original_url": "https://docs.anthropic.com/en/docs/claude-code/hooks",
       "original_md_url": "https://docs.anthropic.com/en/docs/claude-code/hooks.md",
-      "hash": "87e2b8876dab1de54d9838d3720072fe0996ad9112701b9c47deb22dc1f94ac4",
-      "last_updated": "2025-07-31T03:30:20.759961"
+      "hash": "4bc290a423a52087fdef7a527616c9f8eb5dfe244a484eb3f06cfb1e1ea035d0",
+      "last_updated": "2025-08-22T21:03:55.559085"
     },
     "hooks-guide.md": {
       "original_url": "https://docs.anthropic.com/en/docs/claude-code/hooks-guide",
       "original_md_url": "https://docs.anthropic.com/en/docs/claude-code/hooks-guide.md",
-      "hash": "46ec8c1f79e8f78a0f569de5c7391db82a86d7b9868ac9a770a3c603bda51561",
-      "last_updated": "2025-08-14T18:02:04.728304"
+      "hash": "a8347a1951dfe7a55e644c95b5dced0ab1bdb5ef387f4e3443dac610a8cac836",
+      "last_updated": "2025-08-22T21:03:56.085331"
     },
     "iam.md": {
       "original_url": "https://docs.anthropic.com/en/docs/claude-code/iam",
@@ -105,8 +105,8 @@
     "mcp.md": {
       "original_url": "https://docs.anthropic.com/en/docs/claude-code/mcp",
       "original_md_url": "https://docs.anthropic.com/en/docs/claude-code/mcp.md",
-      "hash": "c7ee422e5476da66d568679d061ea68fcaef48a26b459fe6bf5f831b23546620",
-      "last_updated": "2025-08-19T21:01:57.038256"
+      "hash": "3110c23f7a50c398bd6fe914b71b45f4ae5672d68a42e9fa4f5f089c47e3b752",
+      "last_updated": "2025-08-22T21:03:59.291460"
     },
     "memory.md": {
       "original_url": "https://docs.anthropic.com/en/docs/claude-code/memory",
@@ -195,8 +195,8 @@
     "troubleshooting.md": {
       "original_url": "https://docs.anthropic.com/en/docs/claude-code/troubleshooting",
       "original_md_url": "https://docs.anthropic.com/en/docs/claude-code/troubleshooting.md",
-      "hash": "37ac345e1928b67a1721e356c43b194c39e3ded2c2dc04785c861f537d92b70e",
-      "last_updated": "2025-08-19T00:05:07.148425"
+      "hash": "5893f01fd30bb019501c95d18a2cfd7236c5bf252591dc1901978a2f0722312b",
+      "last_updated": "2025-08-22T21:04:07.222179"
     },
     "changelog.md": {
       "original_url": "https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md",
@@ -207,8 +207,8 @@
     }
   },
   "fetch_metadata": {
-    "last_fetch_completed": "2025-08-22T18:05:33.969768",
-    "fetch_duration_seconds": 17.800251,
+    "last_fetch_completed": "2025-08-22T21:04:07.257889",
+    "fetch_duration_seconds": 18.513461,
     "total_pages_discovered": 33,
     "pages_fetched_successfully": 34,
     "pages_failed": 0,
@@ -218,7 +218,7 @@
     "total_files": 34,
     "fetch_tool_version": "3.0"
   },
-  "last_updated": "2025-08-22T18:05:33.969823",
+  "last_updated": "2025-08-22T21:04:07.257911",
   "base_url": "https://raw.githubusercontent.com/mnestorov/cc-docs-mirror/main/docs/",
   "github_repository": "mnestorov/cc-docs-mirror",
   "github_ref": "main",
diff --git a/docs/hooks-guide.md b/docs/hooks-guide.md
@@ -44,9 +44,10 @@ workflow:
 * **UserPromptSubmit**: Runs when the user submits a prompt, before Claude processes it
 * **Notification**: Runs when Claude Code sends notifications
 * **Stop**: Runs when Claude Code finishes responding
-* **Subagent Stop**: Runs when subagent tasks complete
+* **SubagentStop**: Runs when subagent tasks complete
 * **PreCompact**: Runs before Claude Code is about to run a compact operation
 * **SessionStart**: Runs when Claude Code starts a new session or resumes an existing session
+* **SessionEnd**: Runs when Claude Code session ends
 
 Each event receives different data and can control Claude's behavior in
 different ways.
diff --git a/docs/hooks.md b/docs/hooks.md
@@ -141,6 +141,18 @@ the stoppage occurred due to a user interrupt.
 
 Runs when a Claude Code subagent (Task tool call) has finished responding.
 
+### SessionEnd
+
+Runs when a Claude Code session ends. Useful for cleanup tasks, logging session
+statistics, or saving session state.
+
+The `reason` field in the hook input will be one of:
+
+* `clear` - Session cleared with /clear command
+* `logout` - User logged out
+* `prompt_input_exit` - User exited while prompt input was visible
+* `other` - Other exit reasons
+
 ### PreCompact
 
 Runs before Claude Code is about to run a compact operation.
@@ -285,6 +297,18 @@ For `manual`, `custom_instructions` comes from what the user passes into
 }
 ```
 
+### SessionEnd Input
+
+```json
+{
+  "session_id": "abc123",
+  "transcript_path": "~/.claude/projects/.../00893aaf-19fa-41d2-8238-13269b9b3ca0.jsonl",
+  "cwd": "/Users/...",
+  "hook_event_name": "SessionEnd",
+  "reason": "exit"
+}
+```
+
 ## Hook Output
 
 There are two ways for hooks to return output back to Claude Code. The output
@@ -320,6 +344,7 @@ Hooks communicate status through exit codes, stdout, and stderr:
 | `SubagentStop`     | Blocks stoppage, shows stderr to Claude subagent                   |
 | `PreCompact`       | N/A, shows stderr to user only                                     |
 | `SessionStart`     | N/A, shows stderr to user only                                     |
+| `SessionEnd`       | N/A, shows stderr to user only                                     |
 
 ### Advanced: JSON Output
 
@@ -332,8 +357,10 @@ All hook types can include these optional fields:
 ```json
 {
   "continue": true, // Whether Claude should continue after hook execution (default: true)
-  "stopReason": "string" // Message shown when continue is false
+  "stopReason": "string", // Message shown when continue is false
+
   "suppressOutput": true, // Hide stdout from transcript mode (default: false)
+  "systemMessage": "string" // Optional warning message shown to the user
 }
 ```
 
@@ -357,10 +384,9 @@ to Claude.
 `PreToolUse` hooks can control whether a tool call proceeds.
 
 * `"allow"` bypasses the permission system. `permissionDecisionReason` is shown
-  to the user but not to Claude. (*Deprecated `"approve"` value + `reason` has
-  the same behavior.*)
+  to the user but not to Claude.
 * `"deny"` prevents the tool call from executing. `permissionDecisionReason` is
-  shown to Claude. (*`"block"` value + `reason` has the same behavior.*)
+  shown to Claude.
 * `"ask"` asks the user to confirm the tool call in the UI.
   `permissionDecisionReason` is shown to the user but not to Claude.
 
@@ -369,24 +395,34 @@ to Claude.
   "hookSpecificOutput": {
     "hookEventName": "PreToolUse",
     "permissionDecision": "allow" | "deny" | "ask",
-    "permissionDecisionReason": "My reason here (shown to user)"
-  },
-  "decision": "approve" | "block" | undefined, // Deprecated for PreToolUse but still supported
-  "reason": "Explanation for decision" // Deprecated for PreToolUse but still supported
+    "permissionDecisionReason": "My reason here"
+  }
 }
 ```
 
+<Note>
+  The `decision` and `reason` fields are deprecated for PreToolUse hooks.
+  Use `hookSpecificOutput.permissionDecision` and
+  `hookSpecificOutput.permissionDecisionReason` instead. The deprecated fields
+  `"approve"` and `"block"` map to `"allow"` and `"deny"` respectively.
+</Note>
+
 #### `PostToolUse` Decision Control
 
-`PostToolUse` hooks can control whether a tool call proceeds.
+`PostToolUse` hooks can provide feedback to Claude after tool execution.
 
 * `"block"` automatically prompts Claude with `reason`.
 * `undefined` does nothing. `reason` is ignored.
+* `"hookSpecificOutput.additionalContext"` adds context for Claude to consider.
 
 ```json
 {
   "decision": "block" | undefined,
-  "reason": "Explanation for decision"
+  "reason": "Explanation for decision",
+  "hookSpecificOutput": {
+    "hookEventName": "PostToolUse",
+    "additionalContext": "Additional information for Claude"
+  }
 }
 ```
 
@@ -431,6 +467,7 @@ to Claude.
 `SessionStart` hooks allow you to load in context at the start of a session.
 
 * `"hookSpecificOutput.additionalContext"` adds the string to the context.
+* Multiple hooks' `additionalContext` values are concatenated.
 
 ```json
 {
@@ -441,6 +478,11 @@ to Claude.
 }
 ```
 
+#### `SessionEnd` Decision Control
+
+`SessionEnd` hooks run when a session ends. They cannot block session termination
+but can perform cleanup tasks.
+
 #### Exit Code Example: Bash Command Validation
 
 ```python
@@ -682,13 +724,15 @@ This prevents malicious hook modifications from affecting your current session.
 * **Timeout**: 60-second execution limit by default, configurable per command.
   * A timeout for an individual command does not affect the other commands.
 * **Parallelization**: All matching hooks run in parallel
+* **Deduplication**: Multiple identical hook commands are deduplicated automatically
 * **Environment**: Runs in current directory with Claude Code's environment
   * The `CLAUDE_PROJECT_DIR` environment variable is available and contains the
-    absolute path to the project root directory
+    absolute path to the project root directory (where Claude Code was started)
 * **Input**: JSON via stdin
 * **Output**:
-  * PreToolUse/PostToolUse/Stop: Progress shown in transcript (Ctrl-R)
-  * Notification: Logged to debug only (`--debug`)
+  * PreToolUse/PostToolUse/Stop/SubagentStop: Progress shown in transcript (Ctrl-R)
+  * Notification/SessionEnd: Logged to debug only (`--debug`)
+  * UserPromptSubmit/SessionStart: stdout added as context for Claude
 
 ## Debugging
 
diff --git a/docs/mcp.md b/docs/mcp.md
@@ -115,6 +115,22 @@ export const MCPServersTable = ({platform = "all"}) => {
       claudeDesktop: false
     },
     notes: "Multiple services available. See documentation for specific server URLs. Claude Code can use the Cloudflare CLI if installed."
+  }, {
+    name: "Cloudinary",
+    category: "Design & Media",
+    description: "Upload, manage, transform, and analyze your media assets",
+    documentation: "https://cloudinary.com/documentation/mcp_server",
+    urls: {
+      http: "https://mcp.cloudinary.com/mcp"
+    },
+    authentication: {
+      type: "oauth"
+    },
+    availability: {
+      claudeCode: true,
+      mcpConnector: true,
+      claudeDesktop: false
+    }
   }, {
     name: "Intercom",
     category: "Project Management & Documentation",
diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
@@ -15,6 +15,44 @@ You might encounter the following issues in WSL:
 
 **Node not found errors**: If you see `exec: node: not found` when running `claude`, your WSL environment may be using a Windows installation of Node.js. You can confirm this with `which npm` and `which node`, which should point to Linux paths starting with `/usr/` rather than `/mnt/c/`. To fix this, try installing Node via your Linux distribution's package manager or via [`nvm`](https://github.com/nvm-sh/nvm).
 
+**nvm version conflicts**: If you have nvm installed in both WSL and Windows, you may experience version conflicts when switching Node versions in WSL. This happens because WSL imports the Windows PATH by default, causing Windows nvm/npm to take priority over the WSL installation.
+
+You can identify this issue by:
+
+* Running `which npm` and `which node` - if they point to Windows paths (starting with `/mnt/c/`), Windows versions are being used
+* Experiencing broken functionality after switching Node versions with nvm in WSL
+
+To resolve this issue, fix your Linux PATH to ensure the Linux node/npm versions take priority:
+
+**Primary solution: Ensure nvm is properly loaded in your shell**
+
+The most common cause is that nvm isn't loaded in non-interactive shells. Add the following to your shell configuration file (`~/.bashrc`, `~/.zshrc`, etc.):
+
+```bash
+# Load nvm if it exists
+export NVM_DIR="$HOME/.nvm"
+[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
+[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
+```
+
+Or run directly in your current session:
+
+```bash
+source ~/.nvm/nvm.sh
+```
+
+**Alternative: Adjust PATH order**
+
+If nvm is properly loaded but Windows paths still take priority, you can explicitly prepend your Linux paths to PATH in your shell configuration:
+
+```bash
+export PATH="$HOME/.nvm/versions/node/$(node -v)/bin:$PATH"
+```
+
+<Warning>
+  Avoid disabling Windows PATH importing (`appendWindowsPath = false`) as this breaks the ability to easily call Windows executables from WSL. Similarly, avoid uninstalling Node.js from Windows if you use it for Windows development.
+</Warning>
+
 ### Linux and Mac installation issues: permission or command not found errors
 
 When installing Claude Code with npm, `PATH` problems may prevent access to `claude`.
@@ -169,6 +207,22 @@ pacman -S ripgrep
 
 Then set `USE_BUILTIN_RIPGREP=0` in your [environment](/en/docs/claude-code/settings#environment-variables).
 
+### Slow or incomplete search results on WSL
+
+Disk read performance penalties when [working across file systems on WSL](https://learn.microsoft.com/en-us/windows/wsl/filesystems) may result in fewer-than-expected matches (but not a complete lack of search functionality) when using Claude Code on WSL.
+
+<Note>
+  `/doctor` will show Search as OK in this case.
+</Note>
+
+**Solutions:**
+
+1. **Submit more specific searches**: Reduce the number of files searched by specifying directories or file types: "Search for JWT validation logic in the auth-service package" or "Find use of md5 hash in JS files".
+
+2. **Move project to Linux filesystem**: If possible, ensure your project is located on the Linux filesystem (`/home/`) rather than the Windows filesystem (`/mnt/c/`).
+
+3. **Use native Windows instead**: Consider running Claude Code natively on Windows instead of through WSL, for better file system performance.
+
 ## Markdown formatting issues
 
 Claude Code sometimes generates markdown files with missing language tags on code fences, which can affect syntax highlighting and readability in GitHub, editors, and documentation tools.
