系统要求

• 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://shuhong-tk.cn",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的API密钥"
  }
}

macOS 环境配置

Zsh 用户（macOS 默认）：

echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的API密钥"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://shuhong-tk.cn"' >> ~/.zshrc
source ~/.zshrc

Bash 用户：

echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的API密钥"' >> ~/.bash_profile
echo 'export ANTHROPIC_BASE_URL="https://shuhong-tk.cn"' >> ~/.bash_profile
source ~/.bash_profile

Linux 环境配置

echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的API密钥"' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://shuhong-tk.cn"' >> ~/.bashrc
source ~/.bashrc

功能特点

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

下载安装

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

配置 API

安装扩展

启动方式

常用命令

基础命令

会话管理

高级选项

前置条件

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

安装

npm install -g @openai/codex

codex --version

cd 你的项目目录
codex

登录或配置

方式一：使用 ChatGPT 账号登录（官方推荐）

codex --login

执行后按提示在浏览器中完成登录即可。官方说明这个流程会自动在本地保存凭据，无需手动复制 API Key。

方式二：使用 API Key 接入自定义 OpenAI 兼容接口

macOS / Linux

export OPENAI_API_KEY="sk-你的API密钥"
export OPENAI_BASE_URL="https://shuhong-tk.cn/v1"

Windows (PowerShell)

$env:OPENAI_API_KEY="sk-你的API密钥"
$env:OPENAI_BASE_URL="https://shuhong-tk.cn/v1"

常用启动方式

codex
codex --auto-edit
codex --full-auto

前置条件

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

安装

npm install -g @google/gemini-cli

配置

macOS / Linux

export GEMINI_API_KEY="sk-你的API密钥"
export GEMINI_BASE_URL="https://shuhong-tk.cn"

Windows (PowerShell)

$env:GEMINI_API_KEY="sk-你的API密钥"
$env:GEMINI_BASE_URL="https://shuhong-tk.cn"

配置步骤

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"

API密钥无效或余额不足

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

响应速度慢

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

推荐配置

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

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

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://shuhong-tk.cn",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的API密钥",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

模型分组总览

不同分组对应不同的模型供应商。创建 API Key 时需要选择对应分组才能调用该分组下的模型。

热门模型推荐

计费说明

采用按量计费模式，根据实际使用的 token 数量扣费。具体各模型价格请登录 shuhong-tk.cn/pricing 查看实时价格。

什么是缓存？

缓存命中是一种成本优化机制。当模型检测到输入内容与之前的请求高度相似时，可直接复用计算结果：

• 首次请求：按正常输入价格计费，同时创建缓存
• 命中缓存：后续相似请求仅按极低的缓存价格计费
• 缓存过期：默认 5-10 分钟后失效

什么是上下文？

上下文窗口决定模型在一次对话中能"记住"多少内容：

• 标准模型：128K - 200K tokens（适合日常编程、对话）
• 长上下文模型：500K - 1M tokens（适合代码库分析、长文档处理）

省钱建议

1. 选对模型：日常开发用 DeepSeek-V4 或 Gemini Flash 等高性价比模型；复杂任务再用 Claude Opus 或 GPT-5
2. 固定提示词：System Prompt 保持稳定以命中缓存
3. 控制上下文：用完的对话及时清理，避免 token 浪费
4. 关注价格：定期查看 价格页面，上游调价会同步更新

桌面端使用工具

除了通过 API 调用，我们提供了两个 Windows 桌面端工具，下载解压后直接运行即可使用，无需配置 API 接口。

Seedance 视频生成桌面端

专用的视频生成桌面工具，支持文生视频、图生视频等多种模式。

1

下载工具

下载 Seedance 桌面端压缩包并解压到任意目录。

2

运行程序

进入解压后的 数泓token-seedance-win 文件夹，双击 数泓token.exe 启动程序。

3

开始使用

启动后即可在界面中输入提示词、选择模型和参数，点击生成视频。无需额外配置 API 密钥。

下载 Seedance 桌面端

点击下载按钮，跳转至控制台完成登录后至公告栏内或常见问题解答栏内点击下载

通用模型桌面端

集合多种 AI 模型的桌面工具，支持对话、编程、图像生成等功能，一站式 AI 工作台。

1

下载工具

下载通用模型桌面端压缩包并解压到任意目录。

2

运行程序

进入解压后的 数泓token-通用模型-v1.2.14-win 文件夹，双击 数泓token通用模型.exe 启动程序。

3

开始使用

启动后选择需要的模型即可开始对话、编程或图像生成。无需额外配置 API 密钥。

下载通用模型桌面端

点击下载按钮，跳转至控制台完成登录后至公告栏内或常见问题解答栏内点击下载

移动云 Seedance 模型

curl http://shuhong-tk.cn/v1/video/generations \
  -H "Authorization: Bearer 你的中转站Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "AICC-doubao-seedance-2.0",
    "prompt": "一只白色杯子放在木桌上，阳光从左侧照进来，镜头慢慢推近。",
    "seconds": "4",
    "metadata": {
      "generate_audio": false,
      "ratio": "16:9",
      "watermark": false
    }
  }'

