AB
AB
AiBoss站

全部分类

教程

讯飞星辰MaaS

教程

把讯飞星辰MaaS Token Plan接入Claude Code与Cursor

讯飞星辰MaaS的Token Plan用一份订阅额度同时调用星火、GLM、DeepSeek、Kimi、Qwen等多个模型。本文说明如何获取专属API Key、区分Token Plan与常规推理服务的接口地址，并给出Claude Code、Cursor、OpenCode、OpenClaw四类工具的完整配置写法、模型ID对照表与常见错误码排查思路。

讯飞星辰MaaS的Token Plan是一套包月订阅制的大模型调用服务，按积分统一计量，以「成员」为单位分配固定额度。它的价值在于：一份订阅里可以调用多个不同厂商的模型，通过 OpenAI 协议或 Anthropic 协议接入，因此能直接挂到 Claude Code、Cursor、OpenCode、OpenClaw 这类主流 AI 编程工具上，用于代码编写、理解与优化。本文要解决的具体问题是：拿到 Token Plan 的 API Key 之后，怎样把它正确写进这些工具的配置文件，让工具真正跑起来。如果你只是想先了解这个平台的整体能力，可以先看 讯飞星辰MaaS 的工具页，再回到本文动手配置。

适合读这篇的人：已经购买或准备购买 Token Plan 套餐、希望把订阅额度接到自己常用编程工具里的开发者，以及需要为团队统一配置模型入口的技术负责人。本文不讨论模型效果评测，只讲接入链路。

准备工作

账号与套餐

Token Plan 是订阅制产品，需要先在讯飞星辰MaaS平台的 Token Plan 套餐订阅页面完成购买。套餐分为标准成员、高级成员、尊享成员三档，每档对应不同的月价格、月积分额度和 TPM 上限。价格、额度与限时活动折扣会随时间调整，下单前请以官网当前展示的信息为准。

购买完成后，在订阅页可以查看当前套餐、周期性用量和 API Key。这里有一个容易忽略的点：每个套餐对应一个独立的 API Key，且该 Key 仅用于 Token Plan 接口。不要拿常规推理服务的 Key 来配 Token Plan，两者不通用。

接口地址必须区分

这是接入过程中最容易出错的地方。Token Plan 使用独立的 Base URL（路径中含 maas-token-api），与常规推理服务的 Base URL（路径中含 maas-api）不同，两者不可混用。配置时请从订阅页复制 Token Plan 对应的地址，不要凭记忆手写，也不要沿用之前配常规推理服务时留下的地址。

协议方面，Token Plan 同时支持 OpenAI 协议与 Anthropic 协议。选哪个取决于你要接入的工具：Claude Code 走 Anthropic 协议，Cursor、OpenCode、OpenClaw 走 OpenAI 兼容协议。

模型 ID 对照

配置文件里需要填写 modelId，切换模型就是换这个 ID。当前可配置的 modelId 如下表。注意其中两个已下线的模型不要再用。

模型名称modelId状态
Spark-X2.5spark-x2.5可用
Spark-X2-Flashxsparkx2flash可用
GLM-5.2xopglm52可用
GLM-5.1xopglm51可用
GLM-5xopglm5可用
DeepSeek-V4-Proxopdeepseekv4pro可用
DeepSeek-V4-Flashxopdeepseekv4flash可用
DeepSeek-V3.2xopdeepseekv32可用
Kimi-K2.6xopkimik26可用
KiMi-K2.5xopkimik25可用
MiniMax-M2.5xminimaxm25可用
Qwen3.5-397B-A17Bxopqwen35397b可用
Qwen3.6-35B-A3Bxopqwen36v35b可用
Qwen3.5-35B-A3Bxopqwen35v35b可用
Qwen3-Coder-Next-FP8xop3qwencodernext可用
GLM-4.7-Flashxopglmv47flash可用
Spark-X2-Agentxsparkx2agent已下线
Spark-X2xsparkx2已下线

模型列表与各模型的积分单价属于易变信息，请以订阅页和控制台当前展示为准。

操作步骤

第一步：取 Key 与地址

登录讯飞星辰MaaS平台，进入 Token Plan 套餐订阅页面，复制两样东西：Token Plan 专属 API Key，以及 Token Plan 的 Base URL。把这两项先记在一个临时位置，后面每个工具都要用。

第二步：配置 Claude Code

