awsb企业中转

接入指南

Claude Code

本页内容

使用提供 Anthropic Messages 的 Claude 分组，将 Claude Code 命令行客户端连接到 supergpt。

准备密钥和模型

在 API 密钥打开「连接信息」，选择 Anthropic Messages，并复制分组内可用的 Claude 模型 ID。下面的 Base URL 不带 /v1，客户端会追加接口路径。

在终端中配置

macOS / Linux 的 Bash 或 Zsh：

export ANTHROPIC_BASE_URL='https://api.supergpt.win'
export ANTHROPIC_AUTH_TOKEN='YOUR_SUPERGPT_API_KEY'
export ANTHROPIC_MODEL='YOUR_CLAUDE_MODEL_ID'
claude

Windows PowerShell：

$env:ANTHROPIC_BASE_URL = 'https://api.supergpt.win'
$env:ANTHROPIC_AUTH_TOKEN = 'YOUR_SUPERGPT_API_KEY'
$env:ANTHROPIC_MODEL = 'YOUR_CLAUDE_MODEL_ID'
claude

替换密钥和模型占位符，在同一终端启动 Claude Code。已有其他服务商配置时，先检查冲突的认证变量或配置文件，避免沿用旧密钥。

确认连接

进入客户端后，用 /status 检查认证来源。发送一条简短消息，再到使用记录核对。通过本站密钥发起的调用按本站账户计费。

若主对话可用、某些后台任务却提示模型不可用，检查该任务实际请求的模型是否也在当前分组中；不要假设客户端所有默认模型都已开放。

MCP 工具按需加载

安装了很多 MCP 工具时，完整工具定义可能占用较多初始上下文。SuperGPT Connect 0.1.6 会根据当前 API Key 的线路和选中模型检查兼容性，在导入前显示结果：

  • 已支持：所有选中模型均通过验证时，自动模式默认开启按需加载。
  • 未验证：默认关闭并提示；服务暂时失败、验证过期和没有验证记录都可能出现这个状态，不等于确认不支持。
  • 不支持：明确提示，阻止强制开启；对话协议本身不兼容时，需要更换模型或客户端。

更新 Connect 后，重新获取模型并导入配置，完全退出 Claude Code，再新建会话。用 /context 检查实际 MCP 占用。已有会话的历史不会因升级自动清空；项目/组织设置、禁用实验功能的配置、ToolSearch 权限规则，以及 MCP 的 alwaysLoad 设置仍可能影响加载方式，请留意导入前提示。

客户端读取能力信息不会调用收费模型。只有实际发送模型请求才产生相应用量。配置方法及例外见 Claude Code 官方工具搜索说明。

常见问题

  • 地址返回 404：检查是否重复添加 /v1，并确认选择的是 Anthropic Messages。
  • 认证失败：确认使用本站 API Key，而非控制台密码或其他平台的密钥。
  • 新终端不生效：临时环境变量不会自动保存。需要长期使用时，参考官方说明写入用户配置，并妥善保护密钥。
  • 编辑器插件未继承设置：从桌面启动的编辑器不一定继承终端变量，按插件自己的配置入口设置。

本页覆盖 CLI 接入。VS Code 扩展、桌面应用等入口的配置方式，见 Claude Code 官方网关接入文档。

用途模型和旧配置兼容

Connect 0.1.6 导入 Claude Code 时，可以在高级设置中分别选择轻量后台任务、Sonnet / Opus / Fable 别名及子代理模型。只可选择本次已勾选的模型；自动模式优先匹配唯一的同系列模型，没有明确匹配时使用默认模型并提示。子代理默认遵循自身配置和当前会话。请检查轻量任务是否使用了符合预期的模型，费用按实际调用型号计算。

新版会处理常见旧 API Key、OAuth、模型锁定和云平台环境冲突；VS Code 扩展使用独立的绝对 CLAUDE_CONFIG_DIR 时，会把预览、导入和恢复指向同一目录。导入前可展开“查看实际写入设置”，确认模型分工和配置位置。项目设置、远程环境、组织策略或自定义启动脚本仍可能覆盖这些设置。

Artifact 工具单独提供“保留 / 禁用 / 允许”选项，默认保留现有配置；仅在线路拒绝对应工具格式时使用禁用选项。它与 MCP 按需加载独立。完整自定义模型菜单需要 Claude Code 2.1.242 或更新版本；遇到版本提示请先升级客户端。