Claude Code 是 Anthropic 推出的 AI 编程助手，支持终端、VS Code、桌面应用、Web 和 JetBrains 环境。本页直接给出各平台的安装命令（macOS/Linux/WSL 用 curl，Windows 用 PowerShell 或 CMD，也支持 Homebrew 和 WinGet），以及首次启动方式（在项目目录执行 claude 并登录）。同时概括了核心能力：自动写测试、修复 Bug、创建提交和 PR、通过 MCP 连接外部工具、自定义指令与技能、运行多代理团队、调度任务以及跨设备远程控制。安装前需确认拥有 Claude 订阅或 Anthropic Console 账户，第三方提供商也受支持。

Claude Code 概览：安装方法与入门使用指南

Claude Code 是一个 AI 驱动的编程助手，能读取整个代码仓库、编辑文件、运行命令、并集成开发工具。你可以在终端、VS Code、桌面应用和浏览器中使用它。无论是构建功能、修复错误，还是自动化开发任务，Claude Code 都能跨文件、跨工具协作完成。

开始使用

根据你的工作环境选择安装方式。大多数平台需要 Claude 订阅 或 Anthropic Console 账户。终端 CLI 和 VS Code 也支持 第三方提供商。

终端 CLI

功能完整的命令行工具，直接在终端中操作代码、运行命令、管理项目。

macOS、Linux、WSL 安装：

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

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

如果在 PowerShell 中看到 The token '&&' is not a valid statement separator 错误，说明你实际在 CMD 而非 PowerShell。如果在 CMD 中看到 'irm' is not recognized as an internal or external command，说明你实际在 PowerShell。查看提示符：PS C:\ 表示 PowerShell，C:\ 表示 CMD。 原生 Windows 上推荐安装 Git for Windows，这样 Claude Code 可以使用 Bash 工具。如果未安装 Git for Windows，Claude Code 会改用 PowerShell 作为 Shell 工具。WSL 环境无需 Git for Windows。 原生安装会自动在后台更新到最新版本。

Homebrew 安装（macOS）：

brew install --cask claude-code

Homebrew 提供两个 cask：claude-code 跟踪稳定版（通常比最新版晚一周左右，跳过有重大回归的版本），claude-code@latest 跟踪最新版，发布后立即推送。

Homebrew 安装不会自动更新。运行 brew upgrade claude-code 或 brew upgrade claude-code@latest（取决于你安装的 cask）获取最新功能和安全修复。

WinGet 安装（Windows）：

winget install Anthropic.ClaudeCode

WinGet 安装不会自动更新。定期运行 winget upgrade Anthropic.ClaudeCode 获取最新功能和安全修复。

你也可以在 Debian、Fedora、RHEL、Alpine 上使用 apt、dnf 或 apk 安装。

安装完成后，在任何项目中启动 Claude Code：

cd your-project
claude

首次使用会提示登录。然后就可以开始工作了。继续 Quickstart →

更多安装选项、手动更新或卸载说明请参见 高级配置。如果遇到问题，查看 安装故障排查。

VS Code 扩展

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

• 安装到 VS Code
• 安装到 Cursor

或者在扩展视图中搜索 "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 →

桌面应用

独立应用，可以在 IDE 或终端外运行 Claude Code。支持视觉差异审查、并排运行多个会话、调度周期性任务以及启动云端会话。

下载安装：

• macOS（Intel 和 Apple Silicon）
• Windows x64
• Windows ARM64

安装后启动 Claude，登录，点击 Code 标签即可开始编码。需要 付费订阅。

了解更多桌面应用 →

Web 版

在浏览器中运行 Claude Code，无需本地配置。可以启动长时间运行的任务，完成任务后回来查看；处理本地没有的仓库；或并行运行多个任务。支持桌面浏览器和 Claude iOS 应用。

在 claude.ai/code 开始编码。

开始使用 Web 版 →

JetBrains 插件

适用于 IntelliJ IDEA、PyCharm、WebStorm 和其他 JetBrains IDE，支持交互式差异对比和选择上下文共享。

从 JetBrains Marketplace 安装 Claude Code 插件，然后重启 IDE。

开始使用 JetBrains →

你能用 Claude Code 做什么

以下是 Claude Code 的典型使用场景：

自动化你一直拖延的工作

Claude Code 处理耗时的重复性任务：为未测试的代码写测试、修复整个项目的 lint 错误、解决合并冲突、更新依赖、编写发布说明。

claude "write tests for the auth module, run them, and fix any failures"

构建功能和修复 Bug

