首页 / AI 代理

Claude Code 安装教学（2026）：Windows、Mac 一步步装好并完成第一个任务

作者 JC · 更新于 · 最后查证

简体版由繁体自动转换，少数用词可能和你习惯的不同。

要点速览

Claude Code 是 Anthropic 推出的 AI 编程代理，在终端机里帮你读项目、改文件、运行指令。安装只要一行官方指令：Windows 在 PowerShell 运行 irm https://claude.ai/install.ps1 | iex，Mac 和 Linux 运行 curl -fsSL https://claude.ai/install.sh | bash，不需要先装 Node.js。装好后输入 claude 并用浏览器登录即可使用；需要 Claude Pro、Max、Team、Enterprise 或 Console 账号，免费方案不能用。

如果你想让 AI 不只是「回答问题」，而是真的帮你动手写程序、整理文件、跑指令，Claude Code 是目前最值得先学的 AI 代理之一。这篇 Claude Code 安装教学会从零开始，带你在 Windows 或 Mac 上装好它，并用它完成第一个任务。

Claude Code 是什么？

Claude Code 是 Anthropic 推出的 AI 编程代理（AI coding agent）。它跑在终端机里，你用一般的中文描述想做的事，它就会读取你的项目、提出修改、直接编辑文件或运行指令。

和在聊天网页问 AI 最大的不同是：它能直接对你电脑上的文件动手。也因为这样，它在修改文件或运行指令之前，预设会先问你同不同意。

如果你还不熟「代理」这个概念，可以先看名词小辞典，或回到 AI 代理总览。

安装前准备

开始之前，先确认三件事：

  1. 操作系统：Windows 10（1809 版以上）、macOS 13 以上，或 Ubuntu 20.04、Debian 10 以上的 Linux。内存 4 GB 以上。
  2. 账号：需要 Claude Pro、Max、Team、Enterprise 方案，或 Anthropic Console（API）账号。免费方案不能使用 Claude Code。
  3. 会打开终端机：
    • Windows：按开始键，搜索「PowerShell」并打开。看到开头是 PS C:\Users\你的名字> 就对了。
    • Mac：按 Command + 空白键，搜索「终端机」（Terminal）并打开。

不需要先安装 Node.js，官方安装指令会直接下载 Claude Code 本体。

Claude Code 安装教学：Windows

在 PowerShell 里粘贴这行指令，按 Enter：

irm https://claude.ai/install.ps1 | iex

几个要注意的地方：

  • 不需要用系统管理员身分运行，一般打开的 PowerShell 就可以。
  • 安装过程不会显示进度，看起来像卡住是正常的，等它跑完就好。
  • 如果你用的是「命令提示字符」（CMD，开头没有 PS），要改用这行：
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

建议同时安装 Git for Windows。 这不是必须的，没有它时 Claude Code 会改用 PowerShell 运行指令；但装了之后它能使用 Git Bash，很多开发工具的兼容性会更好。

也可以用 WinGet 安装：winget install Anthropic.ClaudeCode。不过 WinGet 版本不会自动更新，要自己定期运行 winget upgrade Anthropic.ClaudeCode。新手建议直接用上面的官方指令。

Claude Code 安装教学：Mac 与 Linux

打开终端机，粘贴这行指令，按 Enter：

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

Mac 用户也可以用 Homebrew 安装：

brew install --cask claude-code

Homebrew 版本同样不会自动更新，需要自己运行 brew upgrade claude-code。

确认安装成功

安装完成后，关掉目前的终端机，开一个新的窗口，输入：

claude --version

只要有印出版本号（例如 2.1.xxx (Claude Code)），就代表安装成功。

想更完整地检查安装和设置，可以运行：

claude doctor

它会列出安装状态、设置档有没有错误，以及建议的修正方式。

第一次启动与登录

  1. 用 cd 进入你想让 Claude Code 帮忙的文件夹，例如：
cd Documents\my-project
  1. 输入 claude 启动。
  2. 第一次会跳出浏览器，用你的 Claude 账号登录并授权，回到终端机就能开始使用。

小提醒：Claude Code 能读写的是你启动它的那个文件夹。第一次练习时，建议先开一个新的空文件夹，不要直接在重要的工作文件夹里试。

用 Claude Code 完成第一个任务

登录后，直接用中文输入你想做的事。第一次可以试试这个：

帮我在这个文件夹创建一个简单的网页，标题是「我的第一个 AI 项目」，再写一份 README 说明怎么打开它。

接下来你会看到：

  • Claude Code 先说明它打算怎么做；
  • 要创建或修改文件、运行指令时，它会停下来询问你是否同意，确认内容没问题再按同意；
  • 完成后，文件夹里就会出现它创建的文件。

几个一开始就很好用的操作：

  • /init：让它读过整个项目，产生一份 CLAUDE.md，记录这个项目的说明和惯例，之后每次启动它都会先参考。
  • /help：列出所有可用的指令。
  • Esc：觉得方向不对时，按一下就能打断它正在做的事。

常见错误排除

输入 claude 显示「不是内部或外部命令」或 command not found 先关掉终端机、开新窗口再试一次。还是不行，代表安装路径没有加进 PATH，照官方问题排除文档的「Fix your PATH」修正。

出现 The token '&&' is not a valid statement separator 你现在在 PowerShell，却贴了 CMD 用的指令。改用 irm https://claude.ai/install.ps1 | iex。

出现 'irm' is not recognized as an internal or external command 你现在在 CMD，却贴了 PowerShell 用的指令。改用 CMD 那行指令，或换成 PowerShell 再试。

安装时出现 403 或其他错误 可能和网络环境或所在地区有关。Claude Code 只能在 Anthropic 支持的国家和地区使用，详细对照请看官方的问题排除文档。

下一步

装好 Claude Code 之后，你已经有了一个能直接动手的 AI 助手。接下来可以：

这篇教学依照 Claude Code 官方文档整理，工具更新很快，如果你照着做遇到不一样的画面，欢迎到 YouTube 视频底下留言告诉我们。

常见问题

Claude Code 免费版可以用吗？

不行。Claude Code 需要 Claude Pro、Max、Team、Enterprise 或 Console 账号，免费的 claude.ai 方案不包含 Claude Code。

安装 Claude Code 需要先装 Node.js 吗？

用官方安装指令（原生安装）不需要 Node.js。只有选择用 npm 安装时，才需要 Node.js 22 以上的版本。

Windows 一定要装 Git 吗？

不是必须。没有 Git for Windows 时，Claude Code 会改用 PowerShell 运行指令；装了 Git for Windows 之后，它就能使用 Git Bash，兼容性更好，所以建议安装。

输入 claude 显示「不是内部或外部命令」怎么办？

先关掉终端机、重新开一个新窗口再试。还是不行的话，代表安装路径没有加进 PATH，请照官方的安装问题排除文档修正。

Claude Code 会自动更新吗？

用官方安装指令装的版本会在背景自动更新。用 WinGet 或 Homebrew 安装的版本不会自动更新，需要自己定期运行更新指令。

留言

用 GitHub 账号登录就能留言，留言会公开显示在 GitHub Discussions。留言前请先看社区规则。

AI 代理