概述
Claude Code 是一个 Agent 编码工具,可以读取你的代码库、编辑文件、运行命令,并与你的开发工具集成。可在终端、IDE、桌面应用和浏览器中使用。
Claude Code 是一个 AI 驱动的编码助手,帮助你构建功能、修复 bug 和自动化开发任务。它理解你的整个代码库,可以跨多个文件和工具工作来完成任务。
开始使用
选择你的环境开始使用。大多数平台需要 Claude 订阅或 Anthropic Console 账户。终端 CLI 和 VS Code 也支持第三方提供商。
终端
功能齐全的 CLI,可直接在终端中使用 Claude Code。编辑文件、运行命令,从命令行管理整个项目。
要安装 Claude Code,使用以下方法之一:
原生安装(推荐)
macOS、Linux、WSL:
curl -fsSL https://claude.ai/install.sh | bashWindows PowerShell:
irm https://claude.ai/install.ps1 | iexWindows 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。
原生安装会在后台自动更新,确保你使用最新版本。
Homebrew
brew install --cask claude-codeHomebrew 提供两个 cask。claude-code 跟踪稳定发布通道,通常落后约一周,并跳过有重大回归的版本。claude-code@latest 跟踪最新通道,新版本发布后立即获取。
Homebrew 安装不会自动更新。运行
brew upgrade claude-code或brew upgrade claude-code@latest(取决于你安装的 cask)以获取最新功能和安全修复。
WinGet
winget install Anthropic.ClaudeCodeWinGet 安装不会自动更新。定期运行
winget upgrade Anthropic.ClaudeCode以获取最新功能和安全修复。
你也可以在 Debian、Fedora、RHEL 和 Alpine 上使用 apt、dnf 或 apk 安装。
然后在任何项目中启动 Claude Code:
cd your-project
claude首次使用时会提示你登录。就这么简单!继续快速入门 ->
VS Code
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。
桌面应用
一个独立应用,可在 IDE 或终端之外运行 Claude Code。可视化审查差异,并排运行多个会话,安排定期任务,启动云端会话。
下载并安装:
- macOS(Intel 和 Apple Silicon)
- Windows(x64)
- Windows ARM64
安装后,启动 Claude,登录,点击 Code 标签开始编码。需要付费订阅。
网页版
在浏览器中运行 Claude Code,无需本地设置。启动长时间运行的任务,完成后回来查看;处理你本地没有的仓库;或并行运行多个任务。支持桌面浏览器和 Claude iOS 应用。
在 claude.ai/code 开始编码。
JetBrains
适用于 IntelliJ IDEA、PyCharm、WebStorm 和其他 JetBrains IDE 的插件,支持交互式差异查看和选择上下文共享。
从 JetBrains Marketplace 安装 Claude Code 插件 并重启 IDE。
你可以做什么
以下是一些使用 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 自动化代码审查和问题分类。
通过 MCP 连接你的工具
模型上下文协议(MCP)是一个开放标准,用于将 AI 工具连接到外部数据源。通过 MCP,Claude Code 可以读取 Google Drive 中的设计文档、更新 Jira 中的工单、从 Slack 拉取数据,或使用你自己的自定义工具。
使用指令、技能和 Hook 进行自定义
CLAUDE.md 是你添加到项目根目录的 markdown 文件,Claude Code 在每次会话开始时读取它。用它来设置编码标准、架构决策、首选库和审查清单。Claude 在工作时也会构建自动记忆,在会话之间保存构建命令和调试洞察等学习内容,无需你编写任何东西。
创建技能来打包可重复的工作流,供你的团队共享,如 /review-pr 或 /deploy-staging。
Hook 让你在 Claude Code 操作之前或之后运行 shell 命令,例如每次文件编辑后自动格式化,或提交前运行 lint。
运行 Agent 团队和构建自定义 Agent
生成多个 Claude Code Agent,同时处理任务的不同部分。主 Agent 协调工作、分配子任务并合并结果。
要并行运行多个完整会话并在一个屏幕上查看它们,使用后台 Agent。对于完全自定义的工作流,Agent SDK 让你构建由 Claude Code 工具和能力驱动的自定义 Agent,完全控制编排、工具访问和权限。
通过管道、脚本和 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并附上 bug 报告,获得拉取请求
在任何地方使用 Claude Code
每个平台都连接到相同的底层 Claude Code 引擎,因此你的 CLAUDE.md 文件、设置和 MCP 服务器在所有平台之间通用。
除了上面的终端、VS Code、JetBrains、桌面和网页环境外,Claude Code 还与 CI/CD、聊天和浏览器工作流集成:
| 我想要... | 最佳选择 |
|---|---|
| 从手机或其他设备继续本地会话 | 远程控制 |
| 从 Telegram、Discord、iMessage 或自己的 webhook 推送事件到会话 | 通道 |
| 本地开始任务,移动端继续 | 网页或 Claude iOS 应用 |
| 定期运行 Claude | 例程或桌面定时任务 |
| 自动化 PR 审查和问题分类 | GitHub Actions 或 GitLab CI/CD |
| 在每个 PR 上获得自动代码审查 | GitHub 代码审查 |
| 将 Slack 的 bug 报告路由到拉取请求 | Slack |
| 调试实时 Web 应用 | Chrome |
| 为自己的工作流构建自定义 Agent | Agent SDK |
下一步
安装 Claude Code 后,这些指南帮助你深入了解。