外观
国内如何安装 Claude Code?
一句话回答:Windows 用户只需两步——先装 Git Bash,再运行一行安装命令;国内用户会遇到 claude.ai 域名不可访问的问题,把安装脚本换成镜像地址即可解决,最后给系统 PATH 添加安装目录就能用
claude命令启动。
安装前须知
- 最新版 Claude Code 不再需要安装 Node.js,流程比早期教程大幅简化
- 对电脑配置要求不高,2016 年的老电脑也能正常使用
- macOS / Linux 比 Windows 更简单(原生兼容,跳过第一步)
第一步:安装 Git Bash(仅 Windows)
Claude Code 原生是为 Linux 和 macOS 设计的,Windows 的命令体系和它们有区别。Git Bash 相当于一个翻译层,让 Claude Code 能在 Windows 上顺畅运行。
- 从 Git 官网下载安装包(官网慢可以用国内镜像站)
- 安装过程中所有选项保持默认,一路下一步
第二步:安装 Claude Code 本体
右键开始菜单 → 终端(管理员),打开 PowerShell,输入官方安装命令:
powershell
irm https://claude.ai/install.ps1 | iex坑:claude.ai 域名屏蔽了中国大陆用户。 如果运行报错,说明脚本下载被拦截,可以换成与官方内容一致的镜像脚本:
powershell
irm https://daheiai.com/cc.ps1 | iex(运行前可能需要先执行一行开放本地脚本权限的命令。)
注意:镜像只解决"下载安装脚本"这一步。之后约 200MB 的程序本体仍从谷歌云拉取——无代理能下但很慢(可能 2-3 小时,挂一晚上也行),有代理 1-2 分钟。
Mac / Linux 用户使用官方对应的一行安装命令即可,通常没有域名拦截问题。
第三步:添加 PATH 环境变量
安装完成后输入 claude 可能报错"无法识别"。原因类比图形界面:软件装好了,但没创建"快捷方式",系统不知道去哪找它。
解决方法:
- 开始菜单搜索"环境变量"→ 编辑系统环境变量
- 点"环境变量"→ 找到系统变量里的 Path → 双击 → 新建
- 填入 Claude Code 的安装目录:
C:\Users\你的用户名\.local\bin\ - 确定保存,关闭当前 PowerShell 重新打开,输入
claude即可启动
实在装不上怎么办
如果挂了一夜也没下载成功、排除了网络问题仍失败,可以退而求其次用 OpenCode:开源免费、下载快、门槛低得多。效果比 Claude Code 稍差,但功能几乎一致。
常见误区
- "需要先装 Node.js" —— 旧教程的说法,新版安装器已不需要。
- "装完就能用了" —— 还差最后一步:接入模型。没有 Claude 官方订阅的用户参见相关条目,可以接入国产模型使用。
相关条目
作者:人工大黑 · 转写自视频《Claude Code 从零安装教程》