已接入模型

接口地址

请求头：

Authorization: Bearer API密钥
Content-Type: application/json

模型选择建议

• 图生视频：优先使用 seedance-2.0，通过 images 字段传图片 URL
• 快速文生视频：使用 seedance-2.0-fast，适合快速预览和批量测试
• 高清文生视频：使用 seedance-2.0-1080，等待时间更长
• 视频参考输入：使用 seedance-2.0-fast-vision / seedance-2.0-vision / seedance-2.0-vision-1080，需通过 metadata.content 传入公开视频 URL

"metadata": {
  "content": [
    {
      "type": "video_url",
      "video_url": {
        "url": "https://example.com/demo.mp4"
      }
    }
  ]
}

重要注意事项

1. 素材 URL 必须公网可访问：图片或视频地址必须是公网 HTTPS URL，不能是本地文件、内网地址或需要登录的链接。
2. 必须填写 prompt：prompt 不能为空，否则会报错。
3. 任务是异步的：创建任务成功后不会马上返回视频，而是返回 task_id。请每隔 10-20 秒查询一次任务状态，不要高频轮询。
4. 结果链接可能有有效期：生成成功后返回的视频 URL 通常是临时下载链接，请及时下载或转存。

任务状态说明

调用示例

示例 1：文生视频

适用于 seedance-2.0 / seedance-2.0-fast / seedance-2.0-1080

curl https://shuhong-tk.cn/v1/video/generations \
  -H "Authorization: Bearer 你的API密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-fast",
    "prompt": "一只小狐狸在草地上抬头看镜头，镜头缓慢推进，画面自然柔和。",
    "seconds": "5",
    "metadata": {
      "generate_audio": false,
      "ratio": "16:9",
      "watermark": false
    }
  }'

示例 2：高清文生视频

curl https://shuhong-tk.cn/v1/video/generations \
  -H "Authorization: Bearer API密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-1080",
    "prompt": "清晨的海边，一位女孩沿着沙滩慢慢行走，阳光洒在海面上，镜头平稳跟拍，电影感画面。",
    "seconds": "5",
    "metadata": {
      "generate_audio": false,
      "ratio": "16:9",
      "watermark": false
    }
  }'

示例 3：图生视频

建议使用 seedance-2.0：

curl https://shuhong-tk.cn/v1/video/generations \
  -H "Authorization: Bearer 你的API密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "prompt": "女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出。",
    "images": [
      "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"
    ],
    "seconds": "5",
    "metadata": {
      "generate_audio": true,
      "ratio": "adaptive",
      "watermark": false
    }
  }'

示例 4：视频参考生成

适用于 seedance-2.0-fast-vision / seedance-2.0-vision / seedance-2.0-vision-1080：

curl https://shuhong-tk.cn/v1/video/generations \
  -H "Authorization: Bearer 你的API密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-vision",
    "prompt": "让视频里的花朵轻轻摇动，镜头缓慢推进，画面自然。",
    "seconds": "5",
    "metadata": {
      "generate_audio": false,
      "ratio": "16:9",
      "watermark": false,
      "content": [
        {
          "type": "video_url",
          "video_url": {
            "url": "https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4"
          }
        }
      ]
    }
  }'

示例 5：查询任务结果

创建任务后会返回：

{
  "id": "task_xxxxx",
  "task_id": "task_xxxxx",
  "status": "queued"
}

查询任务：

curl https://shuhong-tk.cn/v1/video/generations/task_xxxxx \
  -H "Authorization: Bearer 你的API密钥"

生成成功后返回中会包含视频地址：

{
  "data": {
    "status": "SUCCESS",
    "progress": "100%",
    "result_url": "https://..."
  }
}

接入步骤

代码示例

cURL

curl https://shuhong-tk.cn/v1/images/generations   -H "Authorization: Bearer sk-你的Token"   -H "Content-Type: application/json"   -d '{
    "model": "Qwen-Image",
    "prompt": "一只橘猫坐在沙发上",
    "size": "3840x2160"
  }'

Python

from openai import OpenAI
import base64

client = OpenAI(
    api_key="sk-你的Token",
    base_url="https://shuhong-tk.cn/v1",
)
res = client.images.generate(
    model="Qwen-Image",
    prompt="一只橘猫坐在沙发上",
    size="3840x2160",
)
with open("cat.png", "wb") as f:
    f.write(base64.b64decode(res.data[0].b64_json))

Node.js

import OpenAI from "openai";
import fs from "fs";

const client = new OpenAI({
  apiKey: "sk-你的Token",
  baseURL: "https://shuhong-tk.cn/v1",
});
const res = await client.images.generate({
  model: "Qwen-Image",
  prompt: "一只橘猫坐在沙发上",
  size: "3840x2160",
});
fs.writeFileSync("cat.png", Buffer.from(res.data[0].b64_json, "base64"));

常见错误