Claude Code 安装指南（Windows / macOS）

在前面的几篇里，我们已经把 Claude Code 的定位和使用理念讲清楚了。

从这一篇开始，正式进入动手阶段。

需要先说明一句：

Claude Code 的安装并不复杂，但对环境要求比较"工程化"。

如果你之前主要用的是网页版 AI，对命令行、环境变量不太熟，第一次可能会慢一点；

但一旦装好，后面使用成本会非常低。

一、安装前需要准备什么？

在开始之前，先确认这几件事。

1️⃣ 一台正常的开发环境

无论是 Windows 还是 macOS，都建议你已经具备：

能正常使用终端（Terminal / PowerShell）
本地已经有开发环境（如 Python、Node、Java 等其一即可）
熟悉基本的命令行操作

Claude Code 面向的是开发者工具链，并不是纯图形化软件。

2️⃣ 一个可用的 Claude 账号

Claude Code 基于 Claude 模型服务运行，因此你需要：

已注册的 Claude 账号
确认账号状态可正常使用

账号问题不解决，后面的步骤都会卡住。

3️⃣ 稳定的网络环境

这一点非常关键，也是很多人安装失败的根源。

你需要确保：

能稳定访问 Claude 相关服务
终端环境下网络是可用的（不是只有浏览器能上）

注意：

很多人浏览器能用，但命令行不行，问题往往出在代理或环境变量上。

二、Windows 安装思路

在 Windows 下，Claude Code 通常运行在命令行环境中。

安装的基本流程思路

整体流程可以概括为三步：

在终端中安装 Claude Code 客户端
配置必要的环境变量或认证信息
验证是否可以正常运行

这里强调一点：

不要在一开始就追求"完全理解每一步"

先让它跑起来，再回头理解原理。

常见 Windows 安装问题

命令无法识别
权限不足
网络连接失败

这些问题，大多数不是 Claude Code 本身的问题，而是：

终端权限
PATH 配置
代理未生效

后面我们会单独写一篇安装失败问题排查，这里先不用纠结。

三、macOS 安装思路

在 macOS 下，整体体验通常会更顺一点。

安装流程的核心逻辑

macOS 下的安装，同样可以抽象为：

使用命令行安装 Claude Code
配置访问权限和账号
验证运行状态

如果你平时就有用终端开发，基本不会遇到太大阻碍。

四、第一次运行时，你会看到什么？

成功安装后，第一次运行 Claude Code，通常会经历几个阶段：

初始化环境
读取当前项目结构
等待你的指令输入

这里很多人会产生一个误解：

"怎么没有界面？是不是装错了？"

这是正常的。

Claude Code 本身就是以开发者工具形态存在，而不是一个炫酷 UI 软件。

五、建议的首次使用方式

强烈建议你第一次这样用：

进入一个你比较熟悉的项目目录
启动 Claude Code
给一个非常简单、明确的任务

例如：

解释项目的整体结构
指出核心入口文件
总结主要模块职责

不要一上来就让它重构、改代码。

先建立信任感和使用节奏，非常重要。

六、安装完成 ≠ 可以用得好

很多人装完就会有一种错觉：

"好了，我会用了。"

但实际上：

安装只是入门
使用方式才决定效果

后面的内容，我们会重点讲：

如何正确提任务
如何给上下文
如何逐步推进复杂问题

七、小结

这一篇你只需要记住三点：

Claude Code 是开发者工具，不是普通软件
网络和终端环境非常关键
先跑起来，再追求理解

只要你能成功运行 Claude Code，后面的学习成本会明显降低。