逐步图文说明：用一条命令完成 Token101 × Claude Code 的全部接入配置

Claude Code 自动配置工具使用说明

本页是 Token101 一键接入 Claude Code 脚本的完整逐步操作指南，包含每个交互步骤的说明与截图，帮助你顺利完成接入。

前提条件

运行脚本前，请确认：

已注册 Token101 账号并激活 API
已在设置 → API 密钥创建好一个 API Key（格式：sk- 开头，至少 32 位）
已安装 Claude Code
系统为 macOS 或 Linux

运行脚本

macOS / Linux

在终端中执行以下命令启动安装向导：

bash <(curl -fsSL https://token.ppthub.shop/scripts/setup-token101-claude-code-mac-hub.sh)

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 }"

如果遇到"脚本执行被禁用"错误，请先在 PowerShell 中执行： Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

常见问题

出现 401 错误

API Key 不正确或已失效。请前往 token.ppthub.shop 重新生成，再运行脚本写入新 Key。

模型未在 /model 中显示

退出当前 Claude Code 会话，关闭终端，重新打开一个新终端再启动 Claude Code。

鉴权冲突（ANTHROPIC_API_KEY 与 ANTHROPIC_AUTH_TOKEN 同时存在）

两个变量单独使用时都能正常工作——Token101 同时受理 ANTHROPIC_AUTH_TOKEN（发送 Authorization: Bearer ...）和 ANTHROPIC_API_KEY（发送 X-Api-Key: ...）。只有当两个同时存在时才会出问题：此时 Claude Code 实际发送哪个请求头取决于你的 Claude Code 版本。请检查 ~/.zshrc 和 ~/.zprofile，只保留一个——本脚本写入的是 ANTHROPIC_AUTH_TOKEN。脚本会自动清理旧的 ANTHROPIC_API_KEY，但如果之前有手动添加过，请手动删掉那一行。两个变量的完整说明见 Claude Code 接入指南。

如何修改模型映射

有两种方式修改模型映射：

方式一：直接编辑 ~/.claude/settings.json

打开 ~/.claude/settings.json，修改 env 块中对应的字段：

{
  "env": {
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5-20250929",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001"
  }
}

将字段值替换为你想使用的模型 ID 即可。例如，将 sonnet 槽位改为 GPT 模型：

"ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5.3-codex"

可用的模型 ID 请前往 Token101 模型列表查看，页面列出了所有当前支持的模型及其 ID。

方式二：重新运行脚本

重新执行安装脚本，在 Step 1.5 中选择 2（自定义），脚本会逐槽位询问你要使用的模型。

如何切换 1M 上下文

重新运行脚本是最简单的方式，在 Step 1.7 重新选择即可。

如需手动操作：

禁用 1M 上下文（恢复 200K）：在 settings.json 的 env 块中添加 "CLAUDE_CODE_DISABLE_1M_CONTEXT": "1"
启用 1M 上下文：删除 settings.json 中的 CLAUDE_CODE_DISABLE_1M_CONTEXT 字段，并删除 ~/.zshrc 中对应的 export CLAUDE_CODE_DISABLE_1M_CONTEXT 行

如何回滚到之前的配置

脚本在覆盖前会自动在 ~/.claude/ 目录下创建带时间戳的备份：

~/.claude/settings.json.bak.YYYYMMDD_HHMMSS

将对应的 .bak 文件重命名为 settings.json 即可还原。

Claude Code 自动配置工具使用说明

本页是 Token101 一键接入 Claude Code 脚本的完整逐步操作指南，包含每个交互步骤的说明与截图，帮助你顺利完成接入。

前提条件

运行脚本前，请确认：

已注册 Token101 账号并激活 API
已在设置 → API 密钥创建好一个 API Key（格式：sk- 开头，至少 32 位）
已安装 Claude Code
系统为 macOS 或 Linux

运行脚本

macOS / Linux

在终端中执行以下命令启动安装向导：

bash <(curl -fsSL https://token.ppthub.shop/scripts/setup-token101-claude-code-mac-hub.sh)

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 }"

