Claude Code 安装实操教程(初学者版)

适用对象：第一次接触命令行、想在自己电脑上装好 Claude Code 的朋友。本文以官方标准安装方式为主，文末附「用 DeepSeek 替代官方账号」的实操方案。

一、先看懂：Claude Code 是啥、需要啥

Claude Code 是 Anthropic 出品的一个命令行编程助手。它不在桌面上有图标，而是装好后，在「终端 / Terminal」里输入 claude 命令启动，再用打字跟它对话、让它帮你写代码、做工具。

系统环境要求（必须满足）

🖥 操作系统：macOS 12 以上 / Windows 10 以上（需 WSL2）/ 常见 Linux。注意：Windows 不能用普通命令行，必须走 WSL。

📦 Node.js：18 或以上（推荐 20+）。Claude Code 是基于 Node 运行的，没它装不了。

⬇️ npm：随 Node 一起装好，用来下载安装包。

🌐 网络：能联网，安装时要下载，使用时也要联网。

💾 内存/硬盘：普通电脑即可，很轻量，不挑配置。

前置依赖：先检查有没有 Node.js

打开「终端」（Mac：启动台搜"终端"；Windows：用 WSL 的 Ubuntu 终端），输入：

node -v

如果显示 v18.x.x 或更高（如 v20.x.x）→ 已经有了，跳过安装 Node；如果显示 command not found 或版本低于 18 → 需要先装 Node。

装 Node 最省事的方法（任选其一）：

· macOS：装 Homebrew 后 brew install node；或直接去 nodejs.org 下载 LTS 安装包双击装。

· Linux / WSL：sudo apt update && sudo apt install -y nodejs npm

· Windows（WSL 内）：同 Linux 命令。

装完再跑一次 node -v 确认版本 ≥ 18。

二、分系统安装步骤

▶ macOS（最推荐）

方法 A：用 npm 安装（通用、最稳）

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

装完输入 claude --version，能看到版本号就成功了。

方法 B：用 Homebrew 安装（Mac 用户更顺手）

brew install anthropic/tap/claude-code

▶ Linux（含 Ubuntu / Debian）

# 1. 确保 Node 和 npm 在 node -v npm -v  # 2. 全局安装 sudo npm install -g @anthropic-ai/claude-code  # 3. 验证 claude --version

如果 claude 提示找不到命令，见下文「常见报错」。

▶ Windows（必须通过 WSL，不能直接在 CMD/PowerShell 装）

Windows 原生不支持，正确姿势是「先开 WSL 子系统，再在里头装」。

第 1 步：开启 WSL（只需做一次）。以管理员身份打开 PowerShell，输入：

wsl --install

装完按提示重启电脑。重启后首次会让你设一个 Linux 用户名和密码。

第 2 步：在 WSL 里装 Node。打开「Ubuntu」应用（开始菜单搜 Ubuntu），在里面输入：

sudo apt update && sudo apt install -y nodejs npm node -v

第 3 步：安装 Claude Code

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

第 4 步：以后怎么进。每次用，就打开「Ubuntu」这个应用，输入 claude 回车即可。

三、安装完成后：怎么验证真的装好了

按下面三步走，全过就说明装对了：

① 看版本号

claude --version

正常会输出类似 2.1.138 (Claude Code)（版本号随更新变化，有数字就正常）。

② 启动一次。直接在终端输入：

claude

第一次会进入初始化设置（选颜色主题、登录账号等）。能进到对话界面、底部出现输入框，就算启动成功。

③ 说句话试试。在输入框里打一句：你好，介绍一下你自己。能回话就说明通了。

四、官方登录方式（标准）

启动 claude 后，它会让你登录：

· 通常弹出一个浏览器网页，用 Anthropic 账号登录授权即可；

· 如果没有账号，也可以设置环境变量 ANTHROPIC_API_KEY=你的key 后启动。

⚠️ 官方方式需要 Anthropic 账号，且调用走 Anthropic 的模型（有费用/地区限制）。

五、常见报错与解决方案

① command not found: claude（装完却找不到命令）

原因：npm 的全局命令目录没加进系统 PATH。解决：先查目录 npm bin -g，会返回一个路径（如 /usr/local/bin），确认这个路径在你的 PATH 里。Mac 上若用 nvm 管理 Node，重启终端即可；或把下面这行加进 ~/.zshrc 再重开终端：

export PATH="$PATH:$(npm bin -g)"

临时救急：用完整路径启动，例如 /usr/local/bin/claude。

② EACCES: permission denied（权限报错）

原因：全局安装没写权限。解决（推荐，别用 sudo 硬刚）：用 nvm 管理 Node（nvm 装在用户目录下，不会有权限问题）；或修正 npm 全局目录权限：

npm config set prefix ~/.npm-global

并把该 bin 加进 PATH。实在急用可 sudo npm install，但不推荐长期这么干。

③ Node version too old / 版本过低

原因：Node 低于 18。解决：去 nodejs.org 下载 LTS 版重装，或用 nvm 装新版本：

nvm install 20 && nvm use 20

④ Windows 直接装报错 / 跑不起来

原因：在 CMD 或 PowerShell 里装了，但 Claude Code 不支持原生 Windows。解决：必须走上文「Windows → WSL」流程，在 Ubuntu 子系统里安装运行。

⑤ 启动后卡在登录 / 连不上

原因：官方 Anthropic 账号或网络问题。解决：换用「自定义模型后端」方案（见下节），或检查网络/代理。

⑥ 终端里字太小看不清

解决：终端窗口内按 ⌘ +（Mac）放大字体；或终端设置 → 描述文件 → 文本 → 改字号。

六、附：用 DeepSeek 替代官方账号

如果你不想注册 Anthropic、想用国内的 DeepSeek 来驱动 Claude Code，可以不登录官方，改走「自定义后端」。

原理：DeepSeek 提供了兼容 Anthropic 的接口地址，让 Claude Code 把请求发到 DeepSeek 即可。

做法（Mac 示例，启动前在终端设置环境变量）：

export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic" export ANTHROPIC_AUTH_TOKEN="你的DeepSeek密钥(sk-开头)" export ANTHROPIC_MODEL="deepseek-v4-flash" export DISABLE_AUTOUPDATER="1" claude

· ANTHROPIC_AUTH_TOKEN 填你 DeepSeek 后台拿到的密钥；

· DISABLE_AUTOUPDATER=1 防止它自动升级、锁死你指定的版本；

· 嫌每次敲麻烦，可把这几行写进一个 .command 启动脚本或桌面图标，双击即开。

注意：DeepSeek 的 deepseek-v4-flash 是会先"思考"再回答的模型，若回答回空，多半是输出 token 上限太小，把上限调大即可。

七、一句话总结流程

1. 装 Node（≥18）→ 2. 终端里 npm install -g @anthropic-ai/claude-code → 3. claude --version 验证 → 4. claude 启动并登录（或配 DeepSeek 后端）→ 5. 说句话测试。

卡在哪一步，把报错截图发来，我帮你看。

——本文由 AI 辅助整理发布