Claude Code 怎么安装和使用？2026 Windows、macOS、Linux 快速上手教程

2026 年安装 Claude Code 已经不需要复杂配置。Windows 可以直接在 PowerShell 原生安装，macOS、Linux 和 WSL 可以使用官方安装脚本。安装完成后运行 claude 登录账号，再进入自己的代码项目目录，就可以让 Claude Code 阅读项目、修改代码、修复 Bug 和运行命令。

对于第一次接触 AI 编程 Agent 的开发者来说，Claude Code 和传统“问一句、复制一段代码”的聊天工具最大的区别在于：

它可以直接围绕整个代码项目工作，而不只是生成零散代码。

Anthropic 当前官方文档已经支持 Windows、macOS、Ubuntu、Debian 等常见开发环境，并把 Native Install 作为推荐安装方式。

一、Claude Code 是什么？

Claude Code 是 Anthropic 面向开发者推出的 AI Coding Agent。

它可以在终端中读取当前项目，并帮助完成：

• 阅读和解释代码；

• 分析项目目录；

• 修改多个文件；

• 修复 Bug；

• 开发新功能；

• 执行终端命令；

• 配合 Git 工作；

• 编写和运行测试。

使用方式和普通聊天式 AI 不太一样。

例如普通 AI 编程经常是：

提问 → 复制代码 → 自己找到文件 → 自己修改。

Claude Code 更接近：

打开项目 → Claude 读取项目 → 提出任务 → Claude 修改代码 → 检查结果。

如果你也在比较 OpenAI Codex，可以先看看本站整理的 Codex 能做什么、不能做什么？能力边界与验证指南。

二、安装 Claude Code 前需要准备什么？

目前 Claude Code 官方支持的主要环境包括：

官方建议至少准备 4GB RAM，并保持正常网络连接。

需要特别说明的是：

现在 Windows 不再必须通过 WSL 才能运行 Claude Code。

Anthropic 当前同时支持：

• Windows 原生模式；

• WSL 1；

• WSL 2。

对于普通 Windows 开发项目，直接原生安装通常已经足够；如果项目本身依赖 Linux 工具链，再考虑使用 WSL 2。

三、Windows 安装 Claude Code

Windows 用户建议直接打开 PowerShell。

运行：

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

等待安装完成以后执行：

claude --version

如果能够正常显示版本号，例如：

2.x.x (Claude Code)

说明安装成功。

Anthropic 目前还提供 WinGet 安装：

winget install Anthropic.ClaudeCode

两种方式都可以。

如果经常进行 Web、Node.js 或 Linux 风格的开发工作，也建议安装 Git for Windows，这样 Claude Code 可以使用 Git Bash；没有安装 Git for Windows 时，Claude Code 在 Windows 原生环境也可以使用 PowerShell。

四、macOS / Linux 怎么安装？

macOS、Linux 和 WSL 可以使用官方 Native Install：

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

完成以后检查：

claude --version

macOS 用户也可以使用 Homebrew：

brew install --cask claude-code

需要注意的是，Anthropic 当前更推荐 Native Install。

网上很多旧教程仍然使用：

npm install -g @anthropic-ai/claude-code

npm 方式目前仍然属于可用的高级安装方式，但已经不是官方文档首先推荐的方法。

五、第一次怎么启动 Claude Code？

安装以后进入自己的项目目录。

例如：

cd my-project

然后运行：

claude

第一次启动时会要求登录。

按照浏览器提示完成账号验证即可。

Claude Code 当前可以使用 Claude Pro、Max、Team、Enterprise 或 Claude Console 等符合条件的账户登录。

登录完成以后，终端里就会进入 Claude Code 对话界面。

六、第一次使用建议先让它“读项目”

不要上来就说：

把我的项目全部重构一下。

第一次进入项目以后，可以先问：

这个项目是做什么的？分析一下目录结构和主要技术栈。

或者：

告诉我这个项目的入口文件在哪里，前端、后端和数据库分别使用什么技术。

Claude Code 会读取当前目录中的项目文件，再根据真实代码回答。

Anthropic 官方 Quickstart 也建议新用户先从“项目是做什么的”“使用了什么技术”“入口文件在哪里”等问题开始。

七、让 Claude Code 修改代码

确认它已经理解项目后，就可以开始安排实际任务。

例如：

检查登录页面。手机端登录按钮宽度有问题，只修改前端样式，不修改登录接口。

比起：

帮我优化一下网站。

前一种写法通常效果更好。

因为一个好的 Claude Code 任务最好包含：

目标 + 修改范围 + 不允许修改的部分 + 验证方法。

例如：

修复用户重复提交订单的问题。

要求：
1. 先定位原因；
2. 不修改数据库 Schema；
3. 修改完成后运行现有测试；
4. 最后告诉我修改了哪些文件。

这种指令更适合 Coding Agent。

八、几个常用命令

刚开始使用不需要记很多命令，下面几个已经够用。

查看帮助

/help

重新登录

/login

恢复之前的会话

/resume

检查安装环境