如果遇到"脚本执行被禁用"错误，请先在 PowerShell 中执行： Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

安装向导步骤详解

以下截图均来自 macOS 环境，Windows 操作步骤完全相同。

欢迎界面 & Claude Code 版本检测

脚本启动后，首先显示欢迎界面，列出本次配置涉及的内容、推荐模型映射，以及 subagent 槽位的说明。

同时自动检测你当前安装的 Claude Code 版本：

[OK]    检测到 Claude Code 2.1.140 (Claude Code)

如果未检测到 Claude Code，脚本会给出安装链接提示，你可以先安装再继续。

欢迎界面 + 版本检测

Step 1/4：输入 Token101 API Key

脚本提示你输入 API Key：

▶ Step 1/4：输入 Token101 API Key

  请前往 https://token.ppthub.shop → Settings → API Keys 创建密钥
  密钥格式示例：sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

  请输入 API Key:

操作： 粘贴你的 Token101 API Key 并回车。

脚本会自动校验格式（sk- 前缀 + 最小长度），通过后显示：

[OK]    API Key 格式验证通过

如果还没有 API Key，请先前往 token.ppthub.shop 创建，再运行脚本。

Step 1 — 输入 API Key

Step 1.5/4：选择模型映射

脚本展示推荐的模型映射方案，并询问你是否使用推荐配置：

▶ Step 1.5/4：选择模型映射

  推荐模型映射：
    sonnet  → claude-sonnet-4-5-20250929   （日常主力）
    opus    → claude-opus-4-6              （旗舰推理）
    haiku   → claude-haiku-4-5-20251001    （轻量后台）
    subagent→ Claude Code 默认（不强制覆盖）（并发执行）
    自定义  → gpt-5.3-codex               （代码专项备选）

  请选择模型方案 [1=推荐 / 2=自定义]（默认 1）:

选项	说明
1 — 推荐（默认）	直接使用上表中的模型映射，无需逐项填写
2 — 自定义	脚本逐项询问每个槽位，直接回车即可使用推荐值

Step 1.5 — 选择模型映射

Step 1.6/4：选择安装后动作

脚本询问配置写入完成后你想要的默认启动指引：

▶ Step 1.6/4：选择安装后动作

    1) 仅写入配置（推荐，最安全）
    2) 标准启动 Claude Code（claude）
    3) 高权限模式启动 Claude Code（claude --dangerously-skip-permissions）

  请选择安装后动作 [1/2/3]（默认 1）:

选项	说明
1 — 仅写入配置（默认）	最安全，脚本仅写入配置文件，不修改其他系统设置
2 — 标准启动	配置完成后，脚本会提示你执行 `claude` 命令
3 — 高权限启动	配置完成后，脚本会提示你执行 `claude --dangerously-skip-permissions`；同时会在 settings.json 中写入 `skipDangerousModePermissionPrompt: true`

高权限模式会跳过 Claude Code 的权限确认提示，适合在你完全受控的个人开发环境下使用，不建议在共享或生产环境中开启。

Step 1.6 — 选择安装后动作

Step 1.7/4：选择上下文窗口

脚本询问是否启用 1M token 超长上下文窗口：

▶ Step 1.7/4：选择上下文窗口
  Claude Code 支持 1M token 超长上下文窗口（默认 200K）。
  启用后可处理更大的代码库，但会消耗更多 token 额度。

    1) 启用 1M 上下文（适合大型项目）
    2) 保持 200K 标准上下文（推荐，节省额度）

  请选择上下文窗口 [1/2]（默认 2）:

选项	说明
1 — 启用 1M 上下文	Claude Code 可处理最多 100 万 token 的代码库，适合超大型项目，但每次调用消耗的积分更多
2 — 保持 200K（默认）	标准上下文窗口，适合大多数日常开发场景，更节省积分

选择后可随时通过重新运行脚本或手动编辑 ~/.claude/settings.json 来切换。详见文末的如何切换 1M 上下文。

Step 1.7 — 选择上下文窗口

模型映射确认

完成以上选择后，脚本展示本次将写入的完整模型映射，供你核对：

  本次写入的模型映射：
    sonnet  → claude-sonnet-4-5-20250929
    opus    → claude-opus-4-6
    haiku   → claude-haiku-4-5-20251001
    subagent→ Claude Code 默认（不强制覆盖）（留空 = 自动使用 sonnet 槽位模型）
    GPT-5.3 Codex → gpt-5.3-codex

模型映射确认汇总

Step 2/4：写入 `~/.claude/settings.json`

脚本自动备份现有配置并写入新配置：

▶ Step 2/4：写入 ~/.claude/settings.json
[OK]    已备份现有配置到：/Users/yourname/.claude/settings.json.bak.20260513_165558
[OK]    settings.json 写入完成

如果此前从未有过 settings.json，脚本会直接创建；如果已存在，会先创建带时间戳的 .bak 备份再覆盖。

写入的文件内容示例（推荐配置 + 启用 1M 上下文）：

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的APIKey",
    "ANTHROPIC_BASE_URL": "https://token.ppthub.shop/api",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5-20250929",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001"
  },
  "model": "sonnet",
  "availableModels": ["sonnet", "opus", "haiku"]
}

Step 2 — 写入 settings.json 成功

Step 2.5/4：检测 shell 环境

脚本自动识别当前 shell 类型及对应的配置文件路径：

▶ Step 2.5/4：检测 shell 环境
[INFO]  Shell 类型：zsh
[INFO]  主配置文件：/Users/yourname/.zshrc
[INFO]  登录配置文件：/Users/yourname/.zprofile

支持 zsh（macOS 默认）和 bash，脚本自动判断，无需手动选择。

Step 2.5 — Shell 环境检测

Step 3/4：写入 shell 环境变量

脚本在 shell 配置文件中写入受管理的 Token101 配置块：

▶ Step 3/4：写入 shell 环境变量
[OK]    已更新 /Users/yourname/.zshrc 中现有的 Token101 配置块
[OK]    已更新 /Users/yourname/.zprofile 中现有的 Token101 配置块
[OK]    配置已写入 shell 文件；新开终端后会自动生效

写入的配置块以 # Token101 × Claude Code 配置 和 # Token101 × Claude Code 配置结束 为边界，重复运行脚本时会替换原有配置块，不会重复追加。

Step 3 — 写入 shell 环境变量成功

配置完成界面

所有步骤完成后，脚本输出配置完成界面，包含下一步指引、模型映射汇总、验证清单和常见问题：

────────────────────────────────────────────────────────
  ✓ 配置完成
────────────────────────────────────────────────────────

配置完成 — 完整输出界面

配置完成后的操作

第一步：让配置生效

推荐方式：关闭当前终端窗口，打开一个新的终端，再启动 Claude Code。

如需在当前 shell 立即生效，也可以手动执行：

source ~/.zshrc
source ~/.zprofile

然后验证环境变量是否正确写入：

env | egrep '^(ANTHROPIC|CLAUDE_CODE)_'

正常情况下应能看到类似以下输出：

ANTHROPIC_BASE_URL=https://token.ppthub.shop/api
ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5-20250929
ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-6
ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5-20251001
ANTHROPIC_AUTH_TOKEN=sk-你的APIKey
CLAUDE_CODE_DISABLE_1M_CONTEXT=1

env 验证输出

第二步：启动 Claude Code

根据你在 Step 1.6 中的选择执行对应命令：

选择	启动命令
仅写入配置 / 标准启动	`claude`
高权限启动	`claude --dangerously-skip-permissions`

第三步：在 Claude Code 中验证配置

启动后，在 Claude Code 内输入 /model，确认以下验证清单：

□ /model 菜单显示：sonnet、opus、haiku、GPT-5.3 Codex 四个选项
□ sonnet 映射到：claude-sonnet-4-5-20250929
□ opus   映射到：claude-opus-4-6
□ haiku  映射到：claude-haiku-4-5-20251001
□ subagent 未显式覆盖（默认跟随 sonnet 槽位）
□ 1M context 选项状态与你的选择一致

Claude Code /model 菜单验证