默认配置下,Claude Code 需要能够访问 claude.ai 和 Anthropic API 等端点才能完成安装、登录和正常使用。在中国大陆的网络环境中,这些端点可能无法直接访问。开始前,请先确认所在网络能够连通这些服务。企业代理配置以及 Amazon Bedrock 等第三方提供商的网络要求,请参阅网络配置。
开始使用
Claude Code 在多个平台上运行:终端、IDE 扩展、桌面应用和网络。从下面的标签页中选择一个来开始使用。大多数平台需要 Claude 订阅 或 Anthropic 控制台 账户。终端 CLI、VS Code 和 JetBrains 也支持第三方提供商。- Terminal
- VS Code
- Desktop app
- Web
- JetBrains
功能完整的 CLI,用于直接在终端中使用 Claude Code。编辑文件、运行命令,并从命令行管理整个项目。要安装 Claude Code,请打开终端并运行适用于您的系统的命令。如果您之前没有使用过终端,终端指南会展示如何打开终端并粘贴命令。您也可以在 Debian、Fedora、RHEL 和 Alpine 上使用 apt、dnf 或 apk 进行安装。然后在任何项目中启动 Claude Code。将 首次使用时,系统会提示你登录。如果你已设置
- 原生安装(推荐)
- Homebrew
- WinGet
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。原生安装会在后台自动更新,以保持您使用最新版本。
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 自动化代码审查和问题分类。
使用 MCP 连接你的工具
使用 MCP 连接你的工具
Model Context Protocol (MCP) 是一个开放标准,用于将 AI 工具连接到外部数据源。使用 MCP,Claude Code 可以读取 Google Drive 中的设计文档、更新 Jira 中的工单、从 Slack 拉取数据,或使用你自己的自定义工具。MCP 快速入门端到端连接你的第一个服务器。
使用说明、skills 和 hooks 进行自定义
使用说明、skills 和 hooks 进行自定义
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 的工具和功能驱动的自己的代理,完全控制编排、工具访问和权限。
使用 CLI 进行管道、脚本和自动化
使用 CLI 进行管道、脚本和自动化
安排定期任务
安排定期任务
从任何地方工作
从任何地方工作
会话不受限于单一界面。当你的上下文改变时,在环境之间移动工作:
在任何地方使用 Claude Code
每个界面都连接到相同的底层 Claude Code 引擎,因此你的 CLAUDE.md 文件、设置和 MCP 服务器可在所有界面中工作。 除了上面的终端、VS Code、JetBrains、桌面和网络界面外,Claude Code 还与 CI/CD、聊天和浏览器工作流集成:后续步骤
安装 Claude Code 后,这些指南可帮助你深入了解。- 快速入门:通过你的第一个真实任务,从探索代码库到提交修复
- 存储说明和内存:使用 CLAUDE.md 文件和自动内存为 Claude 提供持久说明
- 常见工作流和最佳实践:充分利用 Claude Code 的模式
- Claude Academy:免费自主学习课程,包括 Claude Code 101 和 Claude Code in Action
- 每项任务的框架:Claude Code 团队如何使用动态工作流大规模编排子代理
- 设置:为你的工作流自定义 Claude Code
- 故障排除:常见问题的解决方案
- code.claude.com:演示、定价和产品详情