アカウント、キー、プラン、課金

このページはアカウント側で最もよくある質問に答えます。「操作」が必要なことはすべてコンソールで行います。CLI はこのマシンへのログインと状態の確認だけを担います。

ログインとアカウント

コンソールはどのログイン方法をサポートしている？ メールの確認コード、携帯電話の SMS 確認コード、WeChat。組織はメンバーのログイン用に SSO の ID プロバイダーを別途設定できます。CLI 自体はログインを行わず、コンソールで作成した個人アクセストークン（PAT）で初期化を完了します。

アカウントにメールアドレスを紐付けると何ができる？ プラットフォームは 4 種類のメールを送信します：承認の待ち項目と結果、組織への招待、残高がしきい値を下回った警告（同じアカウントで 1 日最多 1 通）、新しいアプリキー作成の通知（派生経路を含み、キーの平文は決して含まない）。メールアドレスが未設定なら黙ってスキップし、機能には影響しません。

1 人で複数の組織に所属できる？ できます。個人アカウントは組織を作成または参加でき、組織にはメンバー、招待、チーム、ガバナンスポリシーがあります。プランはアカウント（個人または組織）に紐付きます。

アカウントを削除するには？ コンソールにアカウント匿名化のフローがあります（まずチャレンジによる確認を開始し、その後に実行）。削除前に、使い切っていない残高と未決済の請求書を先に処理してください。

個人アクセストークン（PAT）とデバイスキー

PAT はどこで作成し、どう使う？ コンソールの「API キー」ページで作成します。一度しか表示されないので、すぐにコピーしてください。用途は 1 つだけ：tansr init でこのマシンの CLI にログインすること（マスク入力、または CI では TANSR_PAT 環境変数）。PAT はあなた本人を表します。

tansr init の後に何が起きた？ ウィザードが PAT を検証 → このデバイス用にアプリキーを 1 つ派生（cli:<ホスト名>:<デバイス id> と命名）→ OS のキーチェーンに書き込み → サマリーカードを表示（アカウント指紋、残高、最近の使用量、利用可能なモデル数、派生キーの有効期限）。その後は tansr をそのまま使え、モデル一覧と料金表はプラットフォームから配信されます。

PAT を失った / 漏洩の疑いがある。 コンソールでその PAT を削除または無効化し（復元可能と永久削除の 2 段階）、新しく作成して、各デバイスで tansr init --fresh により再ログインします。

デバイスキーは期限切れになる？ なります。期限が近づくとセッション内に「キーの期限が近づいています」の通知が出ます。tansr init を再実行すればローテーションして期限が延びます。使わなくなったデバイスはコンソールでそのデバイスキーを無効化するか、そのデバイスで tansr logout します。tansr logout は PAT を失効させません。

複数のパソコンで同じホスト名だと互いに上書きされる？ されません。各デバイスには 8 桁のランダムなデバイス id がキー名に含まれ、クローンした仮想マシンや社内の統一イメージもそれぞれのキーを持ちます。

サマリーカードに認証情報が平文ファイルにフォールバックしたと出た。 このマシンのキーチェーンが使えないことを意味します（デスクトップセッションのない Linux やコンテナでよく見られます）。認証情報は権限 0600 のファイルとして保存されます。tansr doctor の認証情報ストレージのセクションが継続的に帰属を示します。キーチェーンを直せるなら直し、直せないならそのディレクトリを他のユーザーが読めないようにしてください。

アプリとアプリキー（開発者向け）

アプリキーと PAT は何が違う？ アプリキー（appid / appkey）はあなたのアプリを表し、コンソールの「アプリ」ページで発行し、あなたのサーバー側にだけ置き、エンドユーザー向けに短期トークンを発行するために使います。エンドユーザーは tansr アカウントを必要としません。PAT はあなた本人を表し、CLI 専用です。

アプリを作成するときはどのタイプを選ぶ？ デスクトップアプリ（Electron など）/ モバイルアプリ（Android / iOS、セッションサービス経由）/ サーバーアプリ。1 アプリ 1 プラットフォームで、複数のプラットフォームには複数の appid を使い、失効の範囲と使用量の帰属を分けます。

appkey が漏洩した。 コンソールの「アプリ」ページでローテーションし、サーバー側の環境変数を更新して再起動します。古い appkey は即時無効になります。エンドユーザー単位でその既存トークンを失効させたり、アプリ全体を無効化したりもできます。アプリには IP 許可リストも設定できます（リスト外は app_ip_denied）。

新しく発行されたアプリキーはリクエスト署名を要求する？ はい、デフォルトで強制です。あなたのトークン発行エンドポイントは x-tansr-ts / x-tansr-nonce / x-tansr-sign の 3 つのヘッダーを付ける必要があり、未署名は常に 401 signature_invalid です。公式サンプル examples/token-server にそのまま使える実装があります。

