@phaseo/cli をインストールして phaseo login を実行すると、コーディングエージェントを Phaseo に接続し、キー、ワークスペース、プリセット、設定、ガードレールをターミナルから管理できます。CLI では、モデル、プロバイダー、料金、クレジット、アクティビティ、分析、生成の情報も参照できます。
インストール
対話型の実行では、新しいバージョンが公開されたときにヒントも表示されます。
サインインする
リモート環境と非対話型の環境では、自動的にデバイスコードが使われます。サインインしているユーザーを、スコープ、有効なワークスペース、その他のワークスペースとともに確認します。
ワークスペースを管理する
--json を使います。CLI は日常的なアカウント作業に対応しています。キーの上限、予算、BYOK、ルーティングルール、プリセット、ID の変更は、ダッシュボードまたは管理キーで行います。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 で使ったアカウントでダッシュボードにサインインし、ワークスペースのオーナーまたは管理者として承認してください。2 要素認証を設定している場合は、その確認も必要です。SSH や CI では、表示されたリンクをサインイン済みの任意のデバイスで開いてください。 代わりにダッシュボードで作成したキーを使うには、--key <key> で渡します。シェルの履歴に残したくない場合は --key-stdin を使います。CLI はキーを確認して保存しますが、エージェントを削除してもそのキーは取り消しません。
終了時に削除される一時的な設定で Cline、Kilo Code、oh-my-pi、Muse Code、MiniMax Code を実行するには、セッションランナーを使います。Phaseo のフラグは -- の前に、エージェント自体のフラグは -- の後に指定します。
phaseo run <cline|kilo|omp|muse|minimax> は完全な形式です。Phaseo の有効なテキストモデルをすべて表示するには --catalog all を、キーを作成せずにプレビューするには --dry-run --json を付けます。対話型ターミナルでは、ランナーはインストールされていないエージェントのインストールを提案します(Windows では、MiniMax Code は公式の PowerShell インストーラーを使い、Muse Code は手動でインストールする必要があります)。エージェントを自分で管理している場合は --skip-install を使います。
すべてのエージェント、各コマンドの動作、ガイドの一覧はコーディングエージェントにあります。
CLI でスクリプトを書く
--json を付けたコマンドは、色やスピナーのないプレーンな構造化出力を表示します。それ以外の場合、スピナーは stderr に出力され、完了すると行が消去されます。
CLI が資格情報を安全に保つ仕組み
- セッションは OS の資格情報ストアに保存されます。
PHASEO_SESSION_BACKEND=fileは、資格情報ストアが使えない場合にのみ設定してください。この設定では、リフレッシュトークンがアクセス権を制限した平文のファイルに保存されます。 phaseo logoutは、ローカルの状態を消去する前に、保存されたリフレッシュトークンを失効させます。- 管理用キーには明示的な権限が必要です。推論用のキーは、スコープではなく、ガードレール、ルーティングポリシー、ワークスペースの設定によって制限されます。
OAuth アプリ
Phaseo は、CLI、ユーザーが作成したアプリ、動的に登録された MCP クライアントで 1 つの OAuth 認可サーバーを使います。CLI は、ローテーションするリフレッシュトークンとともに、ブラウザーまたはデバイスによるログインを使います。サードパーティのクライアントは、PKCE 付きの認可コード、明示的なスコープとワークスペースの同意、任意の保護リソースのバインディングを使います。クライアントには、7 日間有効な失効可能なアクセストークンと、最後の使用から 90 日間有効なローテーションするリフレッシュトークンが発行されます。リフレッシュの仕組みについては、OAuth Next.js ワークベンチを構築するを参照してください。同じアプリを再度承認すると、2 つ目のキーが追加されるのではなく、既存のキーが更新されます。 ホストされている Phaseo API では、サードパーティの OAuth がオンになっています。セルフホストおよびプレビューの API デプロイでは、PHASEO_THIRD_PARTY_OAUTH_ENABLED が真の値(1、true、yes、on。大文字と小文字は区別せず、前後の空白は無視)でない限りオフのままです。
.env