Claude Code 配置

本章节分别介绍 macOS 与 Windows 环境下 Claude Code CLI 的安装与接入呆呆兽 Hub 加速节点的完整流程。

Mac 安装教程

使用 Brew 安装 Node.js

Claude Code 依赖 Node.js 运行时。推荐通过 Homebrew 管理 Node.js 版本,保持环境整洁。

1

安装 Homebrew

bash
# 下载并安装 Homebrew
curl -o- https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh | bash
2

安装 Node.js

bash
# 下载并安装 Node.js
brew install node

# 查看 Node.js 版本
node -v

# 查看 NPM 版本
npm -v

安装 Claude Code

Claude Code 是 Anthropic 官方发布的 AI 编程助手 CLI 工具,通过 npm 全局安装。

1

全局安装 Claude Code CLI

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

验证安装

bash
claude --version
# Claude Code x.x.x

如遇到权限问题,可在命令前加 sudo,或配置 npm 全局目录到用户目录下。

3

运行健康检查

bash
claude doctor

此命令会检测环境配置是否正常,包括 API 连接状态。

提示
若安装过程中遭遇网络问题,可临时配置 npm 镜像:npm config set registry https://registry.npmmirror.com
注意
需要使用 Claude Code v2.1.68 或以上版本。

配置 AUTH_TOKEN & BASE_URL

配置呆呆兽 Hub 的 API 节点,让 Claude Code 通过加速线路连接 Anthropic 服务。

说明
在进行此步骤前,请确认已在呆呆兽 Hub 平台完成注册并创建了 API Token。如尚未创建,请先阅读「令牌创建 & Token 获取」章节。

方式一:环境变量(推荐)

将以下配置写入 Shell 配置文件(~/.zshrc~/.bashrc):

~/.zshrc
# 呆呆兽 Hub - Claude Code 加速配置
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxx"   # 替换为你的 API Key
export ANTHROPIC_BASE_URL="https://www.ddshub.cc"

保存后,重载配置:

bash
source ~/.zshrc

# 验证配置
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL

方式二:交互式登录

直接运行 claude 命令,CLI 会引导你完成配置:

bash
claude

# 程序会提示输入:
# > Enter your API key: sk-xxx
# > Enter API base URL (optional): https://www.ddshub.cc
注意
请妥善保管你的 API Token,不要将其提交到 Git 仓库或分享给他人。如 Token 泄露,请立即在呆呆兽 Hub 控制台将其吊销。

验证连接

配置完成后,在任意项目目录运行:

bash
claude "你好,请用一句话介绍你自己"

# 预期输出:
# 我是 Claude,Anthropic 开发的 AI 助手。

Windows 安装教程

注意
系统要求:Windows 10(版本 1809 / build 17763)及以上

使用 PowerShell 安装 Node.js

推荐通过 Chocolatey 包管理器安装 Node.js,方便后续版本管理与升级。

1

以管理员身份打开 PowerShell

右键点击「开始」菜单 → 选择「Windows PowerShell(管理员)」或「终端(管理员)」。

2

安装 Chocolatey 并安装 Node.js

powershell
# 下载并安装 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。

1

全局安装 Claude Code CLI

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

验证安装

powershell
claude --version
# Claude Code x.x.x

如遇到权限问题,请以管理员身份重新打开 PowerShell 后再执行。

提示
若 npm 安装速度慢,可临时切换镜像:npm config set registry https://registry.npmmirror.com
注意
需要使用 Claude Code v2.1.68 或以上版本。

配置 AUTH_TOKEN & BASE_URL

Windows 推荐通过系统环境变量或 PowerShell Profile 持久化配置。

说明
在进行此步骤前,请确认已在呆呆兽 Hub 平台完成注册并创建了 API Token。如尚未创建,请先阅读「令牌创建 & Token 获取」章节。

方式一:PowerShell Profile(推荐)

在 PowerShell 中运行以下命令,将配置写入 Profile 文件:

$PROFILE
# 查看 Profile 路径
echo $PROFILE

# 编辑 Profile(若文件不存在会自动创建)
notepad $PROFILE

在打开的文件末尾添加以下内容并保存:

$PROFILE
# 呆呆兽 Hub - Claude Code 加速配置
$env:ANTHROPIC_AUTH_TOKEN = "sk-xxxxxxxxxxxxxxxx"   # 替换为你的 API Key
$env:ANTHROPIC_BASE_URL   = "https://www.ddshub.cc"

重新打开 PowerShell 后配置自动生效,或立即执行:

powershell
. $PROFILE

方式二:系统环境变量(GUI)

适合不常用命令行的用户:

1

打开系统环境变量设置

右键「此电脑」→「属性」→「高级系统设置」→「环境变量」,或直接在搜索栏输入 环境变量

2

新建用户变量

在「用户变量」区域点击「新建」,依次添加:

变量名变量值
ANTHROPIC_AUTH_TOKENsk-xxxxxxxx...
ANTHROPIC_BASE_URLhttps://www.ddshub.cc
3

重启终端并验证

powershell
echo $env:ANTHROPIC_AUTH_TOKEN
echo $env:ANTHROPIC_BASE_URL

验证连接

配置完成后,在任意项目目录运行:

powershell
claude "你好,请用一句话介绍你自己"

# 预期输出:
# 我是 Claude,Anthropic 开发的 AI 助手。
注意
请妥善保管你的 API Token,不要将其提交到 Git 仓库或分享给他人。如 Token 泄露,请立即在呆呆兽 Hub 控制台将其吊销。