Skip to main content
Claude Code 是一个由 AI 驱动的编码助手,可帮助你构建功能、修复错误和自动化开发任务。它理解你的整个代码库,可以跨多个文件和工具工作以完成任务。
默认配置下,Claude Code 需要能够访问 claude.ai 和 Anthropic API 等端点才能完成安装、登录和正常使用。在中国大陆的网络环境中,这些端点可能无法直接访问。开始前,请先确认所在网络能够连通这些服务。企业代理配置以及 Amazon Bedrock 等第三方提供商的网络要求,请参阅网络配置。

开始使用

Claude Code 在多个平台上运行:终端、IDE 扩展、桌面应用和网络。从下面的标签页中选择一个来开始使用。大多数平台需要 Claude 订阅 或 Anthropic 控制台 账户。终端 CLI、VS Code 和 JetBrains 也支持第三方提供商。
功能完整的 CLI,用于直接在终端中使用 Claude Code。编辑文件、运行命令,并从命令行管理整个项目。要安装 Claude Code,请打开终端并运行适用于您的系统的命令。如果您之前没有使用过终端,终端指南会展示如何打开终端并粘贴命令。
macOS、Linux、WSL:
Windows PowerShell:
Windows 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。当您在 PowerShell 中时,您的提示符显示 PS C:\,当您在 CMD 中时显示 C:\(没有 PS)。如果安装命令失败并显示 syntax error near unexpected token '<'、403 或其他 curl 错误,请参阅 Troubleshoot installation 以匹配错误并获得修复方案和替代安装方法。建议在原生 Windows 上安装 Git for Windows,以便 Claude Code 可以使用 Bash 工具。如果未安装 Git for Windows,Claude Code 将使用 PowerShell 作为 shell 工具。WSL 设置不需要 Git for Windows。
原生安装会在后台自动更新,以保持您使用最新版本。
您也可以在 Debian、Fedora、RHEL 和 Alpine 上使用 apt、dnf 或 apk 进行安装。然后在任何项目中启动 Claude Code。将 your-project 替换为你机器上项目目录的路径:
首次使用时,系统会提示你登录。如果你已设置 ANTHROPIC_API_KEY 环境变量,Claude Code 会跳过登录提示,改为要求你批准该密钥。就这样!继续快速入门 →
查看高级设置了解安装选项、手动更新或卸载说明。如果遇到问题,请访问安装故障排除。

你可以做什么

以下是你可以使用 Claude Code 的一些方式:
Claude Code 处理那些占用你一整天的繁琐任务:为未测试的代码编写测试、修复项目中的 lint 错误、解决合并冲突、更新依赖项和编写发布说明。
用简单的语言描述你想要的内容。Claude Code 规划方法、跨多个文件编写代码,并验证其工作。对于错误,粘贴错误消息或描述症状。Claude Code 通过你的代码库追踪问题、识别根本原因并实施修复。查看常见工作流了解更多示例。
Claude Code 直接与 git 配合工作。它暂存更改、编写提交消息、创建分支并打开拉取请求。
在 CI 中,你可以使用 GitHub Actions 或 GitLab CI/CD 自动化代码审查和问题分类。
Model Context Protocol (MCP) 是一个开放标准,用于将 AI 工具连接到外部数据源。使用 MCP,Claude Code 可以读取 Google Drive 中的设计文档、更新 Jira 中的工单、从 Slack 拉取数据,或使用你自己的自定义工具。MCP 快速入门端到端连接你的第一个服务器。
CLAUDE.md 是一个 markdown 文件,你可以将其添加到项目根目录,Claude Code 会在每个会话开始时读取它。使用它来设置编码标准、架构决策、首选库和审查清单。如果你的存储库已经有一个用于其他编码代理的 AGENTS.md,Claude Code 可以自己读取它或与 CLAUDE.md 一起读取。Claude 还会在工作时构建自动内存,保存学习内容,跨会话使用,无需你编写任何内容。创建 skills 来打包你的团队可以共享的可重复工作流,如 /review-pr 或 /deploy-staging。Hooks 让你在 Claude Code 操作之前或之后运行 shell 命令,如在每次文件编辑后自动格式化或在提交前运行 lint。
生成多个 Claude Code 代理,同时处理任务的不同部分。主导代理协调工作、分配子任务并合并结果。要在并行中运行多个完整会话并从一个屏幕观看它们,请使用后台代理。对于完全自定义的工作流,Agent SDK 让你构建由 Claude Code 的工具和功能驱动的自己的代理,完全控制编排、工具访问和权限。
Claude Code 是可组合的,遵循 Unix 哲学。将日志管道传入其中、在 CI 中运行它,或将其与其他工具链接:
查看 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、聊天和浏览器工作流集成:

后续步骤

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