文档 · 供应商

阶跃星辰 Step Plan 接入 Claude Code 和 Codex

阶跃星辰有两个站点：国内站 platform.stepfun.com 和国际站 platform.stepfun.ai，账号各自独立。两边都有 Step Plan 和按量付费，Step Plan 走自己的 step_plan 接口，它的 Key 在按量付费的接口上会被拒。在 magpie 里添加对应站点的供应商、给 Key 选好套餐，Claude Code、Codex、Gemini CLI、OpenCode 就都能通过本地网关 127.0.0.1:3425 用上 Step 模型。

添加阶跃星辰

添加供应商并选套餐在供应商页点＋添加供应商，选 StepFun (China) 或 StepFun，给 Key 选 Step Plan或Pay as you go，粘贴 Key 并保存。
给工具选上在 Agent 页给某个工具选 step-5-preview 这类模型。

国内站的账号选 StepFun (China)（供应商 id stepfun-cn），国际站的选 StepFun（stepfun）。

终端

magpie claude stepfun-cn/step-5-preview
magpie codex stepfun-cn/step-3.7-flash
magpie opencode stepfun/step-5-preview

站点、套餐与接口地址

站点与套餐	Chat Completions	Anthropic Messages
国内站 · Step Plan	`https://api.stepfun.com/step_plan/v1`	`https://api.stepfun.com/step_plan`
国内站 · 按量付费	`https://api.stepfun.com/v1`	`https://api.stepfun.com`
国际站 · Step Plan	`https://api.stepfun.ai/step_plan/v1`	`https://api.stepfun.ai/step_plan`
国际站 · 按量付费	`https://api.stepfun.ai/v1`	`https://api.stepfun.ai`

Step Plan 的 Key 只认 step_plan 下的地址，发到按量付费的地址会被拒，所以 magpie 按 Key 选的套餐发请求。供应商里的每个 Key 都标明自己的套餐，同一站点的 Step Plan 和按量付费 Key 可以放在一个供应商里。阶跃两种接口都不提供 Responses。

模型

Step Plan 目录里的对话模型是 step-5-preview、step-3.7-flash、step-3.5-flash 和 step-3.5-flash-2603；国内站的 Step Plan 还有 step-router-v1。按量付费另有语音模型 stepaudio-2.5-asr、stepaudio-2.5-tts 和 step-tts-2。

余额与 Step Plan 额度

余额：magpie 用 API Key 读 /v1/accounts，国内站显示人民币，国际站显示美元。
Step Plan 额度：5 小时窗口、每周窗口和当月积分只告诉阶跃开放平台上的登录，不告诉 Key。你在自己的浏览器里登录开放平台，在那个页面运行 magpie 提供的书签，把它复制出来的内容粘贴进 magpie。之后 magpie 自己续期登录并读取额度；登录保存在 providers.json 旁边的 stepfun-auth.json，只有你自己能读。同一站点的两个供应商可以是两个账号，各看各的额度。

在各个工具里用

Claude Code 说的是 Anthropic Messages。阶跃两个站点都有 Anthropic 接口，请求原样转过去。见 Claude Code 接入国产模型。
Codex 只说 OpenAI Responses。阶跃不提供 Responses，magpie 把 Codex 的请求转换成 Chat Completions，apply_patch 这类自定义工具也照常能用。模型会出现在 Codex 的 /model 里。见 Codex 接入第三方模型。
Gemini CLI 说 Gemini 的 API，magpie 把它指向本地网关并做转换。见 Gemini CLI 接入其他模型。
OpenCode：magpie 把模型写进 opencode.json。见 OpenCode 接入其他模型。

常见问题

阶跃星辰 Step Plan 怎么接入 Claude Code？

在 magpie 里添加 StepFun (China) 或 StepFun，把 Key 的套餐选成 Step Plan，然后在 Claude Code 那一行选 step-5-preview，或运行 magpie claude stepfun-cn/step-5-preview。请求走 https://api.stepfun.com/step_plan（国际站是 api.stepfun.ai）。

Step Plan 的 Key 为什么在 api.stepfun.com/v1 上报错？

Step Plan 的 Key 只能用在 step_plan 下的地址，按量付费的 /v1 会拒绝它。在 magpie 里把 Key 的套餐选成 Step Plan，请求就会发到 /step_plan/v1。

阶跃星辰能在 Codex 里用吗？

能。阶跃没有 Responses 接口，magpie 把 Codex 的请求转换成 Chat Completions。运行 magpie codex stepfun-cn/step-3.7-flash。

在 magpie 里能看到 Step Plan 的 5 小时和每周额度吗？

能，但要先把开放平台的登录带进 magpie：在浏览器里登录 platform.stepfun.com 或 .ai，运行 magpie 的书签，再把复制的内容粘贴进 magpie。余额只用 Key 就能看到。

同一套方法用在其他国产模型：小米 MiMo、华为云 MaaS、MiniMax、GLM 编程套餐、Kimi、DeepSeek、通义千问。遇到报错？见常见错误排查，或到 Discord 提问。