首页 关于
← 返回首页
2026-08-28 教程

这是一篇claudecode的我自己的安装心得教程

Claude Code 安装教程

Claude Code 安装教程

Claude Code 是 Anthropic 推出的终端 AI 编程助手，可以直接在命令行中帮你编辑文件、运行命令、理解代码库和自动化开发任务。

一、系统要求

项目要求
macOS10.15+（推荐 13.0+）
WindowsWindows10 1809+ 或 Windows Server 2019+（或通过 WSL 运行）
LinuxUbuntu 20.04+、Debian 10+、Alpine 3.19+
Node.js18+（如使用 npm 安装方式）
硬件4 GB+ RAM，x64 或 ARM64 处理器
网络互联网连接

特别提示： 原生安装方式（推荐）不需要预先安装 Node.js Windows 用户建议安装 git，以便 Claude Code 使用 Bash 工具。 Claude Code 需要 Claude Pro/Max/Team/Enterprise 订阅，或 Anthropic Console 账号。

二、安装方式

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

原生安装会自动在后台更新到最新版本。

macOS / Linux / WSL：

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

Windows（PowerShell）：

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

Windows（CMD）：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

⚠️ 注意区分终端类型：

  • 提示符显示 PS C:\ → 你在 PowerShell 中

  • 提示符显示 C:\（无 PS）→ 你在 CMD 中

如果在 PowerShell 中误用了 CMD 的命令（含 &&），会报错 The token ‘&&’ is not a valid statement separator；如果在 CMD 中误用了 PowerShell 的命令（含 irm），会报错 ‘irm’ is not recognized。

方式二：使用 npm + 国内镜像源（国内用户推荐）

由于 [claude.ai](claude.ai) 在国内可能无法直接访问，使用 npm 配合国内镜像源是最稳妥的安装方式。这种方式通过 npm 安装官方包，但利用淘宝镜像加速下载。

步骤 1：安装 Node.js

Claude Code 通过 npm 安装时需要 Node.js 18 或更高版本。 国内镜像站：https://nodejs.org/zh-cn/download

安装完成后验证：

node -v
npm -v

步骤 2：设置 npm 国内镜像源（可选）

可以永久设置淘宝镜像源，后续所有 npm 包安装都会加速：

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

步骤 3：安装 Claude Code

使用淘宝镜像源一次性安装（推荐）：

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

如果已设置永久镜像源，直接运行：

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

⚠️ 注意：不要使用 sudo 运行 npm install，否则会导致后续文件权限问题。

注意：npm 官方安装方式已被官方弃用，未来版本将移除。从 v2.1.198 开始，npm 包需要 Node.js 22 或更高版本。

方式三：通过第三方镜像站安装（备选）

# 镜像站 1
npm install -g https://mirror.o3pro.pro/install

# 镜像站 2
npm install -g https://gaccode.com/claudecode/install --registry=https://registry.npmmirror.com

⚠️ 注意：第三方镜像站可能会修改官方安装包，可能存在功能缺失或更新滞后的问题。建议优先使用方式二的官方包 + 镜像源组合。

方式四：Homebrew（macOS / Linux）

brew install --cask claude-code

方式五：WinGet（Windows）

winget install Anthropic.ClaudeCode

三、验证安装

安装完成后，运行以下命令确认安装成功：

claude --version

如果显示版本号，说明安装成功。

四、首次启动与登录

进入你的项目目录：

cd your-project

启动 Claude Code：

claude

完成登录认证：首次启动时，系统会提示你在浏览器中完成 OAuth 授权，登录你的 Claude 账号即可。如果浏览器没有自动打开，按 c 键复制 URL 手动粘贴到浏览器中。

使用 API Key 的方式

如果你有 Anthropic Console 的 API Key，可以设置环境变量跳过登录提示：

export ANTHROPIC_API_KEY=sk-ant-…
claude

五、接入国产模型（国内用户替代方案）

Claude Code 可以配置使用国产模型（如智谱 GLM、DeepSeek、Kimi K2 等），绕过 Claude Pro 订阅限制。

临时使用环境变量

export ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic
export ANTHROPIC_AUTH_TOKEN=你的智谱APIKey
claude

利用第三方软件

 ' cc switch ' 工具进行配置 , ' cc switch '可以管理多个agent的mcp,skills,模型等

永久配置（写入～/.claude/settings.json）

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your_api_key",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  }
}

六、国内用户安装方案对比

方案优点缺点
原生安装 + 代理官方纯净，功能完整需要代理环境
npm + 淘宝镜像官方包，国内直连，功能完整需要先装 Node.js
第三方镜像站安装方便，无需配置可能被魔改，功能滞后
接入国产模型无需 Claude 订阅，国内直连配置稍复杂

七、卸载方法

如需卸载 Claude Code：

  • 原生安装：删除～/.claude 目录即可

  • npm 安装：

npm uninstall -g @anthropic-ai/claude-code
  • Homebrew：
brew uninstall --cask claude-code
  • WinGet：
winget uninstall Anthropic.ClaudeCode

详细说明可参考 https://code.claude.com/docs/en/setup

复制全部内容，保存为 `ClaudeCode安装教程.md`。
> 提示：客户端可以本地安装；**Anthropic官方服务在中国大陆不提供服务，推荐使用对接国产模型的模式使用**。