跳转到主要内容
安装 @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
开启后会公开用户创建的 OAuth 应用管理和动态客户端注册,所以请先检查你的重定向 URI、授权同意、客户端密钥、速率限制和工作区授权设置。

更新

此命令会用你安装 CLI 时使用的包管理器执行更新。要手动更新:
最后修改于 2026年11月9日