{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Claude Code Integration","description":"Control the power of AI Agents in runtime.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"claude-code-integration","__idx":0},"children":["Claude Code Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Connect Claude Code to Capsule Security for complete visibility into AI coding assistant activity, including prompts, tool execution, session lifecycle, and MCP tool usage."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This integration uses Claude Code's hooks system to capture AI coding assistant activity. Hooks are shell commands that execute at specific points in Claude Code's lifecycle, providing automated workflows and audit capabilities."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/claude-code.2f595d998fc5e82008d2375e30b9d9c5865e6cf0c3368d09b195dc8ea952803a.9c1bb791.png","alt":"Claude Code Hooks"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following hooks are configured:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Hook Event"},"children":["Hook Event"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SessionStart"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Session initialization and context with MCP tools definitions"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["UserPromptSubmit"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["User prompts before submission to Claude"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PreToolUse"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tool execution requests (before execution)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PostToolUse"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tool execution results (after successful completion)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Stop"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Agent stop events when the agent finished responding"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SessionEnd"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Session termination and cleanup"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":2},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before you begin, ensure you have:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Claude Code"]}," installed"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Capsule Security"]}," account with admin access"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1-generate-the-configuration","__idx":3},"children":["Step 1: Generate the Configuration"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Log in to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Capsule Security"]}," portal"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Integrations"]}," and locate ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Claude Code"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Install"]}," — Capsule automatically generates a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["managed-settings.json"]}," file containing:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Hook commands for all lifecycle events"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An embedded authentication token scoped to your organization"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Platform-specific scripts (bash for macOS/Linux, PowerShell for Windows)"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select your target platform (",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["macOS"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Linux"]},", or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Windows"]},") to download the configuration file"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2-deploy-the-configuration","__idx":4},"children":["Step 2: Deploy the Configuration"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"deployment-methods","__idx":5},"children":["Deployment Methods"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"remote-managed-settings-recommended-for-enterprise","__idx":6},"children":["Remote Managed Settings (Recommended for Enterprise)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Enterprise organizations with Claude Code Pro can use remote managed settings to centrally control and distribute hooks across the organization."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Overview:"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Remote managed settings are configured via the Claude.ai admin console and automatically fetched when users authenticate. This method provides the highest level of security and control by:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enforcing organization-wide hook policies that cannot be overridden by users"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Automatically synchronizing configurations to all authenticated team members"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Allowing strict control over which hooks are permitted to run"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Blocking user, project, and plugin hooks when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowManagedHooksOnly"]}," is enabled"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Setup:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Access the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Claude.ai admin console"]}," with your enterprise administrator account"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Navigate to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings"]}," section"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Configure the hooks provided by Capsule Security with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowManagedHooksOnly"]}," enabled:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"allowManagedHooksOnly\": true,\n  \"hooks\": {\n    \"UserPromptSubmit\": [...],\n    \"PreToolUse\": [...],\n    \"PostToolUse\": [...],\n    \"SessionStart\": [...],\n    \"SessionEnd\": [...]\n  }\n}\n","lang":"json"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Save and publish the configuration"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Behavior:"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowManagedHooksOnly"]}," is set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Managed hooks"]}," (configured via admin console) are loaded and executed"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["User hooks"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["~/.claude/settings.json"]},") are blocked"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Project hooks"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".claude/settings.json"]},") are blocked"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Plugin hooks"]}," are blocked"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This ensures only administrator-approved hooks run, preventing users from disabling or circumventing the Capsule Security integration."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings Precedence:"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Claude Code applies settings in the following order (highest to lowest):"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Remote managed settings"]}," - Cannot be overridden"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["File-based managed settings"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["managed-settings.json"]},") - Ignored when remote managed settings are configured"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Command line arguments"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Local project settings (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".claude/settings.local.json"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Shared project settings (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".claude/settings.json"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["User settings (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["~/.claude/settings.json"]},")"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Key Features:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Centralized management through Claude.ai admin console"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Automatic synchronization to all authenticated team members"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Cannot be overridden by users or project settings"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enforces enterprise security policies across the organization"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["No manual deployment to individual machines required"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"mdm-distribution-with-user-settings","__idx":7},"children":["MDM Distribution with User Settings"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For organizations without Claude Code Enterprise or those preferring traditional MDM deployment, use Mobile Device Management tools to deploy hooks to user settings files."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Setup:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Deploy the downloaded ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["managed-settings.json"]}," file to the appropriate path for your platform:"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Platform"},"children":["Platform"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Path"},"children":["Path"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["macOS"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/Library/Application Support/ClaudeCode/managed-settings.json"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Linux / WSL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/etc/claude-code/managed-settings.json"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Windows"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["C:\\Program Files\\ClaudeCode\\managed-settings.json"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use your organization's device management solution (Jamf, Intune, SCCF, etc.) to distribute the file to all developer machines. Set appropriate file permissions (read-only recommended)."]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Include the hooks configuration provided by Capsule Security in the deployed file"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Set appropriate file permissions (read-only recommended to prevent user modifications)"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Limitations:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Users can potentially override or disable hooks with project-level settings (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".claude/settings.json"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Users can add local overrides via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".claude/settings.local.json"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Requires MDM infrastructure capable of deploying user-level configuration files"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Manual updates required when hooks configuration changes"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Key Considerations:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Centrally managed by your IT or security team"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your organization is responsible for deployment and updates"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Less secure than Option A as users may override settings"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Suitable when remote managed settings are not available"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-3-restart-claude-code","__idx":8},"children":["Step 3: Restart Claude Code"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the hooks to take effect:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Exit Claude Code by pressing ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Ctrl+C"]}," or typing ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/exit"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Restart Claude Code"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-4-verify-the-installation","__idx":9},"children":["Step 4: Verify the Installation"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Run ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/hooks"]}," in Claude Code to confirm all hooks are listed"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Start a session and execute a simple task to generate activity:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Create a new file called test.txt with the content \"Hello World\"\n"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Log in to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Capsule Security"]}," portal"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Inventory > Agents"]}," and confirm your Claude Code agent appears"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click on the agent and review the audit logs to verify events are captured:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Session start event"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["User prompt"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Tool execution (Write tool)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Session activity"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To view the full conversation, navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Observability"]}," and filter by ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Activity Type — Session"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"troubleshooting","__idx":10},"children":["Troubleshooting"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If events are not appearing:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Verify the managed-settings.json is in the correct path"]}," for your platform (see Step 2)"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Check file permissions"]}," — the file must be readable by the user running Claude Code"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Verify settings file syntax"]}," — ensure the file contains valid JSON:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"cat \"/Library/Application Support/ClaudeCode/managed-settings.json\" | python3 -m json.tool\n","lang":"bash"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Run ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/hooks"]}," in Claude Code"]}," — if no hooks are listed, the file is not being loaded"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Check Claude Code logs"]}," for hook execution errors"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Contact Capsule Security support"]}," if issues persist"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"security-considerations","__idx":11},"children":["Security Considerations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Claude Code hooks execute with your current environment credentials. Before deploying hooks:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Review all hook scripts"]}," provided by Capsule Security"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Verify the endpoint URL"]}," matches your organization's Capsule instance"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Protect authentication tokens"]}," used by hooks (never commit to version control)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".claude/settings.local.json"]}]}," for sensitive configuration values"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Ensure ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".claude/settings.local.json"]}," is in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".gitignore"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"support","__idx":12},"children":["Support"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For help with this integration:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Email"]},": support@capsule.security"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Include"]},": Your organization ID, integration status, and any error messages"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"references","__idx":13},"children":["References"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://code.claude.com/docs/en/hooks"},"children":["Claude Code Hooks Documentation"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://code.claude.com/docs/en/hooks-guide"},"children":["Claude Code Hooks Guide"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://code.claude.com/docs/en/settings"},"children":["Claude Code Settings"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://code.claude.com/docs/en/settings#hook-configuration"},"children":["Claude Code Hook Configuration"]}]}]}]},"headings":[{"value":"Claude Code Integration","id":"claude-code-integration","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Step 1: Generate the Configuration","id":"step-1-generate-the-configuration","depth":2},{"value":"Step 2: Deploy the Configuration","id":"step-2-deploy-the-configuration","depth":2},{"value":"Deployment Methods","id":"deployment-methods","depth":3},{"value":"Remote Managed Settings (Recommended for Enterprise)","id":"remote-managed-settings-recommended-for-enterprise","depth":4},{"value":"MDM Distribution with User Settings","id":"mdm-distribution-with-user-settings","depth":4},{"value":"Step 3: Restart Claude Code","id":"step-3-restart-claude-code","depth":2},{"value":"Step 4: Verify the Installation","id":"step-4-verify-the-installation","depth":2},{"value":"Troubleshooting","id":"troubleshooting","depth":3},{"value":"Security Considerations","id":"security-considerations","depth":2},{"value":"Support","id":"support","depth":2},{"value":"References","id":"references","depth":2}],"frontmatter":{"seo":{"title":"Claude Code Integration"}},"lastModified":"2026-02-26T17:01:12.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/claude-code","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}