接入条件
- macOS、Linux 或 Windows，已安装 Node.js 22.19 或更高版本及 npm。
- Step Plan 订阅有效、额度可用，且具备所用模型的调用权限。
- 已在 StepFun 开放平台密钥管理页面创建 API Key。
v22.19.0 或更高，且 npm 能正常输出版本号，可直接继续安装 Pi。
安装 Pi
安装 Pi 0.87.1：配置 Step Plan
设置 API Key
在启动 Pi 的终端中设置环境变量，将YOUR_STEP_API_KEY 替换为实际密钥：
- macOS / Linux / WSL
- Windows PowerShell
添加模型
- 打开
~/.pi/agent/models.json。如果设置了PI_CODING_AGENT_DIR时，请使用该目录下的models.json。 - 将以下
providers.stepfun配置合并到文件中，保留其他 Provider。文件不存在时创建目录并保存以下 JSON。
Step 5 Preview 的上下文窗口为 1M tokens，Step 3.7 Flash 为 256K tokens。上述配置分别使用
1000000 和 256000。
设置默认模型
将以下字段合并到同一配置目录中的settings.json：
启动 Pi
在项目目录的终端中执行：验证接入
检查模型配置
status 应为 ready，表示客户端能够解析凭据。模型列表应包含配置的模型 ID，Step 5 Preview 的上下文显示为 1M，Step 3.7 Flash 显示为 256K。
验证对话
OK。
验证工具调用
在安装了 Python 的独立测试目录中创建README.md，内容为 Pi Step Plan test。从该目录启动 Pi，输入：
hello.py，运行输出为 Hello, StepFun!。
核对用量
在 StepFun 开放平台的使用详情中，按请求时间核对模型 ID 和计费来源，确认调用使用 Step Plan。常见问题
Q: 模型列表中没有 Step 模型怎么办？
Q: 模型列表中没有 Step 模型怎么办？
检查生效目录中的
models.json 是否为有效 JSON，以及 providers.stepfun.models 中的模型 ID。打开 /model 重新加载配置，或重启 Pi 后运行 pi --list-models stepfun。Q: 无法解析 API Key 或认证失败怎么办？
Q: 无法解析 API Key 或认证失败怎么办？
在启动 Pi 的同一终端中设置
STEP_API_KEY，检查密钥是否完整、有效，且属于所用端点对应的账号。若 auth.json 中已保存 stepfun 凭据，Pi 会优先使用该凭据，应一并核对其内容。Q: 请求路径错误怎么办？
Q: 请求路径错误怎么办？
api 使用 anthropic-messages，baseUrl 填写 https://api.stepfun.com/step_plan。Pi 自动追加 /v1/messages，配置地址只保留到 /step_plan。Q: 上下文窗口显示与模型规格不一致怎么办？
Q: 上下文窗口显示与模型规格不一致怎么办？
检查对应模型的
contextWindow：step-5-preview 使用 1000000，step-3.7-flash 使用 256000。保存后重新加载模型列表并选择该模型。