本章节分别介绍 macOS 与 Windows 环境下 Claude Code CLI 的安装与接入呆呆兽 Hub 加速节点的完整流程。
Mac 安装教程
使用 Brew 安装 Node.js
Claude Code 依赖 Node.js 运行时。推荐通过 Homebrew 管理 Node.js 版本,保持环境整洁。
安装 Homebrew
# 下载并安装 Homebrew
curl -o- https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh | bash安装 Node.js
# 下载并安装 Node.js
brew install node
# 查看 Node.js 版本
node -v
# 查看 NPM 版本
npm -v安装 Claude Code
Claude Code 是 Anthropic 官方发布的 AI 编程助手 CLI 工具,通过 npm 全局安装。
全局安装 Claude Code CLI
npm install -g @anthropic-ai/claude-code验证安装
claude --version
# Claude Code x.x.x如遇到权限问题,可在命令前加 sudo,或配置 npm 全局目录到用户目录下。
运行健康检查
claude doctor此命令会检测环境配置是否正常,包括 API 连接状态。
npm config set registry https://registry.npmmirror.comv2.1.68 或以上版本。配置 AUTH_TOKEN & BASE_URL
配置呆呆兽 Hub 的 API 节点,让 Claude Code 通过加速线路连接 Anthropic 服务。
方式一:环境变量(推荐)
将以下配置写入 Shell 配置文件(~/.zshrc 或 ~/.bashrc):
# 呆呆兽 Hub - Claude Code 加速配置
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxx" # 替换为你的 API Key
export ANTHROPIC_BASE_URL="https://www.ddshub.cc"保存后,重载配置:
source ~/.zshrc
# 验证配置
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL方式二:交互式登录
直接运行 claude 命令,CLI 会引导你完成配置:
claude
# 程序会提示输入:
# > Enter your API key: sk-xxx
# > Enter API base URL (optional): https://www.ddshub.cc验证连接
配置完成后,在任意项目目录运行:
claude "你好,请用一句话介绍你自己"
# 预期输出:
# 我是 Claude,Anthropic 开发的 AI 助手。Windows 安装教程
使用 PowerShell 安装 Node.js
推荐通过 Chocolatey 包管理器安装 Node.js,方便后续版本管理与升级。
以管理员身份打开 PowerShell
右键点击「开始」菜单 → 选择「Windows PowerShell(管理员)」或「终端(管理员)」。
安装 Chocolatey 并安装 Node.js
# 下载并安装 Chocolatey
powershell -c "irm https://community.chocolatey.org/install.ps1|iex"
# 使用 Chocolatey 安装 Node.js
choco install nodejs --version="24.13.0"
# 查看 Node.js 版本
node -v
# 查看 NPM 版本
npm -v安装 Claude Code
Node.js 安装完成后,通过 npm 全局安装 Claude Code CLI。
全局安装 Claude Code CLI
npm install -g @anthropic-ai/claude-code验证安装
claude --version
# Claude Code x.x.x如遇到权限问题,请以管理员身份重新打开 PowerShell 后再执行。
npm config set registry https://registry.npmmirror.comv2.1.68 或以上版本。配置 AUTH_TOKEN & BASE_URL
Windows 推荐通过系统环境变量或 PowerShell Profile 持久化配置。
方式一:PowerShell Profile(推荐)
在 PowerShell 中运行以下命令,将配置写入 Profile 文件:
# 查看 Profile 路径
echo $PROFILE
# 编辑 Profile(若文件不存在会自动创建)
notepad $PROFILE在打开的文件末尾添加以下内容并保存:
# 呆呆兽 Hub - Claude Code 加速配置
$env:ANTHROPIC_AUTH_TOKEN = "sk-xxxxxxxxxxxxxxxx" # 替换为你的 API Key
$env:ANTHROPIC_BASE_URL = "https://www.ddshub.cc"重新打开 PowerShell 后配置自动生效,或立即执行:
. $PROFILE方式二:系统环境变量(GUI)
适合不常用命令行的用户:
打开系统环境变量设置
右键「此电脑」→「属性」→「高级系统设置」→「环境变量」,或直接在搜索栏输入 环境变量。
新建用户变量
在「用户变量」区域点击「新建」,依次添加:
重启终端并验证
echo $env:ANTHROPIC_AUTH_TOKEN
echo $env:ANTHROPIC_BASE_URL验证连接
配置完成后,在任意项目目录运行:
claude "你好,请用一句话介绍你自己"
# 预期输出:
# 我是 Claude,Anthropic 开发的 AI 助手。