概述

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

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

开始使用

Claude Code 在多个平台上运行：终端、IDE 扩展、桌面应用和网络。从下面的标签页中选择一个来开始使用。大多数平台需要 Claude 订阅或 Anthropic 控制台账户。终端 CLI、VS Code 和 JetBrains 也支持第三方提供商。

功能完整的 CLI，用于直接在终端中使用 Claude Code。编辑文件、运行命令，并从命令行管理整个项目。

要安装 Claude Code，请打开终端并运行适用于您的系统的命令。如果您之前没有使用过终端，终端指南会展示如何打开终端并粘贴命令。

macOS、Linux、WSL：

curl -fsSL https://claude.ai/install.sh | bash

在 Windows 上，当您在 PowerShell 中时，您的提示符显示 PS C:\；当您在 CMD 中时，提示符显示 C:\（没有 PS）。

Windows PowerShell：

irm https://claude.ai/install.ps1 | iex

Windows CMD：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

安装程序完成后，打开一个新的终端窗口并运行 claude --version。正常的安装会打印一个版本号。如果您的 shell 显示找不到 claude 或无法识别，说明安装目录还不在您的 PATH 中：请参阅修复您的 PATH。

如果您看到 The token '&&' is not a valid statement separator，说明您在 PowerShell 中，而不是 CMD。如果您看到 'irm' is not recognized as an internal or external command，说明您在 CMD 中，而不是 PowerShell。

如果安装命令失败并显示 syntax error near unexpected token '<'、403 或其他任何错误，请参阅排查安装问题以匹配错误并获得修复方案和替代安装方法。

建议在原生 Windows 上安装 Git for Windows，以便 Claude Code 可以使用 Bash 工具。如果未安装 Git for Windows，Claude Code 将使用 PowerShell 作为 shell 工具。WSL 设置不需要 Git for Windows。

brew install --cask claude-code

Homebrew 提供两个 casks。claude-code 跟踪稳定发布渠道，通常比最新版本晚约一周，并跳过有重大回归的版本。claude-code@latest 跟踪最新渠道，在新版本发布时立即接收。

winget install Anthropic.ClaudeCode

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

然后在任何项目中启动 Claude Code。将 `your-project` 替换为你机器上项目目录的路径：

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

首次使用时，Claude Code 会提示您登录。如果您已设置 `ANTHROPIC_API_KEY` 环境变量，并在 Claude Code 询问是否使用该密钥时予以批准，Claude Code 将跳过登录提示。[继续快速入门 →](/docs/zh-CN/quickstart)

<Tip>
  查看[高级设置](/docs/zh-CN/setup)了解安装选项、手动更新或卸载说明。如果遇到问题，请访问[安装故障排除](/docs/zh-CN/troubleshoot-install)。
</Tip>

VS Code 扩展在编辑器中直接提供内联差异、@-提及、计划审查和对话历史。

或在扩展视图中搜索"Claude Code"（Mac 上为 Cmd+Shift+X，Windows/Linux 上为 Ctrl+Shift+X）。安装后，打开命令面板（Cmd+Shift+P / Ctrl+Shift+P），输入"Claude Code"，然后选择在新标签页中打开。

开始使用 VS Code →

一个独立应用，用于在 IDE 或终端之外运行 Claude Code。直观地查看差异、并行运行多个会话、安排定期任务，并启动云会话。

下载并安装：

macOS（Intel 和 Apple Silicon）
Windows（x64）
Windows ARM64
在 Ubuntu 或 Debian 上，该应用处于测试阶段，可通过 apt 安装，请按照 Linux 安装说明进行操作

安装后，启动 Claude，登录，然后点击代码标签开始编码。该应用包含 Claude Code，因此你无需单独安装 CLI。需要付费订阅。

了解更多关于桌面应用的信息 →

在浏览器中运行 Claude Code，无需本地设置。启动长时间运行的任务，完成后再检查，处理你本地没有的仓库，或并行运行多个任务。对于较长的工作，创建一个项目，让 Claude 为你协调并行会话。可在桌面浏览器和 Claude iOS 和 Android 应用中使用。

在 claude.ai/code 开始编码。

