注册账号

充值

操作示例：界面、金额及分组费率以 Aixhub 控制台当前显示为准。

订阅说明

添加令牌

操作示例：界面、金额及分组费率以 Aixhub 控制台当前显示为准。

前置条件

Claude Code 需要以下环境，请逐项检查：

安装 Git

Git 是 Claude Code 的必要依赖，用于分析项目历史、执行代码提交等操作。

git -v

安装 Node.js

方式一：官网下载安装包

node -v

方式二：使用 fnm 安装 推荐

fnm (Fast Node Manager) 是一个快速的 Node.js 版本管理器，支持轻松安装和切换多个 Node.js 版本。

fnm install --lts
node -v

安装 Claude Code

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

系统要求

• macOS 10.15 (Catalina) 或更高版本
• Git（macOS 通常已预装，终端运行 git -v 检查）
• Node.js 18+

安装步骤

1. 安装 Node.js

如已安装可跳过此步骤。

方式一：官网下载安装包

访问 Node.js 官网 下载 macOS 安装包，完成安装后在终端运行 node -v 验证。

方式二：使用 fnm 安装 推荐

fnm (Fast Node Manager) 是一个快速的 Node.js 版本管理器，方便切换和管理多个版本。

# 安装 fnm
curl -fsSL https://fnm.vercel.app/install | bash

# 安装最新 LTS 版本
fnm install --lts
node -v

方式三：使用 Homebrew

brew install node

2. 安装 Claude Code

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

补充：如果安装报错 error，使用管理员权限安装

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

再输入开机密码，回车，开始安装

3. 终端输入claude打开

系统要求

• Ubuntu 18.04+、CentOS 7+、Debian 9+ 等主流发行版
• Git 2.23+（运行 git -v 检查）
• Node.js 18+

安装步骤

0. 安装 Git（如未安装）

# Ubuntu / Debian
sudo apt-get update && sudo apt-get install -y git

# CentOS / RHEL
sudo yum install -y git

1. 安装 Node.js

方式一：官网下载安装包

访问 Node.js 官网 下载 Linux 安装包或二进制文件，完成安装后运行 node -v 验证。

方式二：使用 fnm 安装 推荐

fnm (Fast Node Manager) 无需 sudo，不污染系统环境。

# 安装 fnm
curl -fsSL https://fnm.vercel.app/install | bash

# 重新加载 shell 配置
source ~/.bashrc

# 安装最新 LTS 版本
fnm install --lts
node -v

方式三：使用 NodeSource（Ubuntu/Debian）

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

2. 安装 Claude Code

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

3. 终端输入claude打开

Windows 环境配置

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aixhub.shop",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的令牌"
  }
}

macOS 环境配置

Zsh 用户（macOS 默认）：

echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://aixhub.shop"' >> ~/.zshrc
source ~/.zshrc

Bash 用户：

echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"' >> ~/.bash_profile
echo 'export ANTHROPIC_BASE_URL="https://aixhub.shop"' >> ~/.bash_profile
source ~/.bash_profile

Linux 环境配置

echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://aixhub.shop"' >> ~/.bashrc
source ~/.bashrc

功能特点

• 一键切换 API 配置，在多个提供商之间快速切换
• 可视化配置管理，通过图形界面轻松管理
• MCP 服务器管理
• 系统托盘快捷操作

下载安装

访问 CC-Switch 下载页面，Windows 用户推荐下载 .msi 安装包。

方式一：一键导入 CC-Switch

方式二：手动配置 API

安装扩展

启动方式

常用命令

基础命令

会话管理

高级选项

前置条件

• Node.js 18+（安装方式参考 安装教程）
• Git 2.23+

安装

npm install -g @openai/codex

配置

macOS / Linux

export OPENAI_API_KEY="sk-你的令牌"
export OPENAI_BASE_URL="https://aixhub.shop/v1"

Windows (PowerShell)

$env:OPENAI_API_KEY="sk-你的令牌"
$env:OPENAI_BASE_URL="https://aixhub.shop/v1"

配置步骤

安装与启动

准备 Node.js

• 安装 Node.js 20 或更新版本，并确认 node --version 可以正常返回版本号。
• 准备一个已经创建分组的 Aixhub API Key，格式通常为 sk-xxxxxx。

npx @deepseek-ai/dsh --profile web

首次运行会下载依赖并输出本地访问地址；复制终端显示的地址到浏览器。如果希望使用其他端口，可以加上 --port 3080。

