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 通常运行在命令行环境中。

推荐环境组合

  • Windows 10 / 11
  • PowerShell 或 Windows Terminal
  • 已安装常用开发环境(如 Node / Python)

安装的基本流程思路

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

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

这里强调一点:

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

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


常见 Windows 安装问题

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

这些问题,大多数不是 Claude Code 本身的问题,而是:

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

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


三、macOS 安装思路

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

推荐环境组合

  • macOS(较新版本)
  • 系统自带 Terminal 或 iTerm2
  • Homebrew 已安装(强烈建议)

macOS 的开发工具链更统一,很多依赖处理起来更省心。


安装流程的核心逻辑

macOS 下的安装,同样可以抽象为:

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

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


四、第一次运行时,你会看到什么?

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

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

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

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

这是正常的。

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


五、建议的首次使用方式

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

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

例如:

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

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

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


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

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

"好了,我会用了。"

但实际上:

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

后面的内容,我们会重点讲:

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

七、小结

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

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

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


相关推荐
Maynor9961 小时前
Trymodel 使用介绍:一个平台同时用 Claude、GPT、Gemini 和 Grok
人工智能·gpt·ai·程序员·教程·claude·语音
郑世录3 小时前
codex 接本地模型,单次输出卡在 3208 token:一份照着做就能改的完整教程
ai编程
学无止境小袁同学3 小时前
Google ADK 学习指南
python·llm·agent·多agent·google adk·llmagent·agent cli
观察员4 小时前
告别频繁锁屏:5行 PowerShell 脚本实现 Windows 自动防休眠
windows·命令行
JavaGuide4 小时前
Gemini 真的变强了,写代码做视频的能力接近 Claude Opus5.5 了!
前端·ai编程
qinglongcn4 小时前
四面统一:记忆/Session/观测/Cron
agent·ai编程
qinglongcn4 小时前
从 metadata 键到独立列
agent·ai编程
Funlang5 小时前
在 Windows 95 上写前端
前端·javascript·windows
YanisJiang5 小时前
别只把 AI 聊天当成「又一个网页」:把状态驱动的陪伴内核接到你自己的项目里
ai编程
不要试图纠正别人6 小时前
榜单换个算法就洗牌:不是模型退步,是名次没有分辨率
llm·rails