如果 Claude Code 出现安装、更新或配置问题，可以运行：

claude doctor

官方说明中，claude doctor 会检查安装状态和配置文件，并给出相应诊断信息。

九、Windows 到底选原生还是 WSL？

可以简单按照这个方法判断：

目前官方说明中，Windows 原生模式已经可以直接运行 Claude Code；WSL 2 的主要优势是 Linux 工具链以及沙箱执行环境。

所以新手没有必要看到旧教程就先安装一整套 WSL。

十、Claude Code 和 Codex 怎么选？

两者现在都已经属于比较完整的 AI Coding Agent。

简单理解：

Claude Code 更适合已经处于 Claude 生态、喜欢终端式 AI 编程工作流的用户。

Codex 则更适合已经使用 ChatGPT，并希望结合 Codex CLI、桌面版、IDE 和 Cloud Agent 工作的开发者。

不要只比较模型跑分，更应该考虑：

• 现有订阅；

• 开发环境；

• 项目规模；

• 使用额度；

• IDE / CLI 工作流；

• 是否需要长时间 Agent 任务。

如果正在比较两套工具，也可以继续阅读本站的 2026 年 Codex Plus、Pro 5x、Pro 20x 额度完整对比。

对于高频 AI 编程用户，额度成本往往也是最终选择工具时需要考虑的重要因素。

十一、Claude Code 安装后不能运行怎么办？

可以先执行：

claude --version

然后：

claude doctor

如果 claude --version 本身都无法识别，通常优先检查：

• 安装是否成功；

• PATH 是否正确；

• 终端是否重新打开；

• 当前使用的是 PowerShell、CMD 还是 WSL；

• Windows 和 WSL 是否安装到了不同环境。

尤其需要注意：

如果是在 WSL 中安装 Claude Code，就应该从 WSL 终端启动，而不是回到 Windows PowerShell 中寻找同一个命令。

官方文档也明确区分了 Windows 原生和 WSL 两种运行环境。

十二、适合新手的 Claude Code 使用流程

第一次使用可以直接按照下面这套流程：

进入项目目录
↓
运行 claude
↓
先让 Claude 分析项目
↓
提出一个范围明确的小任务
↓
让它修改代码
↓
查看 Git Diff
↓
运行测试
↓
人工确认

不要一开始就把整个生产项目完全交给 AI。

Claude Code、Codex 这类 Coding Agent 最大的价值是：

提高开发效率，而不是取消验证过程。

如果想进一步了解 Coding Agent 应该如何验证结果，可以参考本站的 Codex 能力边界、代码验证与安全使用教程。虽然文章讲的是 Codex，但其中关于 Git Diff、测试、Build 和人工 Review 的思路同样适用于 Claude Code。

常见问题 FAQ

Claude Code Windows 必须安装 WSL 吗？

不需要。

2026 年官方已经支持 Windows 原生运行 Claude Code。

如果需要 Linux 工具链、WSL 项目或者沙箱环境，再选择 WSL 2。

Claude Code 还需要 Node.js 吗？

如果使用当前官方推荐的 Native Install，不再需要为了安装 Claude Code 专门先配置 npm。

一些旧教程使用 npm 安装，因此会要求提前安装 Node.js。

怎么确认 Claude Code 安装成功？

运行：

claude --version

如果能够正常返回 Claude Code 版本号，说明基础安装已经完成。

Claude Code 可以直接修改项目代码吗？

可以。

在获得相应文件权限后，它可以读取项目并修改文件。不过修改后仍建议通过 Git Diff、测试和实际运行结果进行验证。

Claude Code 和普通 Claude 聊天有什么区别？

普通 Claude 更偏向对话和代码问答。

Claude Code 则直接工作在开发环境和代码项目中，可以读取项目、修改文件并运行开发工具。

总结

2026 年 Claude Code 的安装已经比早期简单很多。Windows 可以直接原生安装，macOS、Linux 和 WSL 则可以使用官方 Native Installer。

Windows PowerShell：

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

macOS / Linux / WSL：

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

安装后检查：

claude --version

进入项目：

cd your-project
claude

对新用户来说，最值得掌握的并不是几十个命令，而是一个正确的工作方式：

先让 Claude 理解项目，再给明确任务，最后通过 Git Diff 和测试验证结果。

这样才是 Claude Code 真正适合软件开发的使用方式。

参考资料

1. Anthropic Claude Code Docs — Quickstart：Claude Code 官方安装、登录、项目启动及基础使用说明。

2. Anthropic Claude Code Docs — Advanced setup：Windows 原生 / WSL、系统要求、Native Install、WinGet、Homebrew、更新与 claude doctor 说明。

3. CocoLoop AI 社区：《Claude Code 超详细完整指南（2026最新版）》：本文在安装结构与基础入门部分参考了该文章的教程思路，并根据 Anthropic 当前官方文档更新了 Windows 和安装方式。

资料核对时间：2026 年 8 月 26 日。 Claude Code 更新较快，安装方式、系统支持和具体命令应以 Anthropic 最新官方文档为准。