English ← MyDocs

文档索引

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

概述

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

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

快速开始

选择你的环境开始使用。大多数界面需要 Claude 订阅Anthropic Console 账户。终端 CLI 和 VS Code 也支持第三方提供商

功能齐全的 CLI,可直接在终端中使用 Claude Code。编辑文件、运行命令,从命令行管理整个项目。

要安装 Claude Code,请使用以下方法之一:

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

如果你看到 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,以便 Claude Code 使用 Bash 工具。如果未安装 Git for Windows,Claude Code 将改用 PowerShell 作为 shell 工具。WSL 环境不需要 Git for Windows。

Info

原生安装会在后台自动更新,确保你使用的是最新版本。

brew install --cask claude-code

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

Info

Homebrew 安装不会自动更新。根据你安装的 cask,运行 brew upgrade claude-codebrew upgrade claude-code@latest 以获取最新功能和安全修复。

winget install Anthropic.ClaudeCode
Info

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

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

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

cd your-project
claude

首次使用时会提示你登录。就这样!继续快速入门 →

Tip

参见高级设置了解安装选项、手动更新或卸载说明。如遇问题请访问安装故障排除

VS 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 快速入门 →

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

下载并安装:

安装后,启动 Claude,登录并点击 Code 标签页开始编程。需要付费订阅

了解更多关于桌面应用 →

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

claude.ai/code 开始编程。

网页版快速入门 →

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

从 JetBrains Marketplace 安装 Claude Code 插件 并重启 IDE。

JetBrains 快速入门 →

你可以做什么

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

自动化你一直推迟的工作

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

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 ActionsGitLab CI/CD 自动化代码审查和问题分流。

通过 MCP 连接你的工具

模型上下文协议 (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 合并后同步文档。

  • 例行任务在 Anthropic 管理的基础设施上运行,即使你的电脑关机也会继续运行。它们还可以通过 API 调用或 GitHub 事件触发。从网页、桌面应用或在 CLI 中运行 /schedule 来创建。
  • 桌面计划任务在你的机器上运行,可直接访问你的本地文件和工具
  • /loop在 CLI 会话中重复提示,用于快速轮询
随时随地工作

会话不局限于单一界面。随着环境变化在不同界面之间切换工作:

  • 离开办公桌,通过远程控制从手机或任何浏览器继续工作
  • 从手机向 Dispatch 发送任务,然后打开它创建的桌面会话
  • 网页版iOS 应用启动长时间运行的任务,然后通过 claude --teleport 将其拉入终端
  • 通过 /desktop 将终端会话移交给桌面应用以进行可视化差异审查
  • 从团队聊天中路由任务:在 Slack 中提及 @Claude 并附上缺陷报告,即可获得拉取请求

随处使用 Claude Code

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

除了上面的终端VS CodeJetBrains桌面应用网页版环境外,Claude Code 还与 CI/CD、聊天和浏览器工作流集成:

我想要...最佳选择
从手机或其他设备继续本地会话远程控制
将 Telegram、Discord、iMessage 或自己的 webhook 事件推送到会话频道
在本地启动任务,在移动端继续网页版Claude iOS 应用
按定期计划运行 Claude例行任务桌面计划任务
自动化 PR 审查和问题分流GitHub ActionsGitLab CI/CD
在每个 PR 上获得自动代码审查GitHub 代码审查
将 Slack 中的缺陷报告路由到拉取请求Slack
调试实时 Web 应用Chrome
为你的工作流构建自定义智能体Agent SDK

后续步骤

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