Claude Code 的配置文件路径是 ~/.claude/settings.json。它通过环境变量读取鉴权信息和模型，写法如下：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "您的Token Plan API Key",
    "ANTHROPIC_BASE_URL": "您的Token Plan Base URL",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
    "API_TIMEOUT_MS": 600000,
    "ANTHROPIC_MODEL": "您配置的modelId",
    "ANTHROPIC_SMALL_FAST_MODEL": "您配置的modelId"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

几个字段的作用值得说清楚：ANTHROPIC_AUTH_TOKEN 填 Token Plan 的 Key；ANTHROPIC_BASE_URL 填 Token Plan 的地址；CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 设为 1 用于关闭非必要流量；API_TIMEOUT_MS 设为 600000，即较长的超时时间，避免长任务被提前掐断；ANTHROPIC_MODEL 与 ANTHROPIC_SMALL_FAST_MODEL 都填你选定的 modelId，后者用于轻量快速调用。

另外还有一个可选配置，写在 ~/.claude.json 中：

{
  "hasCompletedOnboarding": true
}

这个字段用于跳过首次启动的引导流程，适合批量部署或希望直接进入工作状态的场景。

第三步：配置 Cursor

Cursor 不需要改文件，走界面配置。入口是 Ctrl + Shift + J，然后搜索「Models」配置项。需要填三处：

  • Override OpenAI Base URL：填 Token Plan 的 Base URL
  • OpenAI API Key：填 Token Plan 的 API Key
  • 模型：填你选定的 modelId

注意 Cursor 这里走的是 OpenAI 兼容协议，所以填的是 OpenAI 相关的两个字段，而不是 Anthropic 的。填完后确认模型名与上表的 modelId 完全一致，大小写和连字符都不能错。

第四步：配置 OpenCode

OpenCode 的配置文件放在项目根目录的 opencode.config.json，或 OpenCode 指定的配置路径（具体以 OpenCode 自身文档为准）。完整写法如下：

{
  "$schema": "OpenCode 的 schema 地址",
  "provider": {
    "AstroTokenPlan": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "讯飞星辰 Token Plan",
      "options": {
        "baseURL": "您的Token Plan Base URL",
        "apiKey": "您的Token Plan API Key"
      },
      "models": {
        "astron-code-latest": {
          "name": "您配置的modelId"
        }
      }
    }
  }
}

这里 provider 使用 @ai-sdk/openai-compatible 适配器，说明它按 OpenAI 兼容协议对接。options.baseURL 必须是 Token Plan 的地址，不要写成常规推理服务的地址。

第五步：配置 OpenClaw

OpenClaw 的配置文件路径是 ~/.openclaw/openclaw.json。它的结构比前几个复杂一些，分 models 和 agents 两大块：

