Whitelabel Claude

Claude Code 一键白标 & 多 API 接入

触发场景

• "白标 claude code"、"换皮"、"rebrand"、"/whitelabel"
• "帮我接 DeepSeek / Kimi / OpenRouter / 硅基流动"
• "打包一个可以分发的版本"

执行流程

Step 0：收集配置

常用 API 端点：

Step 1：找到 cli.js

cli.js 是 Claude Code 的核心文件，所有 patch 都在这一个文件上做。按以下优先级查找，命中第一个就停：

情况 A：用户已安装 Claude Code（最常见）

大部分人通过 npm、winget、brew 装过 Claude Code，cli.js 已经在系统里了。

# npm 全局安装路径
node -e "try{console.log(require.resolve('@anthropic-ai/claude-code/cli.js'))}catch{}"

# 或者通过 which/where 找到 claude 命令，再找同目录的 cli.js
which claude 2>/dev/null || where claude 2>/dev/null
# claude 命令通常是个 shim，实际 cli.js 在 npm 全局 node_modules 里

找到后复制到工作目录：

mkdir -p {brand}-dist
cp <找到的cli.js> {brand}-dist/cli.js
cp <同目录的package.json> {brand}-dist/package.json
cp -r <同目录的vendor/> {brand}-dist/vendor/

情况 B：用户有 claude-code-sourcemap-main.zip

这个 zip 里有现成的 package/cli.js（v2.1.88），直接提取：

mkdir -p {brand}-dist
unzip -j claude-code-sourcemap-main.zip \
  "claude-code-sourcemap-main/package/cli.js" \
  "claude-code-sourcemap-main/package/package.json" \
  -d {brand}-dist/
# vendor 按当前平台提取（如 Windows x64）：
unzip claude-code-sourcemap-main.zip \
  "claude-code-sourcemap-main/package/vendor/*" \
  -d tmp-extract/
cp -r tmp-extract/claude-code-sourcemap-main/package/vendor/ {brand}-dist/vendor/
rm -rf tmp-extract/

注：另一个文件 claudecode.zip 是还原出来的 TypeScript 源码，只用于阅读理解结构，本流程不需要它。

情况 C：用户什么都没有

引导安装 Claude Code：

# 方式一：npm（需要 Node.js）
npm install -g @anthropic-ai/claude-code

# 方式二：Windows winget
winget install Anthropic.ClaudeCode

# 方式三：macOS brew
brew install claude-code

安装完成后按情况 A 定位 cli.js。

Step 2：patch

读取本 skill 目录下的 scripts/patch.template.js，将这些占位符替换为实际值：

__BRAND_NAME__   → 品牌名（不改品牌就填 "Claude Code"）
__API_BASE_URL__ → API 端点（如 "https://api.deepseek.com"）或 ""
__ENABLE_I18N__  → true 或 false
__BRAND_R__      → 品牌色 R（默认 215）
__BRAND_G__      → 品牌色 G（默认 119）
__BRAND_B__      → 品牌色 B（默认 87）
__LOGO_STYLE__   → default | look-left | look-right | arms-up | custom
__CUSTOM_LOGO__  → 自定义 logo 对象；非 custom 时填 null

写入 {brand}-dist/patch.js，然后执行：

# 先备份
cp {brand}-dist/cli.js {brand}-dist/cli.js.bak
# 执行 patch
node {brand}-dist/patch.js {brand}-dist/cli.js

原理（Protect → Replace → Restore）：

1. 先把 50+ 个协议层字符串换成占位符（User-Agent claude-cli/、npm 包名、所有环境变量名、SDK 类名）
2. 做品牌替换（占位符保护下不会误伤协议层）
3. 还原占位符

不保护直接替换，会把 HTTP User-Agent 改掉，Kimi 等服务端校验客户端标识会 403。

视觉定制也在这一步做：

• 欢迎框边框色和机器人身体色，官方默认是 rgb(215,119,87) / #D77757
• skill 会把这个颜色改成你提供的 品牌色
• 欢迎页小机器人支持这些内置姿态 / 图标：default、look-left、look-right、arms-up、bot-mini、pixel-cat、star
• 如果用户提供了自定义 logo，就填 __LOGO_STYLE__ = custom，并把 __CUSTOM_LOGO__ 写成：

{
  r1L: ' 左上 ',
  r1E: '中间上半',
  r1R: ' 右上 ',
  r2L: '左下',
  r2R: '右下',
  feet: '底部一行'
}

比如官方默认 logo 实际就是：

{
  r1L: ' ▐',
  r1E: '▛███▜',
  r1R: '▌',
  r2L: '▝▜',
  r2R: '▛▘',
  feet: ' ▗   ▖ '
}

如果用户只是想改颜色，不想改图标，就保留 default。

Step 3：生成启动脚本

读取 templates/launcher.bat（Windows）或 templates/launcher.sh（macOS/Linux），替换占位符后写入 {brand}-dist/：

__BRAND__        → 品牌名
__BRAND_LOWER__  → 小写
__API_KEY__      → API Key
__API_BASE_URL__ → API 端点

写入 .bat 文件时必须注意：

1. 纯 ASCII 注释：bat 里的 rem 注释和 echo 输出只用英文，不写中文。Windows cmd 默认编码是 GBK，中文 Unicode 字符（包括 ── 这种）会导致 不是内部或外部命令 报错
2. CRLF 行尾：bat 必须是 \r\n 行尾。如果在 macOS/Linux/Git Bash 环境下生成，写入后执行 sed -i 's/$/\r/' {brand}.bat 或用 Node.js 写入时确保 \r\n
3. chcp 65001：脚本开头加 chcp 65001 >nul 2>&1，让 node 进程的 stdout 能正确显示 UTF-8（cli.js 输出中文需要这个）

启动脚本里两个关键设计：

• CLAUDE_CONFIG_DIR=~/.{brand_lower} — 隔离配置目录，避免全局 OAuth token 抢占
• ANTHROPIC_AUTH_TOKEN（不是 API_KEY）— 认证优先级最高，确保走第三方 API

Step 4：验证

node {brand}-dist/cli.js --version
# 期望: 2.1.xx (BrandName)  或  2.1.xx（不改品牌时无后缀）

# User-Agent 必须在（否则第三方 API 会 403）
node -e "const c=require('fs').readFileSync('{brand}-dist/cli.js','utf8'); console.log(c.includes('claude-cli/') ? 'UA ✓' : 'UA 丢失！')"

Step 5（可选）：打包分发

{brand}-dist/
├── cli.js            ← 已 patch
├── package.json
├── vendor/           ← 当前平台的 native addon
├── {brand}.bat       ← Windows 启动脚本（含 API key）
├── {brand}.sh        ← macOS/Linux 启动脚本
└── patch.js          ← 留着，方便以后重新 patch

打包：

cd {brand}-dist && zip -r ../{brand}-release.zip . && cd ..

接收方要求：有 Node.js 即可（无需安装 Claude Code）。如果目标用户连 Node.js 都没有，可以从 nodejs.org/dist/ 下载对应平台的便携版 node.exe，放进分发包根目录，启动脚本里优先使用它。

完成后告知用户

完成 ✓

启动:     ./{brand}.bat（Windows）/ bash {brand}.sh（macOS/Linux）
配置目录: ~/.{brand_lower}（与全局 Claude Code 完全隔离）

两个实例可同时运行：
  ./{brand}.bat  → 第三方 API
  claude         → 官方 Anthropic（如有）

常见问题