Token101 文档一键接入
一条命令完成 Token101 接入 Claude Code — 无需手动配置。
最快的接入方式
如果你只想快速跑起来，用我们的一键脚本就行，可以在 3 分钟内快速接入 Claude Code。它会自动处理：写入配置文件、设置模型映射、清理旧配置。
第一次用 Token101？ 从这里开始。这个脚本可以替代 平台配置 和 AI 编程助手 接入 里的手动步骤。
想了解脚本每一步的详细说明和截图？前往 自动配置工具使用说明 查看完整图文教程。
前提条件
运行脚本前只需要：
- 一个 Token101 账号 — 在 token.ppthub.shop 注册，并激活API
- 一个 API Key — 在 设置 → API 密钥 创建
- 格式：
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx（以sk-开头，至少 32 位）
- 格式：
- 已安装 Node.js，并已安装 Claude Code
- 一个终端（macOS 或 Linux）
Windows 用户： 此 bash 脚本仅支持 macOS / Linux。Windows 用户请使用下方的 PowerShell 脚本，或通过 WSL 运行 bash 脚本。
就这些。脚本会自动处理其余所有事情。
运行脚本（适合macOS以及Linux）
下载并运行（推荐）
bash <(curl -fsSL https://token.ppthub.shop/scripts/setup-token101-claude-code-mac-hub.sh)或先下载到本地，再执行：
curl -fsSL -o setup-token101-claude-code-mac-hub.sh https://token.ppthub.shop/scripts/setup-token101-claude-code-mac-hub.sh
bash setup-token101-claude-code-mac-hub.sh脚本会引导你完成：
- 输入 API Key（自动校验格式）
- 选择模型映射（推荐或自定义）
- 选择安装后的动作（什么权限运行）
- 写入配置文件
- 指导使用（常见启动使用方法）
Windows（PowerShell）
Windows 用户可以使用 PowerShell 版本的一键脚本：
powershell -ExecutionPolicy Bypass -Command "& { Invoke-WebRequest -Uri 'https://token.ppthub.shop/scripts/setup-token101-claude-code-win-hub.ps1' -OutFile 'setup-token101-claude-code-win-hub.ps1'; ./setup-token101-claude-code-win-hub.ps1 }"或先下载到本地，再执行：
Invoke-WebRequest -Uri 'https://token.ppthub.shop/scripts/setup-token101-claude-code-win-hub.ps1' -OutFile 'setup-token101-claude-code-win-hub.ps1'
powershell -ExecutionPolicy Bypass -File ./setup-token101-claude-code-win-hub.ps1交互模式（推荐） — 脚本会逐步询问模型映射、启动方式等选项：
powershell -ExecutionPolicy Bypass -File ./setup-token101-claude-code-win-hub.ps1非交互模式 — 传入 API Key 参数，全程使用推荐默认值，无需手动选择：
powershell -ExecutionPolicy Bypass -File ./setup-token101-claude-code-win-hub.ps1 -ApiKey sk-你的密钥如果遇到"脚本执行被禁用"错误，请先执行：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
脚本做了什么
运行脚本后，它会自动：
- 校验 API Key — 检查
sk-前缀和最小长度 - 备份现有配置 — 如果
~/.claude/settings.json已存在，创建带时间戳的.bak备份 - 写入
~/.claude/settings.json— 设置 Base URL、API Key、模型映射，并禁用 1M context - 检测 shell 类型 — 识别 zsh 或 bash 及对应的配置文件
- 写入 shell 环境变量 — 在
~/.zshrc（或~/.bash_profile）和~/.zprofile中添加托管配置块 - 应用到当前 shell — 立即导出变量，无需重启即可使用
写入的文件 (macOS / Linux)
| 文件 | 用途 |
|---|---|
~/.claude/settings.json | Base URL + API Key + 模型映射 + 可用模型列表 |
~/.zshrc 或 ~/.bash_profile | Shell 环境变量（托管配置块） |
~/.zprofile（仅 zsh） | 登录 Shell 环境变量 |
写入的文件 (Windows)
| 文件 | 用途 |
|---|---|
%USERPROFILE%\.claude\settings.json | Base URL + API Key + 模型映射 + 可用模型列表 |
| Windows 用户环境变量 | 通过注册表持久化（重启后仍然生效） |
脚本使用幂等托管配置块 — 以 # Token101 × Claude Code 配置 / # Token101 × Claude Code 配置结束 标记。重复运行脚本会替换已有配置块，不会重复追加。
安装后动作
脚本会询问配置写入完成后要做什么：
| 选项 | 说明 |
|---|---|
| 1 — 仅写入配置（推荐） | 只写入配置文件，最安全 |
| 2 — 标准启动 | 显示 claude 启动指引 |
| 3 — 高权限启动 | 显示 claude --dangerously-skip-permissions 启动指引 |
脚本不会自动替你启动 AI 编程助手 — 只会根据你的选择给出推荐下一步。
为什么建议新开终端
脚本可以把配置写入 shell 配置文件，但不能真正自动刷新你当前已经打开的父 shell 会话。更稳妥的方式：
- 退出当前 AI 编程助手 / 终端会话
- 打开一个新的终端窗口
- 再启动 AI 编程助手
如果你明确知道自己在做什么，也可以在当前 shell 中手动执行：
source ~/.zshrc
source ~/.zprofile
env | egrep '^(ANTHROPIC|CLAUDE_CODE)_'下一步：开始使用 Claude Code
脚本运行完成后，打开一个新的终端窗口，执行以下命令即可启动 Claude Code：
claudeClaude Code 将自动通过 Token101 路由请求，你可以直接开始编码。
如需验证配置是否正常，可以参考 验证与首次使用。
模型映射
脚本会配置 AI 编程助手 各槽位对应的 Token101 模型。你可以选择两种方式：
推荐映射（默认）
| 槽位 | 模型 ID | 用途 |
|---|---|---|
sonnet | claude-sonnet-4-5-20250929 | 日常主力 |
opus | claude-opus-4-6 | 旗舰推理 |
haiku | claude-haiku-4-5-20251001 | 轻量后台 |
subagent | （默认为空，按需填写） | 按需使用 |
| 自定义 | gpt-5.3-codex | 代码专项备选 |
推荐映射（GPT 系列）
全部使用 Token101 支持的 GPT 模型，适合以代码任务为主或希望体验最新 GPT 模型的用户。
| 槽位 | 模型 ID | 用途 |
|---|---|---|
sonnet | gpt-5.3-codex | 日常主力（代码增强版） |
opus | gpt-5.4 | 复杂推理与高质量输出 |
haiku | gpt-5.2 | 轻量后台任务 |
subagent | gpt-5.2 | 并发子任务（轻量省积分） |
| 自定义 | gpt-5.3-codex | 代码生成备选 |
可在 Token101 模型列表 查看所有支持的 GPT 模型 ID。
推荐映射（组合系列）
Claude 模型负责主对话与复杂推理，GPT Codex 模型负责代码子任务，兼顾质量与成本。
| 槽位 | 模型 ID | 用途 |
|---|---|---|
sonnet | claude-sonnet-4-5-20250929 | 主力对话与理解 |
opus | claude-opus-4-6 | 旗舰推理（复杂任务） |
haiku | claude-haiku-4-5-20251001 | 轻量代码子任务 |
subagent | claude-haiku-4-5-20251001 | 并发执行（省积分） |
| 自定义 | gpt-5.3-codex | 代码专项主力 |
自定义映射
如果选择自定义映射，脚本会逐项询问每个槽位要映射到的实际模型。直接回车即可使用推荐值。
你可以随时通过编辑 ~/.claude/settings.json 或重新运行脚本来修改模型映射。
接下来做什么？
恭喜 — 你已经成功配置好 Claude Code × Token101！
以下是推荐的学习路径：