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

AI布道官2026-02-27 12:54

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

📋 安装前准备

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

准备项 说明
终端/命令行 macOS/Linux 用 Terminal，Windows 用 PowerShell 或 CMD
代码项目 准备一个用于测试的项目目录
账户 Claude.ai 订阅账户（推荐）或 Anthropic Console API 账户

账户类型说明

账户类型 计费方式 推荐指数
Claude.ai 订阅 按月付费，不限使用量 ⭐⭐⭐⭐⭐ 推荐
Anthropic Console API 预付费，按 token 计费 ⭐⭐⭐ 适合开发者

🚀 安装方式选择

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
方式 优点 缺点 推荐度
原生安装 官方推荐、安装快、无依赖 - ⭐⭐⭐⭐⭐
PowerShell Windows 官方推荐 仅 Windows ⭐⭐⭐⭐⭐
NPM 安装 版本管理方便 需要 Node.js 18+ ⭐⭐⭐⭐

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

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

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

macOS / Linux / WSL

打开终端，运行：

bash 复制代码 
curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell

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

powershell 复制代码 
irm https://claude.ai/install.ps1 | iex

验证安装

bash 复制代码 
claude --version

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

🔧 方式二：NPM 安装

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

前置条件

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

bash 复制代码 
node --version

如果版本号 >= 18.0.0，可以继续。如果未安装或版本过低：
📦 点击展开：安装 Node.js

macOS (Homebrew)

bash 复制代码 
brew install node

Windows (官网下载)

  1. 访问 Node.js 官网
  2. 下载 LTS 版本（长期支持版）
  3. 双击安装包，按提示安装

Linux (Ubuntu/Debian)

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

安装命令

bash 复制代码 
npm install -g @anthropic-ai/claude-code

国内镜像加速

bash 复制代码 
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

验证安装

bash 复制代码 
claude --version

🔐 登录账户

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

步骤 1：启动 Claude Code

在你的项目目录下运行：

bash 复制代码 
cd /path/to/your/project
claude

步骤 2：选择登录方式

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

方式 说明 适合人群
Claude.ai 订阅账户登录 大多数用户
Anthropic Console API Key 登录 开发者

Claude.ai 登录流程：

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

Anthropic Console 登录流程：

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

步骤 3：登录成功

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

kotlin 复制代码 
✓ Logged in as your-email@example.com

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

🇨🇳 国内用户特别指南

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

2026 国内服务商一览

服务商 模型 特点 推荐度
智谱 GLM GLM-4.5-air, GLM-4.7, GLM-5 编程能力超 Claude Opus 4.6 ⭐⭐⭐⭐⭐
DeepSeek DeepSeek-V3, R1, Coder 1M 超长上下文、性价比极高 ⭐⭐⭐⭐⭐
MiniMax MiniMax-M2.5 提供 cc-switch 工具 ⭐⭐⭐⭐
火山方舟 字节跳动大模型 企业级服务 ⭐⭐⭐⭐
阿里云百炼 通义千问 Qwen 阿里生态集成 ⭐⭐⭐⭐
Kimi Moonshot 长上下文优势 ⭐⭐⭐

方案一：智谱 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 文件：
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"
  }
}
  1. 创建 ~/.claude.json 文件：
json 复制代码 
{
  "hasCompletedOnboarding": true
}

可用的 GLM 模型：

模型 说明 适用场景
glm-4.5-air 快速模型 简单任务、快速响应
glm-4.7 旗舰模型 复杂任务、代码生成
glm-5 最新 MoE 架构 最高质量输出、超 Claude Opus

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

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

2026 优势：

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

配置步骤：

  1. 注册 DeepSeek 开放平台 账号
  2. 获取 API Key
  3. 配置 ~/.claude/settings.json 文件：
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 模型：

模型 说明 适用场景
deepseek-chat 通用对话 日常问答
deepseek-coder 代码专用 编程任务
deepseek-reasoner R1 推理模型 复杂逻辑

方案三：MiniMax Coding Plan

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

配置步骤：

  1. 注册 MiniMax 开放平台 账号
  2. 订阅 Coding Plan 服务
  3. 配置 ~/.claude/settings.json 文件：
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"
  }
}
  1. 创建 ~/.claude.json 文件：
json 复制代码 
{
  "hasCompletedOnboarding": true
}

推荐工具：cc-switch

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

bash 复制代码 
# macOS / Linux
brew tap farion1231/ccswitch
brew install --cask cc-switch

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

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

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

bash 复制代码 
# 设置 HTTP 代理
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890

# 正常登录 Claude.ai
claude

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

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

