本文介绍如何为 Claude Code、Codex、OpenClaw 和 Hermes 配置 星辰MaaS提供的模型,以下以Spark X2.5为例。
| 配置项 | 值 |
|---|---|
| APIKEY | 点击API调用/APIKEY管理处获取 |
| 模型 ID | spark-x2.5 |
本节中的 model、ANTHROPIC_MODEL 等是各 Agent 固定的客户端配置项名称,应按客户端要求保留;它们与接口请求体中的 model_id 字段不是同一层级的配置。
1 接入方式
| Agent | 使用协议 | Base URL | 模型 ID | 状态 |
|---|---|---|---|---|
| Claude Code | Anthropic Messages | https://maas-api.cn-huabei-1.xf-yun.com/anthropic | spark-x2.5 | 可接入 |
| Codex | Responses API | https://maas-api.cn-huabei-1.xf-yun.com/v1 | spark-x2.5 | 可接入 |
| OpenClaw | Chat Completions | https://maas-api.cn-huabei-1.xf-yun.com/v2 | spark-x2.5 | 可接入 |
| Hermes | Chat Completions | https://maas-api.cn-huabei-1.xf-yun.com/v2 | spark-x2.5 | 可接入 |
2 地址选择原则
Claude Code(Anthropic):
https://maas-api.cn-huabei-1.xf-yun.com/anthropic— 客户端自动追加/v1/messages。Codex(Responses):
https://maas-api.cn-huabei-1.xf-yun.com/v1— Codex 自动请求/responses。OpenClaw / Hermes(OpenAI):
https://maas-api.cn-huabei-1.xf-yun.com/v2— 客户端请求/chat/completions。