Piggyback 快速上手

按下面的步骤创建 API 密钥，再把它接入你用的工具。

接口地址统一是 https://piggyback.lewiswang.com.au。页面右上角可以切换 macOS / Linux 和 Windows 的命令。

1. 创建 API 密钥

每种接入方式都要先有一个 API 密钥。

打开注册页面，用邮箱注册账号。新账号自带 10 美元余额。
打开邮箱里的验证邮件，完成验证后登录控制台。
在左侧菜单点「API 密钥」，再点「创建密钥」。
名称随便填，分组选「默认分组」。如果管理员给你开了专属分组，就选那个分组。
保存后，在密钥列表里复制这个密钥。密钥以 sk- 开头。

密钥等于你的余额。不要发给别人，也不要提交到代码仓库。

2. 接入 Claude Code

这种方式直接修改 Claude Code 的配置文件。如果你想用图形界面管理配置，看第 3 节。

安装 Claude Code。

打开终端，运行：

curl -fsSL https://claude.ai/install.sh | bash

在 PowerShell 里运行：

irm https://claude.ai/install.ps1 | iex

新开一个终端窗口，确认安装成功。下面的命令会输出一个版本号：
```
claude --version
```
版本号要至少是 2.1.296，才能用 claude-opus-5-5 和 claude-sonnet-5-5。版本更低时，运行下面的命令升级：
```
claude update
```
打开 Claude Code 的设置文件。如果文件不存在，就新建一个：
```
~/.claude/settings.json
```
```
%USERPROFILE%\.claude\settings.json
```

写入下面的内容，把 sk-你的密钥 换成第 1 节复制的密钥：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://piggyback.lewiswang.com.au",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

如果文件里已经有别的设置，只把这三行加进 "env" 里，其他内容保留。

新开一个终端，进入你的项目目录，运行：
```
claude
```
发一句「你好」，收到回复就说明接入成功。

控制台里也能直接生成这段配置：在「API 密钥」页点密钥右侧的「使用密钥」，选「Claude Code」选项卡。生成的内容已经填好了你的密钥。

3. 用 CC Switch 接入

CC Switch 是一个桌面应用，用来管理 Claude Code 的配置。用它导入密钥，不用手动编辑配置文件。

按第 2 节的第 1 步和第 2 步安装 Claude Code。
安装 CC Switch。
macOS 在终端里运行下面的命令。Linux 从 GitHub Releases 下载 .deb、.rpm 或 .AppImage 安装包。
```
brew install --cask cc-switch
```
从 GitHub Releases 下载 CC-Switch-版本号-Windows.msi，双击安装。系统要求 Windows 10 或更新版本。
打开 CC Switch 一次，然后可以关掉窗口。第一次打开时，系统会登记 CC Switch，之后浏览器才能把导入请求交给它。
在控制台的「API 密钥」页，点密钥右侧的「导入到 CCS」。
在「选择客户端」窗口里选「Claude Code」。
浏览器会问是否打开 CC Switch，选允许。然后在 CC Switch 里确认导入。
在 CC Switch 左侧选 Claude Code，找到刚导入的供应商，点「启用」。
新开一个终端，运行：
```
claude
```
发一句「你好」，收到回复就说明接入成功。Claude Code 切换供应商以后，不需要重启。

点了「导入到 CCS」却没有反应，就是 CC Switch 还没装好，或者还没打开过。这时也可以手动添加：在 CC Switch 里选 Claude Code，点右上角的「+」，选自定义配置。API Key 填你的密钥，请求地址填 https://piggyback.lewiswang.com.au。

4. 接入 Codex

Codex 是 OpenAI 的命令行编程工具。用 Piggyback 的密钥时，Codex 发出的请求会转给 Claude 模型处理，默认模型是 claude-sonnet-4-6。

安装 Codex：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

在 PowerShell 里运行：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

在控制台的「API 密钥」页，点密钥右侧的「使用密钥」，选「Codex CLI」选项卡，再选你的操作系统。
页面会给出两段内容。第一段设置环境变量 SUB2API_API_KEY，值就是你的密钥。要让它在每次打开终端时都生效，这样设置：
把下面这行加到 ~/.zshrc 的末尾（如果你用 bash，就加到 ~/.bashrc），保存后新开终端：
```
export SUB2API_API_KEY="sk-你的密钥"
```
在 PowerShell 里运行下面的命令，然后关掉并重新打开 PowerShell：
```
setx SUB2API_API_KEY "sk-你的密钥"
```
第二段是 Codex 的配置文件。把它完整复制，保存到：
```
~/.codex/config.toml
```
```
%USERPROFILE%\.codex\config.toml
```
如果这个文件已经存在，先复制一份备份，再整体替换。
新开一个终端，进入你的项目目录，运行：
```
codex
```
发一句「你好」，收到回复就说明接入成功。

Codex 的配置包含模型清单地址和推理设置，这些内容由控制台按当前的模型列表生成。所以要以「使用密钥」里的内容为准，不要自己手写。

5. 接入 OpenCode

OpenCode 是一个开源的命令行编程工具。接入后，它通过 Piggyback 使用 Claude 模型。

安装 OpenCode。
打开终端，运行下面任意一条命令。只装一种：两种都用 opencode 命令，同时装会冲突。
```
curl -fsSL https://opencode.ai/install | bash
```
```
brew install opencode
```
官方推荐在 WSL 里安装，在 WSL 终端里运行：
```
curl -fsSL https://opencode.ai/install | bash
```
不用 WSL 的话，也可以在 PowerShell 里用 npm 安装：
```
npm install -g opencode-ai
```
新开一个终端，确认安装成功。下面的命令会输出一个版本号：
```
opencode --version
```
在控制台的「API 密钥」页，点密钥右侧的「使用密钥」，选「OpenCode」选项卡，复制里面的配置。配置里已经填好了你的密钥和接口地址。
新建配置目录，再用编辑器打开配置文件。文件不存在时会自动新建：
```
mkdir -p ~/.config/opencode
open -e ~/.config/opencode/opencode.json
```
把复制的配置粘贴进去，保存。「文本编辑」有时会把直引号 " 换成弯引号，配置就会失效。保存前确认引号都是直的。
用 WSL 时，把配置保存到 WSL 里的 ~/.config/opencode/opencode.json。用原生 Windows 时，把配置保存为项目根目录下的 opencode.json。
想指定默认模型，就在配置最外层加一行（换成 Opus 就写 anthropic/claude-opus-5-5）：
```
"model": "anthropic/claude-sonnet-5-5",
```
进入你的项目目录，运行：
```
opencode
```
发一句「你好」，收到回复就说明接入成功。

配置里的接口地址以 /v1 结尾，这和 Claude Code 不同，不要删掉。如果你在 OpenCode 里用 /connect 登录过别的 Anthropic 账号，这份配置里的密钥会替代那个登录。

6. 检查用量和余额

在控制台左侧菜单点「使用记录」，可以看到每次请求的时间、模型和费用。
余额显示在页面右上角。余额不足时，请求会被拒绝。

请求报 401 错误，说明密钥填错了，或者密钥已被删除。重新复制一次密钥再试。

请求报 400 错误，提示 requires adaptive thinking，说明 Claude Code 版本太旧。运行 claude update 升级到 2.1.296 或更新的版本，再新开一个终端。