プランと同時実行数

機能はティアで分かれている？ いいえ。裁定者、メモリ、コンテキストスキーム、メディア、MCP、組織ガバナンスは全ティアで同じ 1 つのプロダクトです。ティアの違いは同時実行数、アプリ数、メンバー数、モデルの料金、サービスだけです。テスト期間に作ったものは、ティアを上げても変更なしで動きます。

ティア	対象	同時実行数の上限	アプリ数	モデルの料金
個人	個人ユーザー、CLI のみ	ティアなし	0（アプリを作成するとテスト期間に入る）	定価
テスト期間	統合テスト、企業の立ち上げ	10	3	定価。プラン料金は全額モデル残高に転換
小規模	独立系ソフトウェア開発者	100	10	定価
中規模	エントリーレベルの企業	1,000	32	契約価格
大規模	フラッグシップ企業	10,000	100	契約価格。専用アップストリームを選択可

価格、月払い / 年払いのオプション、購入の入口はコンソールの「プラン」ページを正とします。

同時実行数はどう数える？ アカウント（個人 / 組織）配下の 5 分間のハートビートウィンドウ内のアクティブセッション数のピークです。CLI のメンバーセッションと、あなたの SDK / セッションサービスのエンドユーザーセッションを合算し、同じアカウント内ではセッション id で重複排除します。ハードキャップ = ティア × 1.1（10% の揺れの猶予）。80% / 100% の水位ではプラットフォームが 1 日 1 回警告します。

上限に当たると何が起きる？ プラットフォームは 429 plan_concurrency_exceeded を Retry-After: 30 とともに返します。新しいセッションだけを拒否し、既存のセッションは切断しません。 CLI の TUI はバナーを 1 つ表示してプランページへのリンクを添え、自動では再試行しません——30 秒後に手動で再送すればよいです。セッションサービス形態ではエンドユーザーには「後で再試行してください」だけが見え、クォータの事実はあなたのサーバー側ログに入ります。

テスト期間には他にどんな上限がある？ 月間の異なるエンドユーザー数 100（トークン発行経路のみ）。上限到達は plan_end_users_exceeded。アプリ数、組織メンバー数がティアの上限に達したときは新規作成だけを禁止し、既存のものは無効化しません。

期限が切れるとどうなる？ 14 日間の猶予期間があります。猶予後はテスト期間の上限に戻り、アプリは消えません。tansr doctor のプラン行は 3 つの状態のいずれかを表示します：有効 / 期限切れで猶予期間中 / テスト期間の上限に戻った（元のティア名を添える）。コンソールでプラン、見積もり、プランの使用量を確認でき、カードコードの引き換えもサポートします。

個人ティアでなぜ doctor が「プラン料金なし」と言う？ 個人で CLI を使う場合はプラン料金を徴収せず、定価で残高から差し引きます。この行は故障ではなく、ブロッキングの問題には含まれません。

残高、請求書、インボイス

どうチャージする？ コンソールの「残高」ページで注文します（注文ページで過去の注文状況を確認できます）。残高がゼロまたは取得できないとき、tansr init のサマリーカードは警告して初回チャージの案内を添えますが、処理は止めません。

残高が少なくなるとどんな通知がある？ TUI のステータスバーの残高セグメントは 1 元を下回ると常時表示の警告に変わります。コンソールは警告しきい値に応じてバナーを表示します。メールアドレスを紐付けていれば警告メールが届きます（1 日最多 1 通）。残高が尽きるとプラットフォームのモデル呼び出しはサーバー側の課金ゲートで拒否されます（insufficient_balance）が、ローカル機能には影響しません。

使用量と請求書はどこで見る？ コンソールの使用量ページ（アプリ別 / メンバー別に分解）、月次請求書ページ。CLI では /cost /usage でこのセッションを確認します。開発者がエンドユーザーに対して照合するには GET /v1/app-usage/by-end-user（金額を含む）を使います。端末からの自己照会 GET /v1/my-usage には金額フィールドが決して含まれません。

インボイスはどう発行する？ コンソールでインボイス情報（インボイス宛名情報のページ）を入力した後、請求書ごとに申請します。

プランは返金できる？ 資格条件があります。満たさない場合は refund_not_eligible が返り、コンソールの表示を正とします。

それでも解決しない

ログイン / キーの問題：まず tansr doctor を実行し、認証情報ストレージのセクションと localProviders のセクションをスクリーンショットまたはコピーします（キーの値は含まれません）。
課金の問題：アカウント指紋（tansr init のサマリーカードに表示される形のもので、PAT 自体ではない）、注文番号または請求月を用意します。
その後、サポートに連絡してください。