配置 Aixhub 模型

常用启动方式

# 启动 Web 界面
npx @deepseek-ai/dsh --profile web

# 不自动打开浏览器
npx @deepseek-ai/dsh --profile web --no-open

# 指定端口
npx @deepseek-ai/dsh --profile web --port 3080

常见问题

• 模型列表为空：检查 Model ID 是否来自当前令牌分组；也可以先手动填写模型 ID 再测试。
• 401 或鉴权失败：重新复制 API Key，确认没有多余空格，并检查令牌状态和余额。
• 连接超时：确认 Base URL 是 https://aixhub.shop/v1，并检查网络是否能访问 Aixhub。
• 工具权限提示：Harness 默认会询问文件和命令权限，按需批准；不要在不信任的目录启用全量权限。

安装与登录

添加 Aixhub 服务商

验证配置

常见问题

• 找不到自定义接口：升级 WorkBuddy 到最新版本，或查看设置中的开发者、模型服务商和 API 入口。
• 提示 404：检查是否使用了 https://aixhub.shop/v1，并确认模型 ID 拼写正确。
• 提示 401：重新复制令牌，确保没有把引号、空格或整段示例文字一起粘贴。
• 回复异常或速度慢：先用短消息测试，确认令牌分组支持所选模型，再减少上下文或切换模型。

前置条件

• Node.js 18+（安装方式参考 安装教程）

安装

npm install -g @google/gemini-cli

配置

macOS / Linux

export GEMINI_API_KEY="sk-你的令牌"
export GEMINI_BASE_URL="https://aixhub.shop"

Windows (PowerShell)

$env:GEMINI_API_KEY="sk-你的令牌"
$env:GEMINI_BASE_URL="https://aixhub.shop"

配置步骤

Windows 安装

irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex

# 方法1：用 pip 安装 uv
pip install uv

# 方法2：如果没有 pip，用 winget 安装
winget install astral-sh.uv

# 方法3：如果以上都不行，用 GitHub 镜像下载
Invoke-WebRequest -Uri "https://ghfast.top/https://github.com/astral-sh/uv/releases/latest/download/uv-x86_64-pc-windows-msvc.zip" -OutFile "$env:TEMP\uv.zip"
Expand-Archive "$env:TEMP\uv.zip" -DestinationPath "$env:LOCALAPPDATA\uv" -Force
$env:Path = "$env:LOCALAPPDATA\uv;" + $env:Path
uv --version

macOS 和 Linux 安装

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

等待安装完成

配置步骤

无法连接到服务

如果出现连接错误：

解决方案（Windows）

powershell -Command "$f='%USERPROFILE%\.claude.json';$j=Get-Content $f|ConvertFrom-Json;$j|Add-Member -NotePropertyName 'hasCompletedOnboarding' -NotePropertyValue $true -Force;$j|ConvertTo-Json|Set-Content $f"

令牌无效或余额不足

• 检查令牌是否正确复制（包含 sk- 前缀）
• 登录平台检查账户余额
• 确认令牌分组是否支持你使用的模型

响应速度慢

• 检查网络连接是否稳定
• 尝试切换到速度更快的模型（如 Gemini Flash）
• 减少单次请求的上下文长度

推荐配置

建议在 Claude Code 的配置文件中添加以下环境变量，以获得更稳定的使用体验：

打开配置文件 settings.json（位于 ~/.claude/settings.json，Windows 路径为 %userprofile%\.claude\settings.json），在 env 中添加：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aixhub.shop",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的令牌",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

模型示例

以下为当前官方模型名称和使用场景示例；实际可用型号以 Aixhub 控制台和 API 返回的模型列表为准。复制模型 ID 时请以控制台显示值为准，不要手动猜测名称。

分组与计费

登录 Aixhub 控制台 查看账号可用的分组、模型和实时价格。创建 API 密钥时选择对应分组，模型名称、额度和计费规则以控制台显示为准。

什么是缓存？

缓存是一种优化机制：

• 首次请求：发送内容时会创建缓存（有额外费用）
• 命中缓存：后续相似请求从缓存读取，价格极低
• 缓存时长：5 分钟适合频繁切换，1 小时适合专注同一项目

什么是上下文？

上下文是模型能处理的内容长度：

• 上下文长度取决于具体模型和分组，请查看控制台说明。
• 特价分组：上下文可能更短
• 1M 上下文：适合处理超长内容