准备条件
- 可用的 Step Plan 账号或阶跃 API Key，以及访问模型服务的网络连接。
- 一个可供分析、包含
README.md的项目目录；请确认该文件可发送给所选模型服务。
安装
安装命令会执行远程脚本。请先确认来源可信；指定安装版本或卸载时，见升级。
- macOS / Linux
- Windows PowerShell
step --version，确认输出版本号。
StepPage 自动准备需要外部 Node.js 20 或更新版本；这不是 Step Code 独立程序本身的依赖。准备失败可运行 step mcp prepare 后重启检查。原生 Windows 暂不自动安装，可使用 WSL 或自行准备。该命令是内置资源准备入口，不是所有第三方 MCP 的通用修复命令。
首次启动
进入准备好的项目目录，将示例路径替换为实际路径：登录
- 在交互输入框中运行
/login。 - 按账号所在地区和计费方式选择阶跃登录入口。国内 Step Plan 订阅选择 Step Plan，海外订阅选择 Step Plan Oversea，并在浏览器完成授权；使用 API Key 时，选择与该 Key 对应的阶跃账号入口。
- 运行
/model，选择账号可用的模型。
step login --no-browser 获取授权链接，在本机或其他设备的浏览器中完成登录。该命令仍要求交互终端，不依赖本地回调端口。
订阅与按量付费使用不同通道。完整登录说明、端点和其他供应商的接入方式见登录与模型。
确认权限
未配置权限的新交互会话默认使用 Approve for Me：常规操作自动执行，检测到危险或无法完整分析的命令时仍需确认。需要在修改文件和运行命令前逐项确认时，运行/permissions 并选择 Ask。权限模式不是系统沙箱，只在可信目录中运行。各模式行为与项目访问边界见权限与安全。
第一个对话
在交互输入框中引用README.md 并发送任务：
检查结果
确认回答以 README 的实际内容为依据，未补写文件中不存在的启动方式或测试命令，并检查工具记录中是否有超出任务范围的操作。在 Git 项目中，可通过git diff 检查文件改动。
使用 /quit 退出。需要继续同一任务时，按会话与上下文恢复会话。