# 讯飞星辰 MaaS · Astron Coding Plan 使用文档

文档版本：v2.1
最后更新：2026年4月13日

# 一、关键配置信息（必读）

以下信息为 Coding Plan 接入所需的核心参数，请复制到对应工具的配置文件中。

# 1.1 API Key 获取

1. 访问讯飞星辰 MaaS 平台套餐订阅页面 (opens new window)
2. 购买后复制 Coding Plan 专属 API Key

每个套餐对应一个独立 API Key，仅用于 Coding Plan 接口。

# 1.2 接口地址

# 1.3 模型名称

astron-code-latest

所有请求的 model 参数ID统一使用此值。底层模型（DeepSeek-V3.2、GLM-5 等） 在https://maas.xfyun.cn/packageSubscription 套餐订阅 页面的操作栏点击配置模型按钮后切换使用，1-3 分钟生效。

# 二、工具配置模板

# 2.1 OpenClaw

配置文件路径：~/.openclaw/openclaw.json

{
  "models": {
    "mode": "merge",
    "providers": {
      "astroncodingplan": {
        "baseUrl": "https://maas-coding-api.cn-huabei-1.xf-yun.com/v2",
        "apiKey": "您的Coding Plan API Key",
        "api": "openai-completions",
        "models": [
          {
            "id": "astron-code-latest",
            "name": "astron-code-latest",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 92160,
            "maxTokens": 32768
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "astroncodingplan/astron-code-latest"
      },
      "models": {
        "astroncodingplan/astron-code-latest": {
          "alias": "astroncodingplan"
        }
      }
    }
  }
}

# 2.2 Claude Code

配置文件路径：~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "您的Coding Plan API Key",
    "ANTHROPIC_BASE_URL": "https://maas-coding-api.cn-huabei-1.xf-yun.com/anthropic",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
    "API_TIMEOUT_MS": 600000,
    "ANTHROPIC_MODEL": "astron-code-latest",
    "ANTHROPIC_SMALL_FAST_MODEL": "astron-code-latest"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

可选配置：~/.claude.json

{
  "hasCompletedOnboarding": true
}

# 2.3 Cursor

配置入口：Ctrl + Shift + J → 搜索 「Models」

# 2.4 OpenCode

配置文件路径：项目根目录 opencode.config.json 或 OpenCode 指定配置路径（以 OpenCode 文档 (opens new window) 为准）

Coding Plan 使用 独立 Base URL（maas-coding-api），与常规推理服务（maas-api）不同，请勿混用。

完整配置示例：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "AstronCodingPlan": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "讯飞星辰 Coding Plan",
      "options": {
        "baseURL": "https://maas-coding-api.cn-huabei-1.xf-yun.com/v2",
        "apiKey": "您的Coding Plan API Key"
      },
      "models": {
        "astron-code-latest": {
          "name": "Astron Coding Plan"
        }
      }
    }
  }
}

# 三、产品简介

讯飞星辰 MaaS 平台 Coding Plan 是面向开发者的按月畅享的 AI 编码订阅服务，整合了星火X2和GLM、Kimi 、MiniMax、DeepSeek、Qwen等开源热门模型（受开源协议等法律责任限制，支持模型以讯飞星辰MaaS平台实际上架为准）。开发者通过订阅包月使用的方式有效防范了欠费风险，使用成本远低于常规 API 调用。 支持通过 OpenAI 协议与 Anthropic 协议接入，兼容 OpenClaw、Cursor、Claude Code 等主流 AI 编程工具，覆盖代码编写、理解与优化等场景，助力提升开发效率与代码质量。

# 四、套餐与计费

# 4.1 首月版（2026年3月9日上线，4月9日起不再支持购买）

说明：

• 首月版采用 日 Tokens 上限 流控，每日 00:00:00（UTC+8）重置；
• 首次购买与叠加购买价格不同，叠加购买适用于在首次购买后追加同档位套餐以增加日额度；
• 三个版本套餐：入门版A到专业版B到高效版C，支持升级并且按实际使用周期折算补差价。

# 4.2 焕新版（2026年4月9日上线）

# 4.2.1 套餐额度刷新规则

流控方式调整为 请求次数 维度：

举例说明： 用户于26-04-13 10:09:30，完成了套餐订单支付，流控策略如下：

• 五小时流控，订阅生效后，此刻会校验26-04-13 05:09:30 至 26-04-13 10:09:30 的用量，下一次刷新时间是26-04-13 11:00:00；
• 周流控，订阅生效后，此刻会校验26-04-06 10:09:30 至 26-04-13 10:09:30的用量，下一次刷新时间是26-04-14 08:00:00；
• 月限额，有效期为：26-04-13 10:09:30 至 26-05-14 10:09:30。

# 4.2.2 套餐额度限制说明

Coding Plan速率限制会根据资源情况动态调整。高峰期使用Astron Coding Plan可能会出现请求超限情况，建议您间隔一段时间后重试或者更换其他模型。 请注意：如在多个实例上同时开启 OpenClaw（例如在多台机器或多个容器中运行），可能会触发平台限流策略，从而出现限流报错。

# 4.2.3 套餐使用场景限制

Coding Plan 额度仅限在 编程工具（如 Claude Code、Open Code、Cursor、OpenClaw 等）的交互式编码场景中使用。
禁止将 Coding Plan 的 API Key 用于：

• 自动化脚本、批量任务
• 自建应用后端或服务端
• 任何非交互式、非编程工具场景的调用

违规或滥用可能导致限流、订阅停用或账号注销，请合理使用。

# 4.2.4 套餐额度消耗说明

单次提问将按实际“模型调用次数”扣除额度。 作为参考：简单任务约消耗 3-10 次，复杂任务约 10-30+ 次。 实际消耗次数的影响因素有任务难度、上下文及工具使用的数量和情况。 在 讯飞星辰 MaaS 平台套餐订阅页面 (opens new window) 可以查看套餐用量。

# 五、订阅管理

# 5.1 订阅与购买

1. 登录讯飞星辰 MaaS 平台，进入 套餐订阅 页面。
2. 选择无忧版 / 专业版 / 高效版，完成首购或叠加购买，每个套餐订阅支付完成后，开始计算套餐生效时间和流控周期，各版本月套餐支付完成后的使用有效期为31天。
3. 在套餐订阅页可查看（查阅内容以页面实际展示内容为准）：当前套餐、周期性用量、API Key与升级入口。

# 5.2 套餐升级与叠加

• 升级：支持从无忧版升级至专业版或高效版，支持从专业版升级至高效版，升级费用按当前生效套餐剩余天数折算差价。
• 叠加：支持在同一档位多次购买，每份叠加对应一个 API Key 与一份日tokens额度（首版）或对应请求次数额度（焕新版）。
• 降级：不支持当前生效套餐从高效版或专业版降级，如需降级使用，需等待当前生效套餐到期后，重新购买更低套餐。

# 5.3 退订与退款

除下列情形以外，Coding Plan套餐服务一经购买，不支持退订退款，请谨慎下单：1.由于平台原因，用户付费后无法获得服务；2.法律法规另有规定。

# 5.4 生效时间

• 套餐内模型切换：预计切换后1-3分钟后生效并可用。
• 套餐升级：预计升级后1-3分钟生效并可用。

# 六、协议与规范

• 本服务遵循讯飞星辰 MaaS 平台用户协议及相关产品条款。
• 使用 Coding Plan 即视为同意本产品文档中的额度用途与使用限制。
• 具体 SLA、计费细则以控制台与最新公告为准。

# 七、常见问题

# Q1：如何切换底层模型？

在讯飞星辰 MaaS 套餐订阅 页面切换，1-3 分钟后生效。请求时 model 始终为 astron-code-latest。

# Q2：API Key 报错怎么办？

• 确认 Key 来自「套餐订阅」页面，非平台其他服务
• 确认 Base URL 正确（OpenAI 协议用 https://maas-coding-api.cn-huabei-1.xf-yun.com/v2，Anthropic 协议用 https://maas-coding-api.cn-huabei-1.xf-yun.com/anthropic）
• 确认 model ID 使用 astron-code-latest
• 确认套餐未过期或额度未用尽

# Q3：支持哪些编程工具？

Claude Code、OpenClaw、Cursor、OpenCode 等支持 OpenAI/Anthropic 协议的工具均可接入。更多其它工具是否支持接入讯飞星辰astron coding plan，可咨询工具提供方确认。

# 八、错误码列表

# 九、版本记录

# 十、联系我们

本文档由讯飞星辰 MaaS 平台团队维护。如有疑问可扫描下方社群二维码，入群反馈问题并获取技术支持。