{/* TRANSLATED — 已翻译为中文 */}

> ## 文档索引
> 在此获取完整文档索引：https://code.claude.com/docs/llms.txt
> 使用此文件发现所有可用页面，然后再进一步探索。

# 概述

> Claude Code 是一个智能体编程工具，可以读取你的代码库、编辑文件、运行命令，并与你的开发工具集成。可在终端、IDE、桌面应用和浏览器中使用。

Claude Code 是一个 AI 驱动的编程助手，帮助你构建功能、修复缺陷和自动化开发任务。它能理解你的整个代码库，可以跨多个文件和工具协同工作以完成任务。

## 快速开始

选择你的环境开始使用。大多数界面需要 [Claude 订阅](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=overview_pricing) 或 [Anthropic Console](https://console.anthropic.com/) 账户。终端 CLI 和 VS Code 也支持[第三方提供商](/en/third-party-integrations)。

<Tabs>
  <Tab title="终端">
    功能齐全的 CLI，可直接在终端中使用 Claude Code。编辑文件、运行命令，从命令行管理整个项目。

    要安装 Claude Code，请使用以下方法之一：

    <Tabs>
      <Tab title="原生安装（推荐）">
        **macOS、Linux、WSL：**

        ```bash theme={null}
        curl -fsSL https://claude.ai/install.sh | bash
        ```

        **Windows PowerShell：**

        ```powershell theme={null}
        irm https://claude.ai/install.ps1 | iex
        ```

        **Windows CMD：**

        ```batch theme={null}
        curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
        ```

        如果你看到 `The token '&&' is not a valid statement separator`，说明你在 PowerShell 中，而不是 CMD。如果你看到 `'irm' is not recognized as an internal or external command`，说明你在 CMD 中，而不是 PowerShell。在 PowerShell 中提示符显示 `PS C:\`，在 CMD 中显示 `C:\`（没有 `PS`）。

        在原生 Windows 上建议安装 [Git for Windows](https://git-scm.com/downloads/win)，以便 Claude Code 使用 Bash 工具。如果未安装 Git for Windows，Claude Code 将改用 PowerShell 作为 shell 工具。WSL 环境不需要 Git for Windows。

        <Info>
          原生安装会在后台自动更新，确保你使用的是最新版本。
        </Info>
      </Tab>

      <Tab title="Homebrew">
        ```bash theme={null}
        brew install --cask claude-code
        ```

        Homebrew 提供两个 cask。`claude-code` 跟踪稳定发布渠道，通常落后约一周，并跳过有重大回退的版本。`claude-code@latest` 跟踪最新渠道，新版本发布后立即接收。

        <Info>
          Homebrew 安装不会自动更新。根据你安装的 cask，运行 `brew upgrade claude-code` 或 `brew upgrade claude-code@latest` 以获取最新功能和安全修复。
        </Info>
      </Tab>

      <Tab title="WinGet">
        ```powershell theme={null}
        winget install Anthropic.ClaudeCode
        ```

        <Info>
          WinGet 安装不会自动更新。定期运行 `winget upgrade Anthropic.ClaudeCode` 以获取最新功能和安全修复。
        </Info>
      </Tab>
    </Tabs>

    你也可以在 Debian、Fedora、RHEL 和 Alpine 上使用 [apt、dnf 或 apk](/en/setup#install-with-linux-package-managers) 安装。

    然后在任何项目中启动 Claude Code：

    ```bash theme={null}
    cd your-project
    claude
    ```

    首次使用时会提示你登录。就这样！[继续快速入门 →](/en/quickstart)

    <Tip>
      参见[高级设置](/en/setup)了解安装选项、手动更新或卸载说明。如遇问题请访问[安装故障排除](/en/troubleshoot-install)。
    </Tip>
  </Tab>

  <Tab title="VS Code">
    VS Code 扩展提供内联差异对比、@提及、计划审查和对话历史，直接在编辑器中使用。

    * [为 VS Code 安装](vscode:extension/anthropic.claude-code)
    * [为 Cursor 安装](cursor:extension/anthropic.claude-code)

    或在扩展视图中搜索 "Claude Code"（Mac 上按 `Cmd+Shift+X`，Windows/Linux 上按 `Ctrl+Shift+X`）。安装后，打开命令面板（`Cmd+Shift+P` / `Ctrl+Shift+P`），输入 "Claude Code"，选择 **Open in New Tab**。

    [VS Code 快速入门 →](/en/vs-code#get-started)
  </Tab>

  <Tab title="桌面应用">
    一个独立应用，可在 IDE 或终端之外运行 Claude Code。可视化查看差异对比、并排运行多个会话、调度定期任务和启动云端会话。

    下载并安装：

    * [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs)（Intel 和 Apple Silicon）
    * [Windows](https://claude.ai/api/desktop/win32/x64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs)（x64）
    * [Windows ARM64](https://claude.ai/api/desktop/win32/arm64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs)

    安装后，启动 Claude，登录并点击 **Code** 标签页开始编程。需要[付费订阅](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=overview_desktop_pricing)。

    [了解更多关于桌面应用 →](/en/desktop-quickstart)
  </Tab>

  <Tab title="网页版">
    在浏览器中运行 Claude Code，无需本地设置。启动长时间运行的任务，完成后回来查看；处理你本地没有的仓库；或并行运行多个任务。支持桌面浏览器和 Claude iOS 应用。

    在 [claude.ai/code](https://claude.ai/code) 开始编程。

    [网页版快速入门 →](/en/web-quickstart)
  </Tab>

  <Tab title="JetBrains">
    适用于 IntelliJ IDEA、PyCharm、WebStorm 和其他 JetBrains IDE 的插件，支持交互式差异查看和选择上下文共享。

    从 JetBrains Marketplace 安装 [Claude Code 插件](https://plugins.jetbrains.com/plugin/27310-claude-code-beta-) 并重启 IDE。

    [JetBrains 快速入门 →](/en/jetbrains)
  </Tab>
</Tabs>

## 你可以做什么

以下是你使用 Claude Code 的一些方式：

<AccordionGroup>
  <Accordion title="自动化你一直推迟的工作" icon="wand-magic-sparkles">
    Claude Code 处理那些占用你一天时间的繁琐任务：为未测试的代码编写测试、修复整个项目的 lint 错误、解决合并冲突、更新依赖项和编写发布说明。

    ```bash theme={null}
    claude "write tests for the auth module, run them, and fix any failures"
    ```
  </Accordion>

  <Accordion title="构建功能和修复缺陷" icon="hammer">
    用自然语言描述你想要的内容。Claude Code 规划方案，跨多个文件编写代码，并验证其是否有效。

    对于缺陷，粘贴错误消息或描述症状。Claude Code 在代码库中追踪问题，识别根本原因并实施修复。参见[常见工作流](/en/common-workflows)了解更多示例。
  </Accordion>

  <Accordion title="创建提交和拉取请求" icon="code-branch">
    Claude Code 直接与 git 协作。它暂存更改、编写提交消息、创建分支和打开拉取请求。

    ```bash theme={null}
    claude "commit my changes with a descriptive message"
    ```

    在 CI 中，你可以使用 [GitHub Actions](/en/github-actions) 或 [GitLab CI/CD](/en/gitlab-ci-cd) 自动化代码审查和问题分流。
  </Accordion>

  <Accordion title="通过 MCP 连接你的工具" icon="plug">
    [模型上下文协议 (MCP)](/en/mcp) 是一个开放标准，用于将 AI 工具连接到外部数据源。通过 MCP，Claude Code 可以在 Google Drive 中读取设计文档、在 Jira 中更新工单、从 Slack 中拉取数据，或使用你自己的自定义工具。
  </Accordion>

  <Accordion title="使用指令、技能和钩子进行自定义" icon="sliders">
    [`CLAUDE.md`](/en/memory) 是你添加到项目根目录的 markdown 文件，Claude Code 在每次会话开始时读取它。用它来设置编码标准、架构决策、首选库和审查清单。Claude 还会在工作过程中构建[自动记忆](/en/memory#auto-memory)，跨会话保存学习成果（如构建命令和调试见解），无需你编写任何内容。

    创建[技能](/en/skills)来打包可重复的工作流，供你的团队共享，如 `/review-pr` 或 `/deploy-staging`。

    [钩子](/en/hooks)允许你在 Claude Code 操作之前或之后运行 shell 命令，例如每次文件编辑后自动格式化或提交前运行 lint。
  </Accordion>

  <Accordion title="运行智能体团队和构建自定义智能体" icon="users">
    生成[多个 Claude Code 智能体](/en/sub-agents)同时处理任务的不同部分。一个主智能体协调工作、分配子任务并合并结果。

    要并行运行多个完整会话并在一个屏幕上查看它们，请使用[后台智能体](/en/agent-view)。对于完全自定义的工作流，[Agent SDK](/en/agent-sdk/overview) 允许你使用 Claude Code 的工具和功能构建自己的智能体，完全控制编排、工具访问和权限。
  </Accordion>

  <Accordion title="通过 CLI 进行管道、脚本和自动化" icon="terminal">
    Claude Code 可组合且遵循 Unix 哲学。将日志导入其中，在 CI 中运行，或与其他工具链接：

    ```bash theme={null}
    # 分析最近的日志输出
    tail -200 app.log | claude -p "Slack me if you see any anomalies"

    # 在 CI 中自动翻译
    claude -p "translate new strings into French and raise a PR for review"

    # 跨文件批量操作
    git diff main --name-only | claude -p "review these changed files for security issues"
    ```

    参见 [CLI 参考](/en/cli-reference)了解完整的命令和标志集。
  </Accordion>

  <Accordion title="调度定期任务" icon="clock">
    按计划运行 Claude 以自动化重复工作：早晨 PR 审查、夜间 CI 失败分析、每周依赖审计，或 PR 合并后同步文档。

    * [例行任务](/en/routines)在 Anthropic 管理的基础设施上运行，即使你的电脑关机也会继续运行。它们还可以通过 API 调用或 GitHub 事件触发。从网页、桌面应用或在 CLI 中运行 `/schedule` 来创建。
    * [桌面计划任务](/en/desktop-scheduled-tasks)在你的机器上运行，可直接访问你的本地文件和工具
    * [`/loop`](/en/scheduled-tasks)在 CLI 会话中重复提示，用于快速轮询
  </Accordion>

  <Accordion title="随时随地工作" icon="globe">
    会话不局限于单一界面。随着环境变化在不同界面之间切换工作：

    * 离开办公桌，通过[远程控制](/en/remote-control)从手机或任何浏览器继续工作
    * 从手机向 [Dispatch](/en/desktop#sessions-from-dispatch) 发送任务，然后打开它创建的桌面会话
    * 在[网页版](/en/claude-code-on-the-web)或 [iOS 应用](https://apps.apple.com/app/claude-by-anthropic/id6473753684)启动长时间运行的任务，然后通过 `claude --teleport` 将其拉入终端
    * 通过 `/desktop` 将终端会话移交给[桌面应用](/en/desktop)以进行可视化差异审查
    * 从团队聊天中路由任务：在 [Slack](/en/slack) 中提及 `@Claude` 并附上缺陷报告，即可获得拉取请求
  </Accordion>
</AccordionGroup>

## 随处使用 Claude Code

每个界面都连接到相同的底层 Claude Code 引擎，因此你的 CLAUDE.md 文件、设置和 MCP 服务器在所有界面上都有效。

除了上面的[终端](/en/quickstart)、[VS Code](/en/vs-code)、[JetBrains](/en/jetbrains)、[桌面应用](/en/desktop)和[网页版](/en/claude-code-on-the-web)环境外，Claude Code 还与 CI/CD、聊天和浏览器工作流集成：

| 我想要... | 最佳选择 |
| --- | --- |
| 从手机或其他设备继续本地会话 | [远程控制](/en/remote-control) |
| 将 Telegram、Discord、iMessage 或自己的 webhook 事件推送到会话 | [频道](/en/channels) |
| 在本地启动任务，在移动端继续 | [网页版](/en/claude-code-on-the-web) 或 [Claude iOS 应用](https://apps.apple.com/app/claude-by-anthropic/id6473753684) |
| 按定期计划运行 Claude | [例行任务](/en/routines) 或 [桌面计划任务](/en/desktop-scheduled-tasks) |
| 自动化 PR 审查和问题分流 | [GitHub Actions](/en/github-actions) 或 [GitLab CI/CD](/en/gitlab-ci-cd) |
| 在每个 PR 上获得自动代码审查 | [GitHub 代码审查](/en/code-review) |
| 将 Slack 中的缺陷报告路由到拉取请求 | [Slack](/en/slack) |
| 调试实时 Web 应用 | [Chrome](/en/chrome) |
| 为你的工作流构建自定义智能体 | [Agent SDK](/en/agent-sdk/overview) |

## 后续步骤

安装 Claude Code 后，这些指南将帮助你深入了解。

* [快速入门](/en/quickstart)：完成你的第一个真实任务，从探索代码库到提交修复
* [存储指令和记忆](/en/memory)：通过 CLAUDE.md 文件和自动记忆为 Claude 提供持久指令
* [常见工作流](/en/common-workflows)和[最佳实践](/en/best-practices)：充分利用 Claude Code 的模式
* [设置](/en/settings)：为你的工作流自定义 Claude Code
* [故障排除](/en/troubleshooting)：常见问题的解决方案
* [code.claude.com](https://code.claude.com/)：演示、定价和产品详情