帮助中心
常见问题

「控制台 → 令牌管理」提供 Codex / Claude Code 的一键配置命令，已自动填好地址、密钥与必要参数。

1. 复制对应系统的命令。
2. Windows：用管理员权限打开 PowerShell；Mac：打开终端 Terminal。
3. 从第一行开始完整粘贴后回车，自动完成配置。
4. 配置完重新打开终端 / 应用再使用（环境变量需新进程才生效）。

⚠️ 该命令包含你的 API Key，请勿泄露给他人。

官方 Codex 桌面应用在部分 Windows 环境会报「无法设置非管理员沙盒」——这是该应用自身的问题，与 SalpX 无关，且无法通过配置修复。请改用命令行版：

1. 装 Node.js（nodejs.org 下载 LTS 安装包，或 winget install OpenJS.NodeJS.LTS），开新终端确认 node -v 有版本号。
2. 安装 Codex：npm install -g @openai/codex。（Windows 若提示禁止运行脚本：Set-ExecutionPolicy -Scope CurrentUser RemoteSigned）
3. 用上面的「一键配置」写好 ~/.codex/config.toml 与 auth.json；或手动配置：provider 地址 https://www.salpx.com/v1、wire_api = "responses"、并加 sandbox_mode = "danger-full-access"。
4. 运行：codex --sandbox danger-full-access。

说明：Codex 现已仅支持 wire_api = "responses"（不再支持 chat）；sandbox_mode = "danger-full-access" 用于跳过桌面/沙盒初始化的报错。

1. 安装：npm install -g @anthropic-ai/claude-code。
2. 设三个环境变量（或用「一键配置」）：ANTHROPIC_BASE_URL=https://www.salpx.com（不带 /v1）、ANTHROPIC_AUTH_TOKEN=你的令牌、ANTHROPIC_MODEL=claude-...。
3. 开新终端运行 claude。

base_url 不要带 /v1：客户端会自动补 /v1/messages；带了会变成 /v1/v1/ 而报 404。

官方 Claude Desktop / Codex 桌面应用是面向官方账号的消费级产品，没有填写自定义 API 地址的入口，无法指向 SalpX。想要桌面聊天，请用支持自定义端点的第三方客户端：

• ChatBox、Cherry Studio、LobeChat 等。
• 新增一个「自定义 / OpenAI 兼容」供应商：地址填 https://www.salpx.com/v1，密钥填你的令牌，保存后选模型即可对话。

• 官方桌面应用用不了：Codex 桌面版沙盒报错 / Claude 桌面版锁官方端点 → 改用 CLI 或第三方聊天客户端。
• 改了环境变量没生效：必须重开终端 / 应用（旧进程读不到新变量）。
• Windows 提示禁止运行脚本：Set-ExecutionPolicy -Scope CurrentUser RemoteSigned。
• Codex 报 wire_api 不支持：把 provider 的 wire_api 改为 "responses"。
• 填了地址仍连官方：检查 base_url（OpenAI 类带 /v1、Claude 类不带 /v1）与令牌是否填对、无多余空格。

额度是平台用来记录模型调用消耗的内部计量单位。对按量计费模型，通常会同时考虑用户分组倍率、模型倍率、输入 token 与输出 token。

• 不同模型的输出补全倍率可能不同，输出通常比输入更贵。
• 非流式调用中，上游可能只返回总 token，但输入与输出倍率并不完全相同。
• 视频、图片等按次模型不按 token 计算，按后台配置的固定价格扣费。

常见原因是“账户余额”和“令牌额度限制”是两层控制。账户有钱不代表某个 API Key 的可用额度没有被限制。

• 检查 控制台 → 令牌管理 中该 Key 的额度上限。
• 确认 Key 没有过期、未被禁用、没有 IP 或模型限制。
• 视频或高价模型会先预扣较大额度，余额接近阈值时也可能被拒。

优先级决定先用哪一批渠道；权重决定同一优先级下如何分配请求。

• 优先级：数字越大越优先。优先级 2 会先于优先级 1 被选中。
• 权重：同优先级渠道按权重比例分配。例如权重 2:1，请求大致按 2:1 分流。
• 建议稳定低价渠道给高优先级；备份渠道降低优先级但保持启用。

1. 确认用户分组是否允许使用该模型。
2. 确认渠道分组包含当前用户所在分组。
3. 确认渠道模型列表包含请求里的模型名，大小写和别名要一致。
4. 确认渠道状态为启用，且没有因余额、测试失败或自动禁用被暂停。

这个错误表示系统期望收到 JSON，但实际收到的是 HTML 页面。常见场景是上游网关、Cloudflare、安全策略或错误页拦截了请求。

• 检查渠道 Base URL 是否填错，是否多写了 /v1 或漏写路径。
• 确认 API Key 有效，且该 Key 有目标模型权限。
• 检查服务器 IP 或代理节点是否被上游安全策略拦截。
• 必要时用服务器上的 curl 直接请求上游，确认返回内容是不是 HTML。

这通常说明模型没有可用的按量倍率或按次价格。到后台检查：

• 系统设置 → 运营设置 → 模型倍率设置 中是否配置了模型倍率、补全倍率或固定价格。
• 按次模型请放在固定价格里，不要再按 token 或秒数重复计算。
• 如果是内部自用测试，可确认是否开启了自用模式。

这类错误多发生在浏览器或桌面客户端无法连到 API 地址时。

1. 确认 API 地址填写为 https://www.salpx.com/v1。
2. 确认 API Key 已填入 Authorization，并且没有多余空格。
3. 浏览器页面是 HTTPS 时，不要调用 HTTP 接口，否则会被浏览器拦截。
4. 如果使用代理客户端，检查代理规则是否把 SalpX 域名错误拦截。

这通常表示上游渠道返回了 429 或当前分组可用渠道都处于繁忙状态。

• 稍后重试，或切换到其他可用模型。
• 管理员可增加同分组备用渠道、提高渠道余额、调整权重与优先级。
• 高峰时段的视频、图片、推理模型更容易触发排队或限流。

正常部署下不会。关键在于数据库和数据目录是否持久化。

• PostgreSQL / MySQL：只要数据库服务和数据卷没有被删除，数据不会因为应用升级丢失。
• SQLite：必须正确挂载数据库文件所在目录，否则容器重建可能导致数据丢失。
• 升级前建议备份数据库与配置文件，尤其是生产环境。

一般不需要。系统启动时会自动执行必要的结构调整。只有更新日志明确要求时，才需要按说明执行额外脚本。

这通常表示渠道、模型能力表之间出现了无效关联。例如删除了渠道记录，但能力表里还残留该渠道 ID。

• 避免直接手动删除数据库里的渠道记录。
• 优先使用后台渠道管理、模型部署、批量修复能力。
• 如果已经手动改库，需要检查 channels 与 abilities 的对应关系。