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

相关推荐
用户60648767188961 小时前
国内开发者如何接入 Claude API？中转站方案实战指南（Python/Node.js 完整示例）
人工智能·python·api
用户5191495848452 小时前
Citrix NetScaler内存泄漏漏洞利用工具 (CVE-2025-5777)
人工智能·aigc
星纬智联技术2 小时前
Codex 增强版：对标 Claude Code 新增 Agent Teams、Hooks、anthropic api Agent 、WebUI
人工智能
AI布道官2 小时前
Claude Code 是什么？为什么它改变了 AI 编程
人工智能
只与明月听2 小时前
RAG深入学习之Chunk
前端·人工智能·python
aircrushin2 小时前
百万Token时代的工程突破：DeepSeek如何以1/2成本实现长文本推理革命
人工智能
uuutt3332 小时前
从闲置到满配：树莓派作为 OpenClaw 宿主的完整实践
人工智能
Guass2 小时前
OpenClaw优化飞书API 额度已耗尽问题
人工智能
七牛云行业应用3 小时前
大模型接入踩坑录：被 Unexpected end of JSON 折磨三天，我重写了SSE流解析
javascript·人工智能·代码规范
热门推荐
01GitHub 镜像站点02【OpenClaw 本地实战 Ep.3】突破瓶颈：强制修改 openclaw.json 解锁 32k 上下文记忆03OpenClaw 使用和管理 MCP 完全指南04Claude Code + GLM4.7 避坑指南：解决 Unable to connect to Anthropic services05AI Agent 平台横评：ZeroClaw vs OpenClaw vs Nanobot06AI 规范驱动开发“三剑客”深度对比：Spec-Kit、Kiro 与 OpenSpec 实战指南07Clawdbot部署教程：解决‘gateway token missing’授权问题的完整步骤08让 Trae IDE 智能体 “读懂”文档 Excel+PDF+DOCX ：mcp-documents-reader 工具使用指南09Window 10部署openclaw报错node.exe : npm error code 12810AI agent：介绍 ZeroClaw 安装，使用