bash 复制代码 
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

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

服务商 模型 上下文 价格 特点
智谱 GLM GLM-5 202K 订阅制 编程超 Claude Opus
DeepSeek V3/R1/Coder 1M (网页端) 极低 API 为 128K
MiniMax M2.5 128K 订阅制 cc-switch 工具
火山方舟 Seed1.6 256K-512K 企业定价 企业级
阿里百炼 Qwen3 256K-1M 订阅制 阿里生态
Kimi Moonshot 200万字 订阅制 超长上下文

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

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

✅ 安装验证清单

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

graph LR A[claude --version] --> B[claude] B --> C[输入问题测试] C --> D[✅ 安装成功]
检查项 命令 预期结果
版本检查 claude --version 显示版本号
启动测试 claude 进入交互模式
简单问答 > 你好 AI 正常回复

测试命令

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

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

🔧 常见问题排查

Q1：安装时提示权限错误

macOS/Linux：

bash 复制代码 
sudo npm install -g @anthropic-ai/claude-code

或者修复 npm 权限：

bash 复制代码 
sudo chown -R $(whoami) ~/.npm
sudo chown -R $(whoami) /usr/local/lib/node_modules

Windows：以管理员身份运行 PowerShell

Q2：登录后提示认证失败

  1. 检查网络连接
  2. 确认账户状态正常
  3. 尝试重新登录：
bash 复制代码 
claude logout
claude login

Q3：国内用户连接超时

  1. 确认代理配置正确
  2. 测试代理是否生效：
bash 复制代码 
curl -x http://127.0.0.1:7890 https://api.anthropic.com
  1. 考虑使用中转服务（见上方方案）

Q4：NPM 安装很慢

使用国内镜像：

bash 复制代码 
npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code

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

bash 复制代码 
npm update -g @anthropic-ai/claude-code

Q6：如何卸载？

bash 复制代码 
npm uninstall -g @anthropic-ai/claude-code

Q7：如何查看帮助？

bash 复制代码 
claude --help

或在交互模式中输入：

shell 复制代码 
> /help

📁 目录结构说明

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

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

🎯 下一步

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

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

📚 延伸阅读

官方资源

国内服务商

社区教程（2026 最新）

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

相关推荐
别动我齐刘海3 分钟前
Linux 系统调试学习2
linux·运维·c++·人工智能·学习·机器学习·机器人
Dawson Zhu4 分钟前
《Agentic Design Patterns》第 18 章导读：Guardrails 安全模式
人工智能·语言模型·架构·aigc·agi
探客木木夕6 分钟前
结构超图重构神经网络模型：脉冲权重节点与四阶段闭环框架
人工智能·深度学习·神经网络
地理探险家15 分钟前
从零实现图片自动分类：数据准备、模型训练与单图预测
人工智能·深度学习·机器学习·分类·数据挖掘·数据集
亲笔签20 分钟前
“场景重庆”典型案例 | 数字笔迹技术赋能政务服务 打造可信电子签署创新场景
大数据·人工智能
马剑威（威哥爱编程）20 分钟前
【共创稿事节】HarmonyOS 7 Agent 开发实战 04：云端 RAG 搭企业私有知识库问答
人工智能·华为·harmonyos
snhna22 分钟前
DeerFlow 2.x 源码拆解：多智能体委派、Skills、沙箱与 Linux 部署实战
人工智能·python
m4Rk_27 分钟前
【论文阅读】Agent 记忆机制（99）：PrisMem——从整体分数搜索走向能力驱动的记忆自进化
论文阅读·人工智能·学习·开源·github
喵叔哟33 分钟前
第 4 章 用 Constitution 给 AI 编程立法
人工智能
2401_8652616335 分钟前
亦唐科技国产贴片机的质量控制与生产优化之路
人工智能
热门推荐
01国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）02历年考研数学一、数学二、数学三真题试卷及答案PDF03GitHub 镜像站点04「全语录+省流版」邵艾伦 × 孙宇晨：聊风口、聊个人IP、聊年轻人如何抓住 AI 时代的机会05Windows 10/11 如何退出微软账户并改用本地账户登录（含找不到选项的解决方法）06蜘蛛磁力 搜索引擎大全，如何使用蜘蛛磁力查找磁力链接07几个好用的ip纯净度检测网站08轻量化AI渗透武器库｜ARTEX自主攻防系统、资产梳理、漏洞挖掘、链路分析全流程智能化落地09如何新建文件夹？ 电脑新建文件夹的4种方法10Telegram APK 下载安装完整指南 — 2026年最新