認証と API キー

Subaya は同じ API に対して 2 つの認証モードをサポートしています。

API キー — SUBAYA_API_KEY（エージェントと CI）

最もシンプルな方法であり、AI エージェントと CI パイプラインに使うべきものです。環境変数を 設定すれば、すべての suya コマンド（とプラットフォーム API）がそれを拾います:

export SUBAYA_API_KEY="sk_..."
suya auth whoami      # confirm the identity the key resolves to

ブラウザもインタラクティブなステップもなし — ヘッドレス環境に理想的です。キーの発行と 管理はコンソールから行います。

OAuth ブラウザログイン（人間）

ワークステーションでのインタラクティブな利用向け:

suya auth login                 # opens a browser (loopback redirect)
suya auth login --no-browser    # manual-code fallback for remote/headless shells

CLI は結果として得られたトークンをローカル（~/.config/suya/ の下）に保存します。確認または消去します:

suya auth status    # local status, without calling the server
suya auth logout    # log out and revoke the local token

優先順位

複数の認証情報が存在する場合、suya は次の順序で解決します:

1. --token グローバルフラグ
2. SUBAYA_API_KEY
3. ローカルに保存された OAuth トークン（~/.config/suya/auth.json）

別のホストを指定する

デフォルト以外の API エンドポイントをターゲットにする必要がある場合、すべてのコマンドは --host（デフォルト https://subaya-dev.com）を受け付けます。

次のステップ

• クイックスタート — 最初のシミュレーションを実行します。
• CLI: auth — suya auth の完全なリファレンス。