手把手安装教程（2026最新版）

3 分钟安装，5 分钟上手，让 AI 成为你的编程搭子。

📋 安装前准备

在开始之前，请确保你有：

账户类型说明

🚀 安装方式选择

Claude Code 提供多种安装方式：

graph TD
    A[选择安装方式] --> B{你的系统?}
    B -->|macOS/Linux| C[原生安装 推荐]
    B -->|Windows| D[PowerShell 安装]
    B -->|已有 Node.js| E[NPM 安装]
    C --> F[完成安装]
    D --> F
    E --> F

2026 更新：最新版本 2.x 已优化原生安装方式，推荐优先使用原生安装。

🔧 方式一：原生安装（官方推荐）

2026 最新推荐：官方已优化原生安装方式，无需 Node.js，一键安装。

macOS / Linux / WSL

打开终端，运行：

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell

以管理员身份运行 PowerShell，执行：

irm https://claude.ai/install.ps1 | iex

验证安装

claude --version

看到版本号输出，说明安装成功！

🔧 方式二：NPM 安装

如果你已经安装了 Node.js 18+，也可以使用 NPM：

前置条件

需要 Node.js 18 或更高版本。检查方法：

node --version

如果版本号 >= 18.0.0，可以继续。如果未安装或版本过低：

brew install node

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

安装命令

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

国内镜像加速

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

验证安装

claude --version

🔐 登录账户

安装完成后，需要进行账户登录。

步骤 1：启动 Claude Code

在你的项目目录下运行：

cd /path/to/your/project
claude

步骤 2：选择登录方式

首次启动会提示登录，有两种方式：

Claude.ai 登录流程：

1. 终端会显示一个 URL
2. 浏览器自动打开登录页面
3. 输入你的 Claude.ai 账户密码
4. 授权完成后，终端显示登录成功

Anthropic Console 登录流程：

1. 访问 Anthropic Console
2. 创建或获取 API Key
3. 在终端粘贴 API Key

步骤 3：登录成功

看到类似提示，说明登录成功：

✓ Logged in as your-email@example.com

登录凭据会保存在本地，下次使用无需重新登录。

🇨🇳 国内用户特别指南

国内用户可以直接使用国产大模型服务，无需翻墙。2026 年 2 月更新：已有多家国产大模型厂商推出 Coding Plan 服务。

2026 国内服务商一览

方案一：智谱 GLM Coding Plan（强烈推荐）

智谱 GLM Coding Plan 提供国内直连的 Claude Code 接入服务。

2026 春节重大更新：GLM-5 发布，744B 参数 MoE 架构（256 专家，激活 40B），202K 上下文，编程能力超越 Claude Opus 4.6。

配置步骤：

1. 注册 智谱开放平台 账号
2. 订阅 Coding Plan 服务
3. 配置 ~/.claude/settings.json 文件：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的智谱API Key",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5"
  }
}

4. 创建 ~/.claude.json 文件：

{
  "hasCompletedOnboarding": true
}

可用的 GLM 模型：

方案二：DeepSeek（性价比之王）

DeepSeek 提供 1M 超长上下文，API 成本极低。

2026 优势：

• 1M 上下文（网页/APP 端）：能处理超大规模代码库，API 端目前为 128K
• 极低成本：API 价格远低于官方
• R1 推理模型：复杂逻辑推理能力强

配置步骤：

1. 注册 DeepSeek 开放平台 账号
2. 获取 API Key
3. 配置 ~/.claude/settings.json 文件：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com",
    "ANTHROPIC_AUTH_TOKEN": "你的DeepSeek API Key",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-chat",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-coder",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-reasoner"
  }
}

可用的 DeepSeek 模型：

方案三：MiniMax Coding Plan

MiniMax Coding Plan 同样提供国内直连服务。

配置步骤：

1. 注册 MiniMax 开放平台 账号
2. 订阅 Coding Plan 服务
3. 配置 ~/.claude/settings.json 文件：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.minimaxi.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的MiniMax API Key",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "ANTHROPIC_MODEL": "MiniMax-M2.5",
    "ANTHROPIC_SMALL_FAST_MODEL": "MiniMax-M2.5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M2.5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M2.5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M2.5"
  }
}

4. 创建 ~/.claude.json 文件：

{
  "hasCompletedOnboarding": true
}

推荐工具：cc-switch

MiniMax 推荐使用 cc-switch 工具快速切换配置：

# macOS / Linux
brew tap farion1231/ccswitch
brew install --cask cc-switch

启动 cc-switch 后，添加 MiniMax 供应商配置即可一键切换。

方案四：使用代理访问官方 API

如果你有稳定的代理服务：

# 设置 HTTP 代理
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890

# 正常登录 Claude.ai
claude

方案五：使用国内镜像源安装

如果 NPM 安装慢，使用淘宝镜像：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

国内服务商对比（2026年2月）

提示：配置完成后，在 Claude Code 中输入 /doctor 可诊断环境。

注意：上下文长度数据来自 2026 年 2 月官方信息，实际可用上下文可能因订阅套餐不同而异。DeepSeek 的 1M 上下文目前仅网页/APP 端支持，API 仍为 128K。

✅ 安装验证清单

安装完成后，按以下清单验证：

graph LR
    A[claude --version] --> B[claude]
    B --> C[输入问题测试]
    C --> D[✅ 安装成功]

测试命令

进入交互模式后，试试这些命令：

> 这个项目是什么技术栈？
> 帮我看看 package.json 里有哪些依赖
> 给这个项目写一个简单的 README

🔧 常见问题排查

Q1：安装时提示权限错误

macOS/Linux：

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

或者修复 npm 权限：

sudo chown -R $(whoami) ~/.npm
sudo chown -R $(whoami) /usr/local/lib/node_modules

Windows：以管理员身份运行 PowerShell

Q2：登录后提示认证失败

1. 检查网络连接
2. 确认账户状态正常
3. 尝试重新登录：

claude logout
claude login

Q3：国内用户连接超时

1. 确认代理配置正确
2. 测试代理是否生效：

curl -x http://127.0.0.1:7890 https://api.anthropic.com

3. 考虑使用中转服务（见上方方案）

Q4：NPM 安装很慢

使用国内镜像：

npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code

Q5：如何更新到最新版本？

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

Q6：如何卸载？

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

Q7：如何查看帮助？

claude --help

或在交互模式中输入：

> /help

📁 目录结构说明

安装完成后，Claude Code 会在用户目录创建配置文件夹：

~/.claude/
├── config.json        # 全局配置
├── credentials.json   # 登录凭据（自动生成）
├── settings.json      # 设置
└── projects/          # 项目配置缓存

🎯 下一步

安装完成后，你已经可以开始使用 Claude Code 了！

👉 第 3 篇：10分钟上手：你的第一个 Claude Code 项目

📚 延伸阅读

官方资源

• Claude Code 官方文档 - Quickstart
• Claude Code GitHub
• Claude.ai 订阅页面
• Anthropic Console

国内服务商

• 智谱 GLM Coding Plan
• DeepSeek 开放平台
• MiniMax Coding Plan

社区教程（2026 最新）

• Claude Code CLI 参考手册（菜鸟教程）
• 国内 AI 编程 Coding Plan 深度调研
• Claude Code 接入 DeepSeek 全指南

作者：AI布道官 发布日期：2026年2月 系列：《Claude Code 完全指南》第 2 篇