Claude Code 配置

本篇节分别介绍 macOS 与 Windows 环境下 Claude Code CLI 的安装与接入克比特 Hub 分组
节点的配置流程。

Mac 安装教程

| 使用 brew 安装 Node.js

Claude Code 需要 Node.js 运行时。推荐通过 Homebrew 管理 Node.js 版本，保持环境清洁。

1 安装 Homebrew

# 下载并安装 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2 安装 Node.js

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

# 查看 Node.js 版本
node -v

# 查看 NPM 版本
npm -v

| 安装 Claude Code

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

1 全局安装 Claude Code CLI

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

2 验证安装

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

如显示版本号，可在命令行输入 claude 启动 npm 全局安装的工具了。

3 运行健康检查

claude doctor

此命令会检验网络环境是否正常，检查 API 连接状态。

| 配置 AUTH_TOKEN & BASE_URL

配置本项目 Hub 的 API 节点，让 Claude Code 通过我们的中转节点调用 Anthropic 服务，以实现快速调用。

方式一：直接在终端设置

编辑下方变量为 Shell 配置文件（~/.zshrc 或 ~/.bashrc）：

# 设置 Hub → Claude Code 连接配置                    # 替换为你的 API Key
export ANTHROPIC_AUTH_TOKEN="sk-cb-xxxxxxxxxxxxx"
export ANTHROPIC_BASE_URL="https://api.claudebit.com"

写好后，重新加载配置：

source ~/.zshrc

方式二：使用环境变量

直接在终端执行以下两个命令。CLI 会立马获取环境变量配置：

claude config set --global anthropicApiKey "sk-cb-xxxxxxxxxxxxx"
claude config set --global apiBaseUrl "https://api.claudebit.com"

验证配置：

claude

# 输入：
claude "你好，随便一句话验证运行"

# 预期输出：
# 来自 Claude Anthropic 的 AI 回答。

Windows 安装教程

| 使用 PowerShell 安装 Node.js

推荐使用 Chocolatey 包管理器安装 Node.js，方便后续版本升级和包管理。

1 以管理员身份打开 PowerShell

按下快捷键 Win + X，选择「Windows PowerShell（管理员）」或「终端（管理员）」。

2 安装 Chocolatey 并安装 Node.js

# 下载并安装 Chocolatey
powershell -c "irm https://community.chocolatey.org/install.ps1|iex"

# 使用 Chocolatey 安装 Node.js
choco install nodejs --version="24.0.0"

# 查看 Node.js 版本
node -v

# 查看 NPM 版本
npm -v

| 安装 Claude Code

Node.js 安装就绪后，通过 npm 全局安装 Claude Code CLI。

1 全局安装 Claude Code CLI

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

2 验证安装

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

| 配置 AUTH_TOKEN & BASE_URL

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

方式一：POWERSHELL PROFILE（推荐）

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

# 设置 Hub → Claude Code 连接配置                    # 替换为你的 API Key
$env:ANTHROPIC_AUTH_TOKEN="sk-cb-xxxxxxxxxxxxx"
$env:ANTHROPIC_BASE_URL="https://api.claudebit.com"

方式二：使用 claude config 命令

claude config set --global anthropicApiKey "sk-cb-xxxxxxxxxxxxx"
claude config set --global apiBaseUrl "https://api.claudebit.com"

Claude Code for VSCode

如果您更习惯在 VSCode 中使用 Claude Code，可以安装官方 VSCode 扩展：

# 在 VSCode 中搜索并安装扩展：
Claude Code

# 或者通过命令行安装：
code --install-extension anthropic.claude-code

安装完成后，在 VSCode 设置中配置 API Key 和 Base URL，方法与终端配置相同。扩展会自动读取环境变量中的配置。

全量模型

Claude Bit 目前支持以下 Claude 模型系列，所有模型均可通过统一的 API 接口调用：

Codes & 配置管理

在控制台的「API 密钥」页面创建和管理您的密钥。每个密钥创建后仅显示一次完整内容，请务必保存。

sk-cb-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# 前缀: sk-cb-
# 长度: 约 43 个字符
# 创建后仅显示一次，请妥善保管

令牌额度 & Token 管理

Claude Bit 采用按量计费模式，您的每次 API 调用都会消耗对应的 Token 额度：

• 充值后余额永久有效，不设过期时间
• 支持支付宝、微信支付（截图后台审核，5 分钟内到账）
• 充值比例 1 RMB = 1 USD
• 每次调用根据输入/输出 Token 数计费，可在「使用记录」页面查看明细
• 支持兑换码充值，在「兑换」页面使用