讯飞星辰 Astron Coding Plan 开源AI工具配置文档

文档来源：讯飞星火MaaS CodingPlan官方文档 https://www.xfyun.cn/doc/spark/CodingPlan.html 适配：Claude Code / OpenClaw / OpenCode / Cursor / Cline / Kilo Code / Codex CLI / TRAE 等主流编程Agent工具区分两套兼容协议：Anthropic（Claude系工具）、OpenAI（IDE/CLI通用工具）

一、核心基础配置信息

1. 官方接口地址

兼容协议	Base URL	适用工具
Anthropic兼容（Claude Code/OpenClaw优先）	`https://maas-coding-api.cn-huabei-1.xf-yun.com/anthropic`	Claude Code、OpenClaw
OpenAI兼容（通用IDE/CLI）	`https://maas-coding-api.cn-huabei-1.xf-yun.com/v1`	Cursor、Cline、Kilo Code、OpenCode、Codex CLI、TRAE

2. API Key 获取方式

登录讯飞星辰MaaS平台 https://maas.xfyun.cn
进入「Coding Plan订阅管理」
查看/生成专属订阅API Key（仅Coding Plan套餐可用，与按量付费星火Key不互通）
Key格式：sk-coding-xxxxxx

3. 支持模型列表（Coding Plan专属）

Model ID	模型定位	上下文窗口
`astron-code-latest`	自动调度主力模型（推荐）	1M
`astron-code-pro`	复杂代码/架构推理	1M
`astron-code-flash`	轻量快速代码补全	256k
`glm-5`	智谱通用长文本模型	1M
`deepseek-v3.2`	深度代码推理模型	160k
`minimax-m2.5`	通用编程模型	200k
`kimi-k2.5`	图文代码理解	256k

4. 接口测试示例

Anthropic兼容测试

bash

curl https://maas-coding-api.cn-huabei-1.xf-yun.com/anthropic/v1/messages \
-H "Authorization: Bearer sk-coding-你的订阅Key" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
  "model": "astron-code-latest",
  "max_tokens": 4096,
  "messages": [{"role":"user","content":"写一个Python快速排序"}]
}'

OpenAI兼容测试

bash

curl https://maas-coding-api.cn-huabei-1.xf-yun.com/v1/chat/completions \
-H "Authorization: Bearer sk-coding-你的订阅Key" \
-H "Content-Type: application/json" \
-d '{
  "model": "astron-code-latest",
  "messages": [{"role":"user","content":"写一个Python快速排序"}]
}'

二、终端CLI编程工具配置

1. Claude Code（Anthropic协议）

安装

bash

npm install -g @anthropic-ai/claude-code
claude --version

跳过初始化登录文件

路径：~/.claude.json（macOS/Linux）、C:\Users\用户名\.claude.json（Windows）

json

{
  "hasCompletedOnboarding": true
}

核心配置 settings.json

路径：~/.claude/settings.json

json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://maas-coding-api.cn-huabei-1.xf-yun.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-coding-你的订阅Key",
    "ANTHROPIC_MODEL": "astron-code-latest",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "astron-code-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "astron-code-latest",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "astron-code-pro",
    "CLAUDE_CODE_SUBAGENT_MODEL": "astron-code-latest",
    "API_TIMEOUT_MS": 600000,
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  }
}

使用

bash

cd 项目目录
claude
# 输入 /status 校验接口与模型

2. OpenCode（OpenAI协议）

安装

bash

npm install -g opencode-ai
opencode --version

配置文件

路径：~/.config/opencode/opencode.json

json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "xfyun-coding/astron-code-latest",
  "provider": {
    "xfyun-coding": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "讯飞星辰Coding Plan",
      "options": {
        "baseURL": "https://maas-coding-api.cn-huabei-1.xf-yun.com/v1",
        "apiKey": "sk-coding-你的订阅Key"
      },
      "models": {
        "astron-code-latest": {"limit":{"context":1000000,"output":65536}},
        "astron-code-pro": {"limit":{"context":1000000,"output":65536}},
        "astron-code-flash": {"limit":{"context":262144,"output":32768}}
      }
    }
  }
}

