Initial commit

skills/working-with-claude-code/references/security.md

@@ -0,0 +1,117 @@
+# Security
+
+> Learn about Claude Code's security safeguards and best practices for safe usage.
+
+## How we approach security
+
+### Security foundation
+
+Your code's security is paramount. Claude Code is built with security at its core, developed according to Anthropic's comprehensive security program. Learn more and access resources (SOC 2 Type 2 report, ISO 27001 certificate, etc.) at [Anthropic Trust Center](https://trust.anthropic.com).
+
+### Permission-based architecture
+
+Claude Code uses strict read-only permissions by default. When additional actions are needed (editing files, running tests, executing commands), Claude Code requests explicit permission. Users control whether to approve actions once or allow them automatically.
+
+We designed Claude Code to be transparent and secure. For example, we require approval for bash commands before executing them, giving you direct control. This approach enables users and organizations to configure permissions directly.
+
+For detailed permission configuration, see [Identity and Access Management](/en/docs/claude-code/iam).
+
+### Built-in protections
+
+To mitigate risks in agentic systems:
+
+* **Write access restriction**: Claude Code can only write to the folder where it was started and its subfolders—it cannot modify files in parent directories without explicit permission. While Claude Code can read files outside the working directory (useful for accessing system libraries and dependencies), write operations are strictly confined to the project scope, creating a clear security boundary
+* **Prompt fatigue mitigation**: Support for allowlisting frequently used safe commands per-user, per-codebase, or per-organization
+* **Accept Edits mode**: Batch accept multiple edits while maintaining permission prompts for commands with side effects
+
+### User responsibility
+
+Claude Code only has the permissions you grant it. You're responsible for reviewing proposed code and commands for safety before approval.
+
+## Protect against prompt injection
+
+Prompt injection is a technique where an attacker attempts to override or manipulate an AI assistant's instructions by inserting malicious text. Claude Code includes several safeguards against these attacks:
+
+### Core protections
+
+* **Permission system**: Sensitive operations require explicit approval
+* **Context-aware analysis**: Detects potentially harmful instructions by analyzing the full request
+* **Input sanitization**: Prevents command injection by processing user inputs
+* **Command blocklist**: Blocks risky commands that fetch arbitrary content from the web like `curl` and `wget` by default. When explicitly allowed, be aware of [permission pattern limitations](/en/docs/claude-code/iam#tool-specific-permission-rules)
+
+### Privacy safeguards
+
+We have implemented several safeguards to protect your data, including:
+
+* Limited retention periods for sensitive information (see the [Privacy Center](https://privacy.anthropic.com/en/articles/10023548-how-long-do-you-store-my-data) to learn more)
+* Restricted access to user session data
+* User control over data training preferences. Consumer users can change their [privacy settings](https://claude.ai/settings/privacy) at any time.
+
+For full details, please review our [Commercial Terms of Service](https://www.anthropic.com/legal/commercial-terms) (for Team, Enterprise, and API users) or [Consumer Terms](https://www.anthropic.com/legal/consumer-terms) (for Free, Pro, and Max users) and [Privacy Policy](https://www.anthropic.com/legal/privacy).
+
+### Additional safeguards
+
+* **Network request approval**: Tools that make network requests require user approval by default
+* **Isolated context windows**: Web fetch uses a separate context window to avoid injecting potentially malicious prompts
+* **Trust verification**: First-time codebase runs and new MCP servers require trust verification
+  * Note: Trust verification is disabled when running non-interactively with the `-p` flag
+* **Command injection detection**: Suspicious bash commands require manual approval even if previously allowlisted
+* **Fail-closed matching**: Unmatched commands default to requiring manual approval
+* **Natural language descriptions**: Complex bash commands include explanations for user understanding
+* **Secure credential storage**: API keys and tokens are encrypted. See [Credential Management](/en/docs/claude-code/iam#credential-management)
+
+**Best practices for working with untrusted content**:
+
+1. Review suggested commands before approval
+2. Avoid piping untrusted content directly to Claude
+3. Verify proposed changes to critical files
+4. Use virtual machines (VMs) to run scripts and make tool calls, especially when interacting with external web services
+5. Report suspicious behavior with `/bug`
+
+<Warning>
+  While these protections significantly reduce risk, no system is completely
+  immune to all attacks. Always maintain good security practices when working
+  with any AI tool.
+</Warning>
+
+## MCP security
+
+Claude Code allows users to configure Model Context Protocol (MCP) servers. The list of allowed MCP servers is configured in your source code, as part of Claude Code settings engineers check into source control.
+
+We encourage either writing your own MCP servers or using MCP servers from providers that you trust. You are able to configure Claude Code permissions for MCP servers. Anthropic does not manage or audit any MCP servers.
+
+## IDE security
+
+See [here](/en/docs/claude-code/ide-integrations#security) for more information on the security of running Claude Code in an IDE.
+
+## Security best practices
+
+### Working with sensitive code
+
+* Review all suggested changes before approval
+* Use project-specific permission settings for sensitive repositories
+* Consider using [devcontainers](/en/docs/claude-code/devcontainer) for additional isolation
+* Regularly audit your permission settings with `/permissions`
+
+### Team security
+
+* Use [enterprise managed policies](/en/docs/claude-code/iam#enterprise-managed-policy-settings) to enforce organizational standards
+* Share approved permission configurations through version control
+* Train team members on security best practices
+* Monitor Claude Code usage through [OpenTelemetry metrics](/en/docs/claude-code/monitoring-usage)
+
+### Reporting security issues
+
+If you discover a security vulnerability in Claude Code:
+
+1. Do not disclose it publicly
+2. Report it through our [HackerOne program](https://hackerone.com/anthropic-vdp/reports/new?type=team\&report_type=vulnerability)
+3. Include detailed reproduction steps
+4. Allow time for us to address the issue before public disclosure
+
+## Related resources
+
+* [Identity and Access Management](/en/docs/claude-code/iam) - Configure permissions and access controls
+* [Monitoring usage](/en/docs/claude-code/monitoring-usage) - Track and audit Claude Code activity
+* [Development containers](/en/docs/claude-code/devcontainer) - Secure, isolated environments
+* [Anthropic Trust Center](https://trust.anthropic.com) - Security certifications and compliance