Prerequisites
- A Step Plan account or Step API key, and network access to the model service.
- A project containing a
README.mdthat you are authorized to share with the selected model service.
Installation
The commands execute a remote script. Verify the source first. To pin a version or uninstall, see Updates.
- macOS / Linux
- Windows PowerShell
step --version. Confirm that it prints the installed version.
First launch
Open your project, replacing the example path with its actual location:Login
- Enter
/loginin the interactive input box. - Select the Step sign-in option for your account and billing channel. Choose Step Plan for a subscription on
platform.stepfun.com, or Step Plan Oversea for one onplatform.stepfun.ai, and authorize in the browser. For API keys, choose the Step account option that matches the key. - Run
/modeland select a model available to the account.
step login --no-browser to get an authorization link, then complete sign-in in a browser on this or another device. The command still requires an interactive terminal and does not depend on a local callback port.
Subscription and pay-as-you-go requests use separate channels. See Authentication and models for endpoints, sign-in details, and other providers.
Check permissions
New interactive sessions without a configured permission mode default to Approve for Me: routine operations run automatically, while detected dangerous or unanalyzable commands still require confirmation. When you want confirmation before file changes and commands, run/permissions and choose Ask. Permission modes are not an OS sandbox; run Step Code only in directories you trust. See Permissions and safety for mode behavior and project access boundaries.
Your first conversation
ReferenceREADME.md in the input box and send a task:
Check the result
Compare the answer with the README. Confirm that it identifies documented commands rather than inventing missing setup steps, and inspect tool activity for actions outside the task. In a Git project, usegit diff to inspect file changes.
Use /quit to exit. To continue the same task later, see Sessions and context.
Next steps
- Project instructions: record team conventions and verification requirements.
- Interaction and task control: reference images, plan work, and manage goals or scheduled tasks.
- Slash commands and Keyboard shortcuts: look up available operations.
- Data paths: locate, back up, or clean up credentials, settings, and sessions.
- Updates: update the program, select a release, or uninstall. See Release notes for version changes.