启动切换模型

bash

opencode
/models

3. Codex CLI（OpenAI协议）

安装

bash

npm i -g @openai/codex
codex --version

配置文件 `~/.codex/config.toml`

toml

model = "astron-code-latest"
model_provider = "xfyun-coding"

[model_providers.xfyun-coding]
name = "讯飞星辰Coding Plan"
base_url = "https://maas-coding-api.cn-huabei-1.xf-yun.com/v1"
env_key = "XFYUN_CODING_KEY"
wire_api = "responses"

环境变量

bash

# mac/linux
export XFYUN_CODING_KEY="sk-coding-你的订阅Key"
# windows cmd
set XFYUN_CODING_KEY=sk-coding-你的订阅Key

启动

bash

codex

4. OpenClaw（支持Anthropic协议，推荐）

安装

mac/Linux

bash

curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShell

powershell

iwr -useb https://openclaw.ai/install.ps1 | iex

配置文件 `~/.openclaw/openclaw.json`

json

{
  "models": {
    "mode": "merge",
    "providers": {
      "xfyun-coding": {
        "baseUrl": "https://maas-coding-api.cn-huabei-1.xf-yun.com/anthropic",
        "apiKey": "sk-coding-你的订阅Key",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "astron-code-latest",
            "name": "astron-code-latest",
            "contextWindow": 1000000,
            "input": ["text","image"]
          },
          {
            "id": "astron-code-pro",
            "name": "astron-code-pro",
            "contextWindow": 1000000
          },
          {
            "id": "astron-code-flash",
            "name": "astron-code-flash",
            "contextWindow": 262144
          },
          {
            "id": "glm-5",
            "name": "glm-5",
            "contextWindow": 1000000
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "xfyun-coding/astron-code-latest"
      }
    }
  },
  "gateway": {"mode":"local"}
}

重启网关生效

bash

openclaw gateway restart
# 终端面板
openclaw tui

三、VSCode IDE插件配置

1. Cline

VSCode扩展市场搜索Cline安装
API Provider选择OpenAI Compatible
配置项值
Base URL https://maas-coding-api.cn-huabei-1.xf-yun.com/v1
API Key sk-coding-你的订阅Key
Model ID astron-code-latest

2. Kilo Code

VSCode安装kilo code扩展
设置→自定义供应商
配置项值
API类型 OpenAI Compatible
Base URL https://maas-coding-api.cn-huabei-1.xf-yun.com/v1
API Key 讯飞Coding Plan订阅Key
模型 astron-code-latest

配置项	值
API类型	OpenAI Compatible
Base URL	`https://maas-coding-api.cn-huabei-1.xf-yun.com/v1`
API Key	讯飞Coding Plan订阅Key
模型	`astron-code-latest`

3. Roo Code

安装Roo Code插件
API Provider：OpenAI Compatible
BaseURL填讯飞OpenAI兼容地址，填入订阅Key，模型填astron-code-latest

四、桌面AI编辑器

Cursor（仅Pro及以上支持自定义接口）

打开Cursor → Settings → Models
勾选Override OpenAI Base URL
OpenAI API Key：sk-coding-你的订阅Key
覆盖地址：https://maas-coding-api.cn-huabei-1.xf-yun.com/v1
自定义模型添加：astron-code-latest、astron-code-pro

注意：关闭Override才能使用Cursor官方模型

TRAE

打开TRAE设置 → 模型 → 添加自定义模型
服务商：自定义OpenAI兼容
BaseURL：https://maas-coding-api.cn-huabei-1.xf-yun.com/v1
API Key填入订阅Key，模型选择astron-code-latest

五、通用兼容工具模板（Dify/Cherry Studio等）

适用于所有自定义OpenAI兼容工具

