@phaseo/cli 并运行 phaseo login,即可把编程智能体连接到 Phaseo,并在终端中管理密钥、工作区、预设、设置和护栏。CLI 还可以读取模型、提供商、价格、额度、活动、分析数据和生成记录。
安装
有新版本发布时,交互式运行也会显示提示。
登录
远程和非交互式环境会自动使用设备码。查看你当前登录的身份,以及你的权限范围、当前工作区和其他工作区:
管理工作区
--json。CLI 涵盖日常账户任务;密钥限额、预算、BYOK、路由规则、预设和身份的更改需要在控制台中或使用管理密钥完成。CLI 涵盖哪些任务,请参阅通过智能体管理 Phaseo。
连接编程智能体
用智能体的名称作为命令。CLI 会请求一个专用密钥,由你在浏览器中批准,然后写入该智能体的配置:--model、--catalog all|default 或 --dry-run。phaseo setup <agent> 和 phaseo integrations setup <agent> 也可以使用。
在浏览器中批准密钥
首次设置某个智能体时,CLI 会打开一个 Phaseo 控制台页面并输出其链接。该页面显示工作区、密钥名称、每月 $100 的支出上限和 90 天的有效期,以及请求来自 Phaseo CLI。选择 批准并创建密钥 后,CLI 会取回一次密钥并完成设置。选择 拒绝,或请求在 10 分钟后过期,则不会创建任何内容。 批准时,请使用你在 CLI 中使用的账户登录控制台,以工作区所有者或管理员身份操作;如果设置了第二验证因素,也需要完成验证。通过 SSH 或在 CI 中时,在任何已登录的设备上打开输出的链接即可。 如果要改用你在控制台中创建的密钥,请通过--key <key> 传入,或使用 --key-stdin,避免密钥留在 shell 历史中。CLI 会检查并保存该密钥,移除智能体时不会吊销它。
要用临时设置运行 Cline、Kilo Code、oh-my-pi、Muse Code 或 MiniMax Code(这些设置会在退出时删除),请使用会话运行器。Phaseo 参数放在 -- 之前,智能体自己的参数放在之后:
phaseo run <cline|kilo|omp|muse|minimax> 是完整形式。加上 --catalog all 可以列出所有活跃的 Phaseo 文本模型,加上 --dry-run --json 可以在不创建密钥的情况下预览。在交互式终端中,运行器会提示你安装缺失的智能体(在 Windows 上,MiniMax Code 使用其官方 PowerShell 安装程序;Muse Code 必须手动安装)。如果你自己管理智能体,请使用 --skip-install。
编程智能体列出了每个智能体、其命令的作用及其指南。
用 CLI 编写脚本
带--json 的命令会输出纯结构化内容,没有颜色或加载动画。其他情况下,加载动画输出到 stderr,完成后会清除所在行。
CLI 如何保护凭据安全
- 会话保存在操作系统凭据存储中。只有在没有可用的凭据存储时才设置
PHASEO_SESSION_BACKEND=file;它会把刷新令牌保存在一个权限受限的明文文件中。 phaseo logout会先吊销已存储的刷新令牌,再清除本地状态。- 管理密钥需要显式授予能力。推理密钥受护栏、路由策略和工作区设置限制,而不是由权限范围限制。
OAuth 应用
Phaseo 为 CLI、用户创建的应用和动态注册的 MCP 客户端使用同一个 OAuth 授权服务器。CLI 使用浏览器或设备登录,并采用轮换的刷新令牌。第三方客户端使用带 PKCE 的授权码流程、显式权限范围和工作区授权同意,以及可选的受保护资源绑定。它们会获得一个有效期为 7 天、可吊销的访问令牌,以及一个自上次使用起 90 天内有效的轮换刷新令牌;刷新的工作方式请参阅构建 OAuth Next.js 工作台。再次批准同一个应用会续期其密钥,而不是再添加一个。 托管的 Phaseo API 已开启第三方 OAuth。自托管和预览 API 部署默认关闭它,除非PHASEO_THIRD_PARTY_OAUTH_ENABLED 为真值:1、true、yes 或 on,不区分大小写,并忽略首尾空格。
.env