开始在网络上使用 →

一个用于 IntelliJ IDEA、PyCharm、WebStorm 和其他 JetBrains IDE 的插件，具有交互式差异查看和选择上下文共享。

从 JetBrains Marketplace 安装 Claude Code 插件，然后重启你的 IDE。该插件需要单独安装 Claude Code CLI；请参阅 JetBrains 设置步骤。

开始使用 JetBrains →

你可以做什么

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

Claude Code 处理那些占用你一整天的繁琐任务：为未测试的代码编写测试、修复项目中的 lint 错误、解决合并冲突、更新依赖项和编写发布说明。

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

构建功能和修复错误

用简单的语言描述你想要的内容。Claude Code 规划方法、跨多个文件编写代码，并验证其工作。

对于错误，粘贴错误消息或描述症状。Claude Code 通过你的代码库追踪问题、识别根本原因并实施修复。查看常见工作流了解更多示例。

创建提交和拉取请求

Claude Code 直接与 git 配合工作。它暂存更改、编写提交消息、创建分支并打开拉取请求。

claude "commit my changes with a descriptive message"

在 CI 中，您可以使用 GitHub Actions 或 GitLab CI/CD 自动化代码审查和问题分类。

使用 MCP 连接您的工具

Model Context Protocol (MCP) 是一个开放标准，用于将 AI 工具连接到外部数据源。使用 MCP，Claude Code 可以读取 Google Drive 中的设计文档、更新 Jira 中的工单、从 Slack 拉取数据，或使用您自己的自定义工具。MCP 快速入门将端到端地连接您的第一个服务器。

使用指令、skill 和 hook 进行自定义

CLAUDE.md 是一个 markdown 文件，您可以将其添加到项目根目录，Claude Code 会在每个会话开始时读取它。使用它来设置编码标准、架构决策、首选库和审查清单。如果您的仓库已经有一个供其他编码 Agent 使用的 AGENTS.md，Claude Code 可以读取它来代替 CLAUDE.md。Claude 还会在工作时构建自动记忆，跨会话保存所学内容，无需您编写任何内容。

创建 skills 来打包你的团队可以共享的可重复工作流，如 /review-pr 或 /deploy-staging。

Hooks 让你在 Claude Code 操作之前或之后运行 shell 命令，如在每次文件编辑后自动格式化或在提交前运行 lint。

运行代理团队并构建自定义代理

生成多个 Claude Code 代理，同时处理任务的不同部分。主导代理协调工作、分配子任务并合并结果。

要在并行中运行多个完整会话并从一个屏幕观看它们，请使用后台代理。对于完全自定义的工作流，Agent SDK 让你构建由 Claude Code 的工具和功能驱动的自己的代理，完全控制编排、工具访问和权限。

使用 CLI 进行管道、脚本和自动化

Claude Code 是可组合的，遵循 Unix 哲学。将日志管道传入其中、在 CI 中运行它，或将其与其他工具链接：

# 分析最近的日志输出
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 参考了解完整的命令和标志集。

安排定期任务

按计划运行 Claude 以自动化重复的工作：早晨 PR 审查、夜间 CI 失败分析、每周依赖项审计或在 PR 合并后同步文档。

Routines 在云中运行，因此即使你的计算机关闭，它们也会继续运行。它们也可以在 API 调用或 GitHub 事件上触发。从网络、桌面应用或通过在 CLI 中运行 /schedule 来创建它们。
桌面计划任务在你的机器上运行，可直接访问你的本地文件和工具
/loop 在 CLI 会话中重复提示以进行快速轮询

从任何地方工作

会话不受限于单一界面。当你的上下文改变时，在环境之间移动工作：

离开你的办公桌，使用远程控制从你的手机或任何浏览器继续工作
向 Dispatch 发送来自你手机的任务，并打开它创建的桌面会话
在网络或 Claude 移动应用上启动长时间运行的任务，然后使用 claude --teleport 将其拉入你的终端。Teleport 需要 claude.ai 订阅。
运行 /desktop 将你当前的终端会话交给桌面应用进行视觉差异审查。/desktop 交接需要 claude.ai 订阅。可在 macOS 和 x64 Windows 上使用。
从团队聊天路由任务：在 Slack 中提及 @Claude 并附上错误报告，获得拉取请求

