step 命令

在终端中使用 step 启动会话，或通过子命令管理安装、资源包和 MCP。

step [选项] [--] [@文件...] [任务描述...]

查看当前版本提供的参数：

step --help
step --version

模型参数

参数	说明
`--provider <名称>`	平台名称，如 `step`、`anthropic`、`openai`
`--model <模型>`	模型 ID 或匹配模式，支持 `provider/id` 和思考级别后缀
`--api-key <密钥>`	覆盖其他凭据来源；注意 Shell 历史和进程参数暴露风险
`--thinking <级别>`	`off`、`minimal`、`low`、`medium`、`high`、`xhigh`、`max`，需模型支持
`--models <列表>`	Ctrl+P 循环模型列表，逗号分隔
`--list-models [搜索词]`	列出可用模型

step --provider step --model step-3.7-flash
step --list-models flash

step --name "接口审查" @README.md "梳理接口约定"
step -p @screenshot.png "解释这张截图中的错误"
step --no-session -p "解释语义化版本号"

例如，限制工具范围为文件读取与搜索：

step --tools read,grep,find,ls -p "检查 README 与项目结构是否一致，不修改文件"

权限与危险操作说明见交互与输入。

参数	说明
`-e <来源>`、`--extension <来源>`	临时加载扩展，可重复
`--skill <路径>`	显式加载 Skill，可重复
`--prompt-template <路径>`	加载 prompt 模板，可重复
`--theme <路径>`	加载主题资源，可重复
`--no-extensions`、`--no-skills`、`--no-prompt-templates`、`--no-themes`	关闭对应资源的自动发现
`--no-context-files`、`-nc`	不自动加载项目指引

显式指定的资源可与关闭自动发现的选项配合使用；它们仍需来自可信来源。

命令	说明
`step update`	更新到最新稳定版，别名 `step upgrade`
`step update <版本号>`	安装指定版本，例如 `step update 0.4.0`
`step update --all`	更新 Step 与全部包
`step update --extensions`	仅更新包
`step install <来源>`	安装资源包
`step remove <来源>`	移除资源包
`step list`	列出资源包
`step config`	可视化管理资源，Tab 切换全局与项目范围
`step mcp`	MCP 的 `list`、`get`、`add`、`remove`、`login`、`logout`
`step login`、`step logout`	Step 账号登录或退出
`step login status`	查看 Step 登录方式和状态

更新流程包括下载、checksum 校验、冒烟测试和失败回滚。指定版本示例中的 0.4.0 请替换为所需的发行版本。包来源和版本锁定规则见插件。