SuperToken 配置从保存到真实任务验收的四阶段流程
SuperToken

Appearance

SuperToken 文档 下载整本工具配置手册 PDF

工具部署 ​

SuperToken 支持多种 AI 编程工具接入。你只需要准备好 Node.js、API Key，然后按对应工具教程完成配置即可。

接入信息 ​

选择 API 节点

两个节点共用同一套 API Key、模型和接口路径。

通用 Base URLhttps://api.supertoken.cc
OpenAI 兼容 Base URLhttps://api.supertoken.cc/v1

当前选择：默认节点。Claude Code、CC-Switch 等通常使用不带 /v1 的地址；Codex、Cursor 和 OpenAI SDK 通常使用带 /v1 的地址。

默认节点与香港节点功能一致。不同工具使用哪一种路径，会在各自页面中说明。

配置完成要过四关 ​

配置完成的四阶段验收SuperToken 工具配置手册 2026-07 来源：SuperToken 自制流程图，非第三方产品界面核对日期：2026-07-14不含账号、Key 或私人数据
关卡要证明什么最小证据
1. 配置已保存新进程仍能读取同一 Key 来源、Base URL、模型和启用状态关闭并重新打开工具或终端，字段仍正确
2. 网关可请求Key、协议、地址和模型在真实 API 请求中有效一次最小只读请求成功，状态码和错误已脱敏保存
3. 客户端确实走 SuperToken工具没有回退到 Auto、内置模型或另一份配置明确选择自定义模型；控制台用量或请求记录能对应时间和模型
4. 真实任务可验收不只是能聊天，而是能在目标工具中完成工作演示仓库中的 diff、测试、输出文件或真实界面状态

请求成功不等于配置已保存

当前进程里的一次测试可能只使用了临时环境变量或尚未保存的表单。保存后关闭工具，重新打开一个新终端或新窗口，再做一次请求；反过来，设置页显示“已保存”也不证明 Key、模型和网关真的可用。

Base URL 先按协议选择 ​

工具或协议填写值常见错误
Claude Code、Anthropic 兼容客户端、CC-Switch 对应 Claude 配置所选节点地址，不带 /v1错加 /v1，或把官网 https://supertoken.cc 当 API 地址
Codex、Cursor、OpenAI 兼容 SDK所选节点地址，带 /v1漏掉 /v1，或填成完整 /chat/completions / /responses 路径
Gemini CLI以本页 Gemini 教程和当前控制台为准把 OpenAI 或 Anthropic 地址直接套用到 Gemini 协议

Base URL 只填协议根地址，不要把控制台首页、模型广场页面或具体接口路径粘进去。模型名必须来自当前账号可用的模型或工具专用别名，不能只凭产品宣传名猜测。

Key 的最小权限与轮换 ​

  1. 按人员、设备、工具和环境分别创建 Key；不要让整个团队共用一个长期 Key。
  2. 如果控制台支持分组或模型范围，只开放当前工具需要的模型和额度；测试 Key 不要拥有生产系统权限。
  3. 记录 Key 的负责人、用途、创建时间和轮换日期，只在密码管理器或批准的 secret store 保存完整值。
  4. 日志、截图、Issue 和聊天里不展示完整 Key；排错最多核对变量是否存在和少量尾号，不回显整个值。
  5. 轮换时先创建新 Key，在一个客户端完成四关验收，再逐个迁移；确认没有旧请求后撤销旧 Key。
  6. 一旦怀疑泄露，先撤销并创建新 Key，再排查传播范围；不要等到“确认被滥用”才处理。

手工写入 shell 启动文件或用户环境变量意味着 Key 会以可恢复形式保存在本机。只在个人受控设备使用这种方式，并限制配置文件权限；共享电脑、CI 和团队环境应改用批准的 secret store、短期凭据或 runner secrets。不要把真实 Key 直接写进仓库里的 .env、config.toml、auth.json 或教程截图。

统一错误决策表 ​

现象最常见原因按顺序处理
401 / Invalid tokenKey 错误、过期、撤销，变量未加载，或客户端读取了另一份配置新终端确认变量“存在但不回显”；检查 Key 来源；重新复制或轮换；再做最小请求
403 / ForbiddenKey 分组不允许当前模型、账号或组织策略拒绝该动作检查控制台分组、模型范围和账号状态；换到明确允许的模型，不扩大不相关权限
404 / HTML 页面Base URL、协议路径或模型名错误对照上表检查是否缺/多 /v1；删除完整接口后缀；从模型广场复制当前模型名
429 / Rate limit请求过快、并发过高，或账号额度/余额策略限制降低并发并等待重试窗口；检查用量、余额、分组额度和模型状态；不要无限快速重试
明确提示余额或配额不足可用余额、额度或预算上限不足检查控制台用量和分组预算；充值或调整预算后再发一次最小请求
连接超时 / TLS / DNS本机网络、代理、证书、VPN 或目标域名不可达先在同一终端检查 DNS 与 HTTPS；确认代理变量和公司网络策略，不输出代理凭据
测试成功，但重启后失效只设置了当前进程变量，表单未保存，或新进程加载了另一配置文件重新保存；关闭并重开；确认配置文件路径和 shell 启动文件；再做真实请求
客户端有回复，但控制台没有对应记录工具回退到 Auto/内置模型，模型别名不对，或 Base URL 开关未启用关闭 Auto 和回退；明确选择自定义模型；检查 Base URL 开关和请求时间

排错时一次只改变 Key、Base URL、模型、网络中的一个变量，并保留脱敏错误全文。把所有设置同时重做，通常只会丢失根因。

AI 编程工具 ​

工具说明配置方式
CursorAI 代码编辑器填写 OpenAI API Key 与 Base URL
Claude CodeAnthropic 官方终端编程代理配置环境变量
Gemini CLIGoogle 终端 AI 工具写入 ~/.gemini/.env
CodexOpenAI 终端编程代理编辑 ~/.codex/config.toml 并设置 OPENAI_API_KEY
Memory Agent项目长期记忆与上下文管理先查看规划说明

从接入到实战

工具能正常对话后，可以进入新的 AI 编程手册，系统学习 Codex 与 Claude Code 的项目规则、权限、MCP、提示词和真实开发工作流。

按目标选择 ​

最快接入CC-Switch

图形界面填写 Key、Base URL 和默认模型，新手优先。

Claude 生态Claude Code

适合终端编程代理，使用 Anthropic 兼容接口。

OpenAI 生态Codex

适合在本地仓库里阅读、修改、审查代码。

编辑器Cursor

在 Cursor 模型设置里填写 SuperToken 网关信息。

配置工具 ​

工具说明
CC-Switch ⭐图形化配置管理工具，适合新手快速接入

其他工具 ​

工具说明
OpenClaw网关面板管理工具

开始前 ​

  1. 根据目标工具确认是否需要 Node.js；Claude Code 原生安装不要求 Node.js。
  2. 在控制台创建最小范围、可轮换的 API Key 和对应模型分组。
  3. 选择工具并按协议填写 Base URL、Key 来源和模型。
  4. 重启客户端，按“四关”完成保存、网关、客户端和真实任务验收。

SuperToken - 让全球顶级 AI 模型触手可达

Copyright © 2026-present SuperToken