一键配置脚本
不想手抄 Base URL / 环境变量?下载对应脚本本地运行,自动备份现有配置并写入新配置,3 步完成接入。
aiproxynode 一个 token 只绑定一个分组,跨分组不会自动转发:
kiro分组 — 跑 Claude 系列模型 (sonnet / opus / haiku)gptpuls分组 — 跑 GPT 系列模型 (gpt-5.5 / 5.4 / 5.3-codex)
如果在客户端看到 no available channels under group X,通常是 token 分组与 model 不匹配。
下载
选择你的客户端场景,下载对应平台的脚本(.ps1 用于 Windows / .sh 用于 macOS Linux):
| 场景 | 所需分组 | Windows (.ps1) | macOS (.sh) |
|---|---|---|---|
| VSCode + Claude Code | kiro | 下载 | 下载 |
| Claude Desktop + CLI | kiro | 下载 | 下载 |
| VSCode + Cline (走 GPT) | gptpuls | 下载 | 下载 |
| Cursor + Claude | kiro | 下载 | 下载 |
| Cursor 混用 (运行时选 Claude/GPT) | 运行时选 | 下载 | 下载 |
准备工作
- 已在 控制台 → 令牌 创建好 token (注意分组要与脚本对应,见上表"所需分组"列)
- 账号余额充足 — 余额不足会在第一次调用时报
402 - 对应客户端已安装(VSCode / Claude Desktop / Cursor 等)
在 Windows 上运行 (.ps1)
方式 A · 右键运行(推荐)
- 下载对应
.ps1到本地任意目录(例如下载文件夹) - 右键文件 → 使用 PowerShell 运行
- 按提示粘贴 token (输入时不会回显,这是正常的)
- 看到
[4/4] 完成即成功;终端会列出下一步操作
方式 B · 终端手动运行
# 进入下载脚本所在目录 cd $env:USERPROFILE\Downloads # 如系统首次禁止脚本运行,本会话临时放开 Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass # 运行(以 VSCode + Claude Code 为例) .\setup-vscode-claude.ps1
支持 PowerShell 5.1(Windows 10 11 自带)与 PowerShell 7+。脚本会自动检测并使用兼容 API。
在 macOS / Linux 上运行 (.sh)
# 进入下载目录 cd ~/Downloads # 添加可执行权限(可选 - 也可以直接用 bash 运行) chmod +x setup-vscode-claude.sh # 运行 bash setup-vscode-claude.sh
同样会提示输入 token (终端不回显)。完成后按提示重启相应客户端即可。
脚本会做什么
- 提示输入 token — 输入时不回显,内存中处理后零化清理,不写日志
- 备份现有配置 — 把会被改动的配置文件加日期后缀复制一份到原目录(例如
config.json.bak.20260516) - 合并新配置 — 不会覆盖你已有的非冲突项,只改 base URL / API key / 模型这几个键
- 提示下一步 — 列出"重启 VSCode""在 Settings 里启用 Claude Code"等具体操作
当前版本脚本不在脚本内做在线验证 — 写完配置只打印"打开客户端发一条消息确认连通"。这是为了避免脚本流程持有 token,降低暴露面。如果首次调用失败,优先检查:
- token 分组是否与目标模型匹配 (kiro=Claude / gptpuls=GPT)
- 余额是否充足 (控制台首页显示)
- 客户端是否已重启使配置生效
回滚 / 卸载
所有被改动的配置都有 .bak.<日期> 备份,直接重命名回去即可恢复:
# 找回备份 ls $env:APPDATA\Code\User\settings.json.bak.* # 恢复(以 20260516 为例) mv settings.json.bak.20260516 settings.json
# macOS 同理 ls ~/Library/Application\ Support/Code/User/settings.json.bak.* mv settings.json.bak.20260516 settings.json
常见问题
PowerShell 报"无法加载...因为在此系统上禁止运行脚本"
系统执行策略默认禁脚本。在当前 PowerShell 会话临时放开:
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
这只影响当前窗口,关闭即恢复;不会修改系统全局策略。
macOS 报"permission denied"
chmod +x setup-xxx.sh && bash setup-xxx.sh
客户端发消息报 no available channels under group X
token 绑的分组与调用的模型不匹配。回 控制台 → 令牌 编辑 token 改分组,或重新创建。注意:改分组后立刻调用可能仍读旧分组(后端 Redis 缓存,几分钟后自动清),建议直接新建一个 token 验证。
客户端发消息报 402 或 insufficient_quota
账户余额或令牌额度耗尽。前往充值或在令牌设置里调高上限。
客户端发消息报 401 invalid api key
token 写错或已被删除。回控制台核对,或重新创建一个再跑脚本。
不想用脚本 - 手动配置
如果你倾向自己改配置,所有手动改法都在 接入文档 → IDE 客户端接入 章节,包含每个客户端需要改的环境变量 / 配置文件路径与 JSON 字段。
脚本源码
脚本是普通文本,可以在浏览器里直接打开查看(任何浏览器都行,不会自动执行):
- /scripts/setup-vscode-claude.ps1
- /scripts/setup-vscode-claude.sh
- (其余 8 个见上方下载表格)
不放心的话建议先打开看一遍再运行 — 脚本不超过 200 行,只调用本地命令(读 token / 备份 / 写 JSON),不发任何外部网络请求。