models.json 接入 OpenAI / Anthropic / Google 兼容端点，例如 Ollama、vLLM 和 LM Studio。
接入方式
凭据优先级为：命令行
--api-key、已保存的 auth.json、环境变量、models.json 自定义平台的密钥。auth.json 权限为 0600，文件凭据优先于环境变量。
订阅登录
/logout 清除相应凭据。
选择错误通道不会因为已有订阅而自动改用订阅额度。可用模型和额度取决于账户权限，套餐规则见 Step Plan。
登录选择器还提供 Claude Pro/Max、ChatGPT Plus/Pro（Codex）、GitHub Copilot 和 xAI 等平台；请遵守各平台的使用条款和账户权限。
API Key 供应商
例如，在 Bash 或 Zsh 中配置 Anthropic：
/login 保存的密钥位于 ~/.stepcode/auth.json，请勿提交到代码仓库。
云平台
云平台的模型部署名、可用区域和 IAM 权限由该平台管理。请先确认账户可调用目标模型，再在 Step Code 中选择。
自定义模型（models.json）
编辑~/.stepcode/models.json，重新打开 /model 加载变更。以下示例接入本地 Ollama：
ollama 是本地服务的非空占位值；远程鉴权服务必须填写其实际凭据。
模型字段包括
id、name、reasoning、contextWindow、maxTokens、cost、thinkingLevelMap 和 samplingParams。id 必填，contextWindow 默认 128,000，maxTokens 默认 16,384；可按模型规格覆盖。
samplingParams 用于 OpenAI 兼容请求的采样参数合并，可能覆盖同名请求字段。不要添加服务端不支持的字段。仅覆盖 baseUrl 可以修改内置平台端点，提供 models 则按模型 ID 更新或添加。
Ollama 等本地无鉴权服务也需要占位 apiKey，否则模型不会出现在 /model。Ollama / vLLM / SGLang 常需在 compat 中设置 supportsDeveloperRole = false 和 supportsReasoningEffort = false。
切换模型
/model打开模型选择器，Ctrl+S 保存为启动默认。- Ctrl+P 在
enabledModels中循环选择，反向快捷键见键盘快捷键。 - 命令行使用
step --provider <平台> --model <模型 ID>。 /thinking或/effort调整思考级别；可选级别和执行档位由模型决定。