参数	配置值
Base URL	`https://maas-coding-api.cn-huabei-1.xf-yun.com/v1`
API Key	讯飞Coding Plan订阅Key（sk-coding开头）
请求路径	`/chat/completions`
默认模型	`astron-code-latest`

Dify专项配置

模型供应商新增「自定义OpenAI兼容」
API Base填写讯飞Coding Plan OpenAI地址
填入订阅Key，绑定astron-code-latest、glm-5等模型

六、CC Switch 一键可视化配置

安装CC Switch（mac：brew install --cask cc-switch / Windows下载安装包）
打开软件右上角+新增供应商，预设选择「讯飞星辰Coding Plan」
粘贴sk-coding-xxx订阅Key
默认模型设置astron-code-latest，保存后一键同步所有本地工具配置

七、套餐关键注意事项

密钥区分
- Coding Plan订阅Key：sk-coding-xxxx，仅订阅套餐抵扣额度普通星火按量API Key不可混用，混用直接鉴权失败
协议区分 Claude Code/OpenClaw优先使用Anthropic地址；绝大多数IDE插件仅支持OpenAI /v1地址
额度规则 Coding Plan按月订阅，内置滚动5小时请求限额，支持自动超额后付费，无需修改配置切换
模型调度astron-code-latest为自动路由模型，平台根据任务复杂度自动分配最优模型，无需手动切换
网络说明 接口域名仅国内华北1可用，海外环境需配置国内代理
禁止场景 订阅套餐仅支持交互式编程Agent工具，禁止批量后端API调用，违规会冻结订阅Key

讯飞星辰 Astron Coding Plan 开源AI工具配置文档 ​

一、核心基础配置信息 ​

1. 官方接口地址 ​

2. API Key 获取方式 ​

3. 支持模型列表（Coding Plan专属） ​

4. 接口测试示例 ​

Anthropic兼容测试 ​

OpenAI兼容测试 ​

二、终端CLI编程工具配置 ​

1. Claude Code（Anthropic协议） ​

安装 ​

跳过初始化登录文件 ​

核心配置 settings.json ​

使用 ​

2. OpenCode（OpenAI协议） ​

安装 ​

配置文件 ​

启动切换模型 ​

3. Codex CLI（OpenAI协议） ​

安装 ​

配置文件 ~/.codex/config.toml ​

环境变量 ​

启动 ​

4. OpenClaw（支持Anthropic协议，推荐） ​

安装 ​

配置文件 ~/.openclaw/openclaw.json ​

重启网关生效 ​

三、VSCode IDE插件配置 ​

1. Cline ​

2. Kilo Code ​

3. Roo Code ​

四、桌面AI编辑器 ​

Cursor（仅Pro及以上支持自定义接口） ​

TRAE ​

五、通用兼容工具模板（Dify/Cherry Studio等） ​

Dify专项配置 ​

六、CC Switch 一键可视化配置 ​

七、套餐关键注意事项 ​

关于本站

讯飞星辰 Astron Coding Plan 开源AI工具配置文档

一、核心基础配置信息

1. 官方接口地址

2. API Key 获取方式

3. 支持模型列表（Coding Plan专属）

4. 接口测试示例

Anthropic兼容测试

OpenAI兼容测试

二、终端CLI编程工具配置

1. Claude Code（Anthropic协议）

安装

跳过初始化登录文件

核心配置 settings.json

使用

2. OpenCode（OpenAI协议）

安装

配置文件

启动切换模型

3. Codex CLI（OpenAI协议）

安装

配置文件 `~/.codex/config.toml`

环境变量

启动

4. OpenClaw（支持Anthropic协议，推荐）

安装

配置文件 `~/.openclaw/openclaw.json`

重启网关生效

三、VSCode IDE插件配置

1. Cline

2. Kilo Code

3. Roo Code

四、桌面AI编辑器

Cursor（仅Pro及以上支持自定义接口）

TRAE

五、通用兼容工具模板（Dify/Cherry Studio等）

Dify专项配置

六、CC Switch 一键可视化配置

七、套餐关键注意事项