用自然语言描述需求，Claude Code 会规划方案、跨多个文件编写代码，并验证结果。对于 Bug，粘贴错误信息或描述症状，Claude Code 会在代码库中追踪问题，定位根因并实施修复。查看 常见工作流 获取更多示例。

创建提交和拉取请求

Claude Code 直接与 git 协作：暂存更改、编写提交信息、创建分支、打开拉取请求。

claude "commit my changes with a descriptive message"

在 CI 中，你可以通过 GitHub Actions 或 GitLab CI/CD 自动化代码审查和 issue 分类。

通过 MCP 连接你的工具

Model Context Protocol (MCP) 是连接 AI 工具与外部数据源的开放标准。通过 MCP，Claude Code 可以读取 Google Drive 中的设计文档、更新 Jira 工单、从 Slack 拉取数据，或使用你自定义的工具。

用指令、技能和钩子自定义

CLAUDE.md 是放在项目根目录的 Markdown 文件，Claude Code 在每个会话开始时读取。用它设定编码标准、架构决策、首选库和审查清单。Claude 还会在工作过程中构建 自动记忆，跨会话保存学习到的内容（如构建命令、调试技巧），无需你手动编写。

创建 技能 来打包可重复的工作流，与团队共享，例如 /review-pr 或 /deploy-staging。

钩子 允许在 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 在 Anthropic 管理的基础设施上运行，即使关闭电脑也能继续。它们还可以通过 API 调用或 GitHub 事件触发。从 Web、桌面应用或 CLI 中运行 /schedule 创建。
• 桌面调度任务 在本地机器上运行，直接访问本地文件和工具。
• /loop 在 CLI 会话内重复提示，用于快速轮询。

随处工作

会话不绑定到单个界面。随着上下文变化，在不同环境间移动工作：

• 离开桌面后，通过 Remote Control 从手机或任何浏览器继续工作。
• 从手机发送 Dispatch 任务，它会在桌面端创建会话。
• 在 Web 或 iOS 应用 启动长时间运行的任务，然后在终端用 claude --teleport 拉取。
• 使用 /desktop 将终端会话交给 桌面应用 进行视觉差异审查。
• 从团队聊天路由任务：在 Slack 中 @Claude 并附上 Bug 报告，直接获得一个拉取请求。

随处使用 Claude Code

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

除了上述的 终端、VS Code、JetBrains、桌面应用 和 Web 环境，Claude Code 还集成了 CI/CD、聊天和浏览器工作流：

目标	最佳方案
从手机或其他设备继续本地会话	Remote Control
将 Telegram、Discord、iMessage 或自定义 webhook 的事件推送到会话	Channels
本地启动任务，之后在移动设备上继续	Web 或 Claude iOS 应用
按周期调度 Claude	Routines 或 桌面调度任务
自动化 PR 审查和 issue 分类	GitHub Actions 或 GitLab CI/CD
每次 PR 自动获得代码审查	GitHub Code Review
将 Slack 中的 Bug 报告路由到拉取请求	Slack
调试实时 Web 应用	Chrome
构建自定义代理以适应自己的工作流	Agent SDK

下一步

安装 Claude Code 后，这些指南会带你深入使用。

• Quickstart：从探索代码库到提交修复，完整走一遍第一个实际任务。
• 存储指令与记忆：通过 CLAUDE.md 文件和自动记忆给 Claude 持久指令。
• 常见工作流 和 最佳实践：高效使用 Claude Code 的模式。
• 设置：为你的工作流自定义 Claude Code。
• 故障排查：常见问题的解决方案。
• code.claude.com：演示、定价和产品详情。

常见问题

Claude Code 支持哪些操作系统？

macOS、Linux（包括 WSL）和 Windows 都支持。具体安装方法：macOS/Linux/WSL 使用 curl 脚本；Windows 支持 PowerShell、CMD 或 WinGet；macOS 也可用 Homebrew；Linux 还可通过 apt、dnf 或 apk 安装。

安装后如何启动 Claude Code？

在项目目录中执行 claude，首次会提示登录。如果在 VS Code 中，安装扩展后通过命令面板（Cmd+Shift+P / Ctrl+Shift+P）搜索 "Claude Code" 然后选择 Open in New Tab。

不同安装方式（原生、Homebrew、WinGet）有什么区别？

原生安装（curl/PowerShell）会后台自动更新到最新版本。Homebrew 安装不会自动更新，需要手动运行 brew upgrade claude-code。WinGet 安装也不自动更新，需运行 winget upgrade Anthropic.ClaudeCode。Homebrew 还提供稳定版（claude-code，延迟约一周）和最新版（claude-code@latest）两种标签。