在任何地方使用 Claude Code

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

除了上面的终端、VS Code、JetBrains、桌面和网络界面外，Claude Code 还与 CI/CD、聊天和浏览器工作流集成：

我想要...	最佳选项
从我的手机或另一台设备继续本地会话	远程控制
从 Telegram、Discord、iMessage 或我自己的 webhook 推送事件到会话中	Channels
在本地启动任务，在移动设备上继续	`claude --cloud`，然后使用 Claude 移动应用
按定期计划运行 Claude	Routines 或桌面计划任务
自动化 PR 审查和问题分类	GitHub Actions 或 GitLab CI/CD
在每个 PR 上获得自动代码审查	GitHub Code Review
将 Slack 中的错误报告路由到拉取请求	Slack
调试实时网络应用	Chrome
为你自己的工作流构建自定义代理	Agent SDK

后续步骤

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

快速入门：通过你的第一个真实任务，从探索代码库到提交修复
存储说明和内存：使用 CLAUDE.md 文件和自动内存为 Claude 提供持久说明
常见工作流和最佳实践：充分利用 Claude Code 的模式
Claude Academy：免费自主学习课程，包括 Claude Code 101 和 Claude Code in Action
每项任务的框架：Claude Code 团队如何使用动态工作流大规模编排子代理
设置：为你的工作流自定义 Claude Code
故障排除：常见问题的解决方案
code.claude.com：演示、定价和产品详情

overview.md +10 −8

32 curl -fsSL https://claude.ai/install.sh | bash32 curl -fsSL https://claude.ai/install.sh | bash

33 ```33 ```

34 34

35 在 Windows 上，当您在 PowerShell 中时，您的提示符显示 `PS C:\`；当您在 CMD 中时，提示符显示 `C:\`（没有 `PS`）。

35 **Windows PowerShell：**37 **Windows PowerShell：**

36 38

37 ```powershell theme={null}39 ```powershell theme={null}

46 48

47 安装程序完成后，打开一个新的终端窗口并运行 `claude --version`。正常的安装会打印一个版本号。如果您的 shell 显示找不到 `claude` 或无法识别，说明安装目录还不在您的 PATH 中：请参阅[修复您的 PATH](/docs/zh-CN/troubleshoot-install#command-not-found-claude-after-installation)。49 安装程序完成后，打开一个新的终端窗口并运行 `claude --version`。正常的安装会打印一个版本号。如果您的 shell 显示找不到 `claude` 或无法识别，说明安装目录还不在您的 PATH 中：请参阅[修复您的 PATH](/docs/zh-CN/troubleshoot-install#command-not-found-claude-after-installation)。

48 50

49 如果您看到 `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`）。51 如果您看到 `The token '&&' is not a valid statement separator`，说明您在 PowerShell 中，而不是 CMD。如果您看到 `'irm' is not recognized as an internal or external command`，说明您在 CMD 中，而不是 PowerShell。

50 52

51 如果安装命令失败并显示 `syntax error near unexpected token '<'`、`403` 或其他 curl 错误，请参阅 [Troubleshoot installation](/docs/zh-CN/troubleshoot-install#find-your-error) 以匹配错误并获得修复方案和替代安装方法。53 如果安装命令失败并显示 `syntax error near unexpected token '<'`、`403` 或其他任何错误，请参阅[排查安装问题](/docs/zh-CN/troubleshoot-install#find-your-error)以匹配错误并获得修复方案和替代安装方法。

52 54

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

54 56

89 claude91 claude

90 ```92 ```

91 93

92 首次使用时，系统会提示你登录。如果你已设置 `ANTHROPIC_API_KEY` 环境变量，Claude Code 会跳过登录提示，改为要求你批准该密钥。就这样！[继续快速入门 →](/docs/zh-CN/quickstart)94 首次使用时，Claude Code 会提示您登录。如果您已设置 `ANTHROPIC_API_KEY` 环境变量，并在 Claude Code 询问是否使用该密钥时予以批准，Claude Code 将跳过登录提示。[继续快速入门 →](/docs/zh-CN/quickstart)

93 95

94 <Tip>96 <Tip>

95 查看[高级设置](/docs/zh-CN/setup)了解安装选项、手动更新或卸载说明。如果遇到问题，请访问[安装故障排除](/docs/zh-CN/troubleshoot-install)。97 查看[高级设置](/docs/zh-CN/setup)了解安装选项、手动更新或卸载说明。如果遇到问题，请访问[安装故障排除](/docs/zh-CN/troubleshoot-install)。

167 claude "commit my changes with a descriptive message"169 claude "commit my changes with a descriptive message"

168 ```170 ```

169 171

170 在 CI 中，你可以使用 [GitHub Actions](/docs/zh-CN/github-actions) 或 [GitLab CI/CD](/docs/zh-CN/gitlab-ci-cd) 自动化代码审查和问题分类。172 在 CI 中，您可以使用 [GitHub Actions](/docs/zh-CN/github-actions) 或 [GitLab CI/CD](/docs/zh-CN/gitlab-ci-cd) 自动化代码审查和问题分类。

171 </Accordion>173 </Accordion>

172 174

173 <Accordion title="使用 MCP 连接你的工具" icon="plug">175 <Accordion title="使用 MCP 连接您的工具" icon="plug">

174 [Model Context Protocol (MCP)](/docs/zh-CN/mcp) 是一个开放标准，用于将 AI 工具连接到外部数据源。使用 MCP，Claude Code 可以读取 Google Drive 中的设计文档、更新 Jira 中的工单、从 Slack 拉取数据，或使用你自己的自定义工具。[MCP 快速入门](/docs/zh-CN/mcp-quickstart)端到端连接你的第一个服务器。176 [Model Context Protocol (MCP)](/docs/zh-CN/mcp) 是一个开放标准，用于将 AI 工具连接到外部数据源。使用 MCP，Claude Code 可以读取 Google Drive 中的设计文档、更新 Jira 中的工单、从 Slack 拉取数据，或使用您自己的自定义工具。[MCP 快速入门](/docs/zh-CN/mcp-quickstart)将端到端地连接您的第一个服务器。

175 </Accordion>177 </Accordion>

176 178

177 <Accordion title="使用说明、skills 和 hooks 进行自定义" icon="sliders">179 <Accordion title="使用指令、skill 和 hook 进行自定义" icon="sliders">

178 [`CLAUDE.md`](/docs/zh-CN/memory) 是一个 markdown 文件，你可以将其添加到项目根目录，Claude Code 会在每个会话开始时读取它。使用它来设置编码标准、架构决策、首选库和审查清单。如果你的存储库已经有一个用于其他编码代理的 `AGENTS.md`，Claude Code [可以自己读取它](/docs/zh-CN/memory#agents-md)或与 `CLAUDE.md` 一起读取。Claude 还会在工作时构建[自动内存](/docs/zh-CN/memory#auto-memory)，保存学习内容，跨会话使用，无需你编写任何内容。180 [`CLAUDE.md`](/docs/zh-CN/memory) 是一个 markdown 文件，您可以将其添加到项目根目录，Claude Code 会在每个会话开始时读取它。使用它来设置编码标准、架构决策、首选库和审查清单。如果您的仓库已经有一个供其他编码 Agent 使用的 `AGENTS.md`，Claude Code [可以读取它](/docs/zh-CN/memory#agents-md)来代替 `CLAUDE.md`。Claude 还会在工作时构建[自动记忆](/docs/zh-CN/memory#auto-memory)，跨会话保存所学内容，无需您编写任何内容。

179 181

180 创建 [skills](/docs/zh-CN/skills) 来打包你的团队可以共享的可重复工作流，如 `/review-pr` 或 `/deploy-staging`。182 创建 [skills](/docs/zh-CN/skills) 来打包你的团队可以共享的可重复工作流，如 `/review-pr` 或 `/deploy-staging`。

181 183

overview.md 2026-10-06 23:59 UTC to 2026-10-07 19:00 UTC

概述

开始使用

你可以做什么

在任何地方使用 Claude Code

后续步骤