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

文档版本：v1.1
最后更新：2026年3月12日

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

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

# 1.1 API Key 获取

1. 进入 [讯飞星辰 MaaS 平台] 套餐订阅 页面(https://maas.xfyun.cn/packageSubscription)
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等开源热门模型（受开源协议等法律责任限制，支持模型以讯飞星辰MaaS平台实际上架为准）。开发者通过订阅包月使用的方式有效防范了欠费风险，使用成本远低于常规 API 调用。 支持通过 OpenAI 协议与 Anthropic 协议接入，兼容 OpenClaw、Cursor、Claude Code 等主流 AI 编程工具，覆盖代码编写、理解与优化等场景，助力提升开发效率与代码质量。

# 四、套餐与计费

# 4.1 首月版（2025年3月9日上线）

说明：

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

# 4.2 次月迭代版（首版上线后升级）

迭代版在 价格与支持模型 上与2025年3月9日首版本保持一致，流控方式将调整为 请求次数 维度：

各套餐的具体请求次数上限将在次月版上线前于控制台与本文档同步更新。

# 五、购买与使用规则

# 5.1 升级与叠加购买（首月版）

• 支持升级：首次购买后若当日 Tokens 额度用尽，或有更多模型和更高使用量需求，可升级至更高档位套餐，享受新档位的日 Tokens 上限与模型列表服务。
• 支持叠加购买：可在同一档位多次购买套餐包，每增加一个套餐即增加一份当月有效的日 Tokens 额度；每个套餐对应一个独立的 API Key。
• 首次购买各版本套餐后，追加购买套餐即按「原价」（即文档中的「叠加购买」价格）计费。

# 5.2 额度使用限制

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

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

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

# 六、订阅管理

# 6.1 订阅与购买

1. 登录讯飞星辰 MaaS 平台，进入 套餐订阅 页面。
2. 选择入门版 / 专业版 / 高效版，完成首购或叠加购买。
3. 在套餐订阅页可查看（查阅内容以页面实际展示内容为准）：当前套餐、日用量（首月版）或请求次数用量（次月版）、API Key与升级入口。

# 6.2 套餐升级与叠加

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

# 6.3 退订与退款

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

# 6.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 平台团队维护。如有疑问可扫描平台左下角“联系我们”的社群二维码及技术支持二维码进行交流，或通过在线客服或工单渠道反馈。