| --- |
| license: other |
| license_name: anthropic-commercial-terms |
| license_link: https://www.anthropic.com/legal/commercial-terms |
| tags: |
| - agent |
| - coding-agent |
| - cli |
| --- |
| |
| > **This is a source mirror — partial, by necessity.** This Hugging Face repository is not a model checkpoint — it's a read-only mirror of the [`anthropics/claude-code`](https://github.com/anthropics/claude-code) GitHub repository. Claude Code's core agent is closed-source and distributed as an npm package; this GitHub repo (and this mirror) contains only the public surrounding material — docs, examples, plugins, and scripts — not the agent engine itself. Licensed under Anthropic's [Commercial Terms of Service](https://www.anthropic.com/legal/commercial-terms), not an open-source license. File issues and contribute on GitHub, not here. |
|
|
| # Claude Code |
|
|
|  [![npm]](https://www.npmjs.com/package/@anthropic-ai/claude-code) |
|
|
| [npm]: https://img.shields.io/npm/v/@anthropic-ai/claude-code.svg?style=flat-square |
|
|
| Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows -- all through natural language commands. Use it in your terminal, IDE, or tag @claude on Github. |
|
|
| **Learn more in the [official documentation](https://code.claude.com/docs/en/overview)**. |
|
|
| <img src="./demo.gif" /> |
|
|
| ## Get started |
| > [!NOTE] |
| > Installation via npm is deprecated. Use one of the recommended methods below. |
|
|
| For more installation options, uninstall steps, and troubleshooting, see the [setup documentation](https://code.claude.com/docs/en/setup). |
|
|
| 1. Install Claude Code: |
|
|
| **MacOS/Linux (Recommended):** |
| ```bash |
| curl -fsSL https://claude.ai/install.sh | bash |
| ``` |
| |
| **Homebrew (MacOS/Linux):** |
| ```bash |
| brew install --cask claude-code |
| ``` |
| |
| **Windows (Recommended):** |
| ```powershell |
| irm https://claude.ai/install.ps1 | iex |
| ``` |
| |
| **WinGet (Windows):** |
| ```powershell |
| winget install Anthropic.ClaudeCode |
| ``` |
| |
| **NPM (Deprecated):** |
| ```bash |
| npm install -g @anthropic-ai/claude-code |
| ``` |
| |
| 2. Navigate to your project directory and run `claude`. |
|
|
| ## Plugins |
|
|
| This repository includes several Claude Code plugins that extend functionality with custom commands and agents. See the [plugins directory](./plugins/README.md) for detailed documentation on available plugins. |
|
|
| ## Reporting Bugs |
|
|
| We welcome your feedback. Use the `/bug` command to report issues directly within Claude Code, or file a [GitHub issue](https://github.com/anthropics/claude-code/issues). |
|
|
| ## Connect on Discord |
|
|
| Join the [Claude Developers Discord](https://anthropic.com/discord) to connect with other developers using Claude Code. Get help, share feedback, and discuss your projects with the community. |
|
|
| ## Data collection, usage, and retention |
|
|
| When you use Claude Code, we collect feedback, which includes usage data (such as code acceptance or rejections), associated conversation data, and user feedback submitted via the `/bug` command. |
|
|
| ### How we use your data |
|
|
| See our [data usage policies](https://code.claude.com/docs/en/data-usage). |
|
|
| ### Privacy safeguards |
|
|
| We have implemented several safeguards to protect your data, including limited retention periods for sensitive information, restricted access to user session data, and clear policies against using feedback for model training. |
|
|
| For full details, please review our [Commercial Terms of Service](https://www.anthropic.com/legal/commercial-terms) and [Privacy Policy](https://www.anthropic.com/legal/privacy). |
|
|
