手把手安装教程（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 篇

相关推荐
档案宝档案管理20 小时前
档案宝｜开箱即用，打破档案管理“复杂魔咒”
数据库·人工智能·档案·档案管理
乾元20 小时前
安全官（CISO）的困惑：AI 投入产出比（ROI）的衡量
网络·人工智能·安全·网络安全·chatgpt·架构·安全架构
踩着两条虫20 小时前
低代码 + AI，到底是生产力革命，还是下一代“技术债务”？
前端·人工智能·低代码
weixin_4639234220 小时前
论文有效降AIGC率的两种办法
人工智能·aigc·论文笔记
70asunflower20 小时前
CUDA基础知识巩固检验练习题【附有参考答案】（8）
c++·人工智能·cuda
fl17683120 小时前
广东省所有学校名称2026月3月版39513条数据
人工智能
love530love20 小时前
Duix-Avatar 去 Docker Desktop 本地化完整复盘
人工智能·pytorch·windows·python·docker·容器·数字人
企业培训大师20 小时前
学校组织线上考试用什么系统合适？3款高适配系统推荐
大数据·人工智能
豆豆20 小时前
支持信创国产化的CMS：PageAdmin平台版，集成AI与站群全能平台
大数据·人工智能·cms·网站建设·网站制作·建站系统·网站管理系统
m0_5648768420 小时前
Transformer架构
人工智能
热门推荐
01GitHub 镜像站点02Qwen3.5 开源全解析：从 0.8B 到 397B，代际升级 + 全场景选型指南03OpenClaw 使用和管理 MCP 完全指南04UV安装并设置国内源05AI 编程三剑客：Spec-Kit、OpenSpec、Superpowers 深度对比与实战指南06小黑课堂计算机二级WPSoffice题库软件下载安装教程（2026年3月最新版）07OpenClaw Control UI安全上下文访问配置08Claude Code + GLM4.7 避坑指南：解决 Unable to connect to Anthropic services09让 Trae IDE 智能体 “读懂”文档 Excel+PDF+DOCX ：mcp-documents-reader 工具使用指南10OpenClaw macOS 完整安装与本地模型配置教程（实战版）