Claude Code 安装指南:4 种安装方式 + 3 种登录方案(Windows/macOS/Linux 全平台)

1. 怎么安装 Claude Code？
2. 怎么登录并真正跑起来？

覆盖 Windows、macOS、Linux 全平台，照着操作，10 分钟基本都能跑通。

一、先装一个依赖：Node.js

Claude Code 本质上是一个 Node.js CLI 工具，所以需要先安装 Node.js 环境。

去 Node.js 官网下载 LTS（长期支持版），建议版本：

• Node.js ≥ 18
• 推荐 Node.js 20 LTS

安装完成后，在终端验证：

node -v
npm -v

能看到版本号，说明环境正常。

如果 npm 下载比较慢，可以临时切换国内镜像：

npm config set registry https://registry.npmmirror.com

安装完成后建议切回官方源：

npm config set registry https://registry.npmjs.org

注意：切镜像只是加速项，不是必选项，先跑通再优化。

二、4 种安装方式，选一个即可

根据自己的系统和习惯选择一种安装方式：

推荐方案：

大部分用户直接使用：

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

兼容性最好，也最容易排查问题。

安装完成后验证：

claude --version

看到版本号，就说明安装成功。

三、3 种登录方式，选一个即可

第一次运行：

claude

Claude Code 会要求登录。

方式 A：OAuth 浏览器授权（推荐新手）

执行 claude 后，会自动打开浏览器并跳转到 Anthropic 控制台完成授权。

适合：

• 个人开发者
• 官方订阅用户
• 第一次体验 Claude Code

优点是零配置、最省事。

注意：国内可能无法访问官方页面，也存在封号问题。

方式 B：直接配置 ~/.claude.json

如果无法使用 OAuth，或者需要使用 API Key、中转服务、CI/CD 环境，可以直接修改配置文件。

先运行一次：

claude

生成配置文件后，编辑：

{
"hasCompletedOnboarding": true,
"primaryApiKey": "sk-ant-你的Key"
}

保存后重新打开终端，再次执行 claude 即可。

如果接入 DeepSeek 或其他兼容服务，可以配置：

{
"env": {
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
"ANTHROPIC_MODEL": "deepseek-chat"
  }
}

两个容易踩坑的地方：

1. 地址必须带 /anthropic 后缀；
2. 使用的是 ANTHROPIC_AUTH_TOKEN，不是 API_KEY。

方式 C：图形化切换工具 cc-switch

如果经常需要切换官方账号、DeepSeek、中转服务或者多个 API Key，可以使用 cc-switch。

它支持：

• 50+ Provider 预设
• 一键切换账号
• MCP 管理
• 配置备份
• 本地代理和故障转移

比较适合重度用户和团队协作场景。

四、最容易卡住的 3 个问题

1. 安装成功但找不到 claude

通常是环境变量没有刷新。

解决办法：

• 关闭并重新打开终端；
• 检查 PATH 配置；
• 执行：

npm prefix -g

确认全局安装目录是否已加入环境变量。

2. 登录后提示 401 Unauthorized

一般只有三种原因：

• API Key 填错；
• 账号余额不足；
• 区域限制导致请求失败。

建议先重新复制 Key，再排查网络和账户状态。

3. 修改配置后仍然跳登录页

大概率是配置文件有问题。

重点检查：

{
"hasCompletedOnboarding": true
}

是否存在，以及 JSON 是否有语法错误。

最稳的方法：

python -m json.tool < ~/.claude.json

能正常输出，就说明格式没有问题。

五、装好之后第一件事：执行 /init

不要急着直接提问。

先进入项目目录：

cd 你的项目
claude

然后执行：

/init

Claude Code 会自动扫描项目结构、分析技术栈，并生成一份 CLAUDE.md 草稿。

这个动作相当于给 AI 做一次项目入职培训，让它理解你的代码规范、目录结构和开发约定。

以后无论是写代码、重构、修 Bug，还是生成测试，Claude Code 的表现都会明显提升。

推荐路线：

Node.js → 安装 Claude Code → 登录 → 进入项目目录 → /init

先保证跑起来，再考虑切源、多模型和高级玩法。