{
  "models": {
    "mode": "merge",
    "providers": {
      "astrontokenplan": {
        "baseUrl": "您的Token Plan Base URL",
        "apiKey": "您的Token Plan API Key",
        "api": "openai-completions",
        "models": [
          {
            "id": "您配置的modelId",
            "name": "您配置的modelId",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 92160,
            "maxTokens": 32768
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "astrontokenplan/您配置的modelId"
      },
      "models": {
        "astrontokenplan/您配置的modelId": {
          "alias": "astrontokenplan"
        }
      }
    }
  }
}

要点：mode 设为 merge 表示与已有配置合并而非覆盖；api 填 openai-completions；contextWindow 与 maxTokens 是上下文窗口和最大输出长度，示例中给的是 92160 与 32768，实际应按所选模型的上下文能力调整；agents.defaults.model.primary 的格式是「provider 名/modelId」，必须与上面 providers 里的键名一致。

一个完整示例

假设你要在 Claude Code 里用 DeepSeek-V3.2 写代码，从零走一遍：

  1. 在 Token Plan 套餐订阅页购买套餐，复制专属 API Key 和 Token Plan 的 Base URL。
  2. 打开 ~/.claude/settings.json，把 ANTHROPIC_AUTH_TOKEN 设为刚复制的 Key，ANTHROPIC_BASE_URL 设为 Token Plan 的地址。
  3. 把 ANTHROPIC_MODEL 和 ANTHROPIC_SMALL_FAST_MODEL 都填成 xopdeepseekv32。
  4. 保留 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 为 1、API_TIMEOUT_MS 为 600000。
  5. 在 ~/.claude.json 中写入 {"hasCompletedOnboarding": true}，跳过引导。
  6. 启动 Claude Code，发一句简单的代码问题验证连通性。
  7. 如果返回 401，按顺序检查三处：modelId 是否写对、Base URL 是否为 Token Plan 地址、API Key 是否来自 Token Plan 而非常规推理服务。

验证通过后，想换模型只需把两个 ANTHROPIC_MODEL 字段改成另一个 modelId，例如 xopglm5 或 xopqwen35397b，无需改动其他配置。这就是「在配置文件中指定 modelId 即可切换模型」的实际含义。

计费与额度怎么算

Token Plan 按积分计量，单次提问按实际模型使用情况扣积分，用量可在订阅页查看。积分消耗遵循统一规则：

消耗积分 = 非缓存输入Token数(百万) × 输入积分 + 缓存命中Token数(百万) × 缓存命中积分 + 输出Token数(百万) × 输出积分 + 思考Token数(百万) × 思考积分（如有思考模式）

实际消耗积分还要再乘以时段系数。周一至周五 08:00 至 22:00 之间系数为 1.0；周一至周五该时段以外，以及周六周日全天，系数为 0.8。也就是说把批量任务挪到夜间或周末执行，同样的工作量消耗更少积分。

不同模型的输入、缓存命中、输出、思考四类积分单价各不相同，同一百万 Token 在不同模型上的消耗可能相差一个数量级。选模型时除了看能力，也要看单价表。具体数值请以订阅页当前展示为准。

注意事项

套餐变更与退款

当前生效的套餐不支持升级或降级。如果额度不够或想换档位，只能另行选购其他套餐。同一档位可以多次购买，也可以多档位混合购买，额度叠加使用。

除两种情形外，套餐一经购买不支持退订退款：一是由于平台原因用户付费后无法获得服务，二是法律法规另有规定。下单前请确认档位。

有效期

各版本月套餐支付完成后的使用有效期为 31 天，套餐生效时间和流控周期从支付完成时开始计算。

上下文配置建议

上下文窗口和最大输出长度配得过大，容易触发超长错误，也会拖慢响应。素材给出的建议是：使用 DeepSeek-V3.2 时 contextWindow 配在 96k 以下、maxTokens 配在 32k 以下；使用 GLM-5 时 contextWindow 配在 96k 以下（配置上限为 256k），能明显改善响应速度和工具调用体验；其余模型建议配在 128k 以下。

对话变长之后，可以主动管理上下文：用 /compact 命令压缩当前对话，或用 /new 命令开启新会话清空历史。

常见错误码

接入阶段最常遇到的是 401 类错误。看到「无效的身份验证」或「提供的 API 密钥不正确」时，优先按顺序检查 modelId、Base URL、API Key 三项，绝大多数配置失败都出在这三处。

429 有两种含义：请求速率限制已达上限，需要降低请求频率；或者额度已用尽、达到每月最高消费限制，需要购买更多额度。两者处理方式完全不同，看错误描述区分。

11221 表示当前套餐不支持你在控制台或配置文件中指定的模型，换一个可用模型即可。11210 表示 TPM 超限，TPM 每分钟动态刷新，等待后重试。10907 和 10910 都是 token 数量超过上限，前者是对话历史加问题太长，后者需要控制输入或输出长度。500、503、10222 这类属于服务端或网络侧问题，稍后重试；持续出现再排查。

还有一类是 WebSocket 相关的错误码，例如 10006 表示同一用户不能多处同时连接，10007 表示上一条请求还在处理中、必须等模型完全回复后才能发下一条，10013 和 10014 涉及内容审核不通过。这些主要出现在实时交互场景，短连接调用一般不会碰到。

附赠权益

每份套餐附赠 AstronClaw 基础版月度会员，使用席位被分配人的手机号登录 AstronClaw 即可使用。开通任意档位套餐还会赠送一批讯飞 Skills 能力，包括超拟人语音合成、一句话复刻、极速语音转写、图片与 PDF OCR、票据识别、公文校对、文本翻译、图片理解等，通过 npx clawhub@latest install 加对应包名安装。赠送的调用量统一发放到席位购买方账号，用下单手机号登录讯飞开放平台控制台即可查询可用调用量和鉴权参数（APPID、APISecret、APIKey），赠量耗尽后可在控制台充值续费。高峰期权益到账可能有 1 至 3 分钟延迟，刚买完没看到额度不必着急。

最后提醒一句：本文涉及的套餐价格、积分单价、模型列表、限时活动都属于会变动的信息，动手前请以官网当前信息为准。

返回