说白了就是:团队里产品、研发、测试各用各的账号,怎么才能快速切换、互不干扰,还不丢上下文、不搞乱API配额?这事儿的关键不在于技术有多复杂,而在于身份管理和隔离机制是否到位。下面这套配置流程,就是专门解决这个问题的——从账号创建、权限分配,到桌面端和网页端的切换方案,再到API层的静默切换,一步步讲清楚。

创建并绑定团队子账号
这里有个前提:主管理员必须先为每位成员创建独立子账号,否则后续的权限分配和切换都无从谈起。这一步必须手动完成,不能指望成员自己注册了事。
操作路径是这样的:登录主账号 → 点击左上角头像 → 进入【团队中心】→ 点击【新增成员】→ 填写姓名、邮箱(注意:该邮箱必须未注册过任何阶跃AI账号)、手机号 → 点击发送邀请。系统会自动给邮箱发一封带激活链接的邮件;成员点击链接后,强制完成密码设置和信息二次验证,账号就算创建成功了——但此时它还是“待授权”状态,什么都没法干。
分配角色与细粒度权限
阶跃AI没有那种通用角色模板,所有权限都必须按实际职责逐项勾选,这一点要特别留意。权限设宽了,数据越界;设窄了,工作卡住。核心在于:权限必须按实际职责逐项勾选。
有两种操作方法:
方法一:批量设基础角色
进入【团队中心】→ 勾选2名以上成员 → 点击右上角【统一分配角色】→ 从“仅查看报告”“可编辑提示词”“可管理模型版本”这三类内置权限集中选一个 → 确认提交。适合对新成员做快速初始授权。
方法二:自定义权限(推荐用于核心成员)
点击单个成员右侧的【权限详情】→ 展开【API调用】面板 → 勾选或取消具体模型的调用权限,比如“允许调用step-1.5-pro”但“禁止调用step-vision-2026”;再展开【知识库】面板 → 设置“仅可读取‘产品需求库’”“不可导出‘客户反馈库’原始文本”。需要提醒的是:保存后立即生效,没有撤回按钮,操作前务必确认。
桌面端一键切换子账号
Windows或macOS的桌面客户端支持真正的多开和账号热切换——不退出、不中断当前会话,适合需要频繁跨角色操作的PM或技术负责人。这才是最丝滑的方案。
具体步骤:
第一步:确保桌面客户端版本在v2.4.7及以上(旧版不支持子账号沙箱)。
第二步:打开客户端 → 右上角头像 → 【切换身份】→ 在弹出列表里点击目标成员的邮箱。
第三步:输入该子账号绑定的6位数字PIN码(注意,这不是登录密码)→ 页面顶部会实时显示身份标签,比如“李婷|测试组|权限组T-2026Q3”。
第四步:之后的所有操作——新建对话、上传文件、导出JSON日志——都会以该子账号身份执行,API请求头会自动带上X-Step-Subaccount-ID字段。
网页端隔离式多账号并行方案
原谅我说得直接一点:网页端不支持账号切换。强行退出再登录,WebSocket会断连,历史会话ID会失效,前端缓存token也会残留,结果就是一堆麻烦。所以必须用浏览器环境隔离的办法。
Chrome多用户模式(最稳的方案):
打开Chrome → 右上角头像 → 【管理用户】→ 【添加用户】→ 命名为“阶跃_产品”→ 新窗口访问 https://step.ai → 完成手机号验证码登录 → 左下角出现绿色“已连接”标识就对了。重复这个流程,为“研发”“测试”各建一个独立用户。切记:每个用户只登录一个阶跃AI账号,严禁混用。
Edge侧边栏多开(轻量替代):
启动Edge → 按Ctrl+Shift+P打开命令面板 → 输入“New InPrivate Window”回车 → 地址栏输入 https://step.ai → 登录 → 用完关掉侧边栏窗口即可。不过要提个醒:这种方式不隔离IndexedDB,如果需要长期使用,还是优先选Chrome的多用户模式。
API层静默切换(适用于自动化脚本)
如果你的CI/CD流水线或内部工具需要调用阶跃AI API,那就应该避开浏览器会话,纯靠Header驱动身份切换——避免Cookie污染和IP频控误伤,也能保证调用稳定。
方法一:Header注入
在HTTP请求头里添加 X-Step-Auth-Type: subaccount 和 X-Step-Subaccount-ID: usr_abc123def456(这个ID在【团队中心】→ 成员详情页可以复制)→ 后端服务会自动识别并路由到对应子账号上下文,不需要传Bearer Token。
方法二:密钥池路由
为每个子账号生成独立的API Key(路径:【个人设置】→ 【API密钥】→ 【创建新密钥】→ 绑定子账号ID)→ 把Key写入密钥管理服务 → 脚本调用时通过环境变量 STEP_SUBACCOUNT_KEY=sk_prod_xxx 指定调用身份 → 阶跃AI网关会自动匹配归属关系。
