トークンのローテーション(ベータ)

Claude Code をたくさん使うと、1 週間分の枠を 1 日で使い切ってしまうことがあります。契約を複数持っていれば、 ふつうは /login で手で切り替えます。トークンのローテーションは、それを自動でやります。新しいセッションは いちばん余裕のある契約で始まり、上限が近づいたセッションは同じ会話のまま別の契約へ移ります。

ガンガン使う人は、これだけ覚えてください。 セッションが使用量の上限に当たったら、そのセルの 「道具」 メニューから 「エージェントを再起動」 を選びます。余裕のある契約で、同じ会話のまま やり直せます。/login も、ログアウトも、 新しい会話も要りません。上限に当たるまでは、何もしなくて大丈夫です。

  1. 上限に当たったら: エージェントを再起動
  2. 「複数の契約(accounts)」との違い
  3. 設定のしかた
  4. /login しているアカウントを入れるか
  5. 契約の選び方
  6. 週の枠を少し残しておく
  7. 枠が少なくなったとき
  8. 画面で見えるもの
  9. トークンの使用量
  10. 契約が替わるタイミング
  11. ローテーションするセル
  12. 動いているかの確かめ方

上限に当たったら: エージェントを再起動

ふだんは何もしなくて済みます。契約が 98% に達すると、セッションは自動で移ります (枠が少なくなったとき)。ただ、使用量の値は数分遅れることがあるので、先に上限に当たって Claude Code 自身の上限メッセージで止まることがあります。そのときは:

  1. そのセルの見出しで 「道具」 を開きます。
  2. 「エージェントを再起動」 を選びます。

セルの見出しの「道具」メニュー。いちばん下に「エージェントを再起動」

エージェントがいったん終了し、同じ会話のまま起動し直します。契約はプロセスが起動するたびに選び直されるので、 いちばん余裕のある契約に乗り換わり、セルの見出しにその名前が出ます。上限で止まった質問は送り直されていないので、 もう一度送ってください。

すべての契約が上限のときは、再起動しても Claude Code の上限メッセージがまた出ます。いちばん早く戻る契約を トークンの使用量 で確かめて待ってください。

「複数の契約(accounts)」との違い

複数の契約は、契約ごとに設定ディレクトリを分けるので、ある契約で始めた会話はその契約のままです。 トークンのローテーションは、ディレクトリを 1 つ(~/.claude)のままにして、認証だけを替えます。 なので、どの会話もどの契約で続けられます。/login で切り替えるのと同じことを、自動でやります。

設定のしかた

  1. 契約ごとにトークンを作る。 自分のターミナルで claude setup-token を実行し、ブラウザでその契約にログインします。 sk-ant-oat01- で始まる長いトークンが表示されます。
  2. トークンを macOS のキーチェーンにしまう。 契約ごとに 1 項目です。

    security add-generic-password -a mulmoterminal -s mulmoterminal-token-personal -w
    

    -w のあとに何も書かないと入力を求められるので、トークンがシェルの履歴に残りません。トークンをチャットや config.json に貼らないでください。Mac 以外では、トークンだけを書いたファイルを chmod 600 にして、下の "file" で指定します。他の人が読めるファイルは読み込みません。

  3. ~/.mulmoterminal/config.json に tokenRotation を足す。

    "tokenRotation": {
      "enabled": true,
      "includeDefaultLogin": false,
      "tokens": [
        { "id": "personal", "label": "Personal", "email": "me@example.com", "keychain": "mulmoterminal-token-personal" },
        { "id": "work", "label": "Work", "email": "me@work.example", "keychain": "mulmoterminal-token-work" }
      ]
    }
    

    email は自分用の目印です。どの契約かが分かるように、その契約の横に表示されます。

  4. 設定画面の「設定ファイルを読み直す」を押す(再起動は要りません)。
  5. 新しいセルを開くか、セルを閉じてその会話を開き直す。このときに契約が選ばれます。

mulmoterminal-model skill に「契約を回して」と頼めば、ここまで案内します。

/login しているアカウントを入れるか

includeDefaultLogin: true にすると、/login でログインしているアカウントも候補の 1 つになります。 全部の契約をトークンとして登録したら false にしてください。 /login のアカウントは必ずそのどれかなので、 同じ枠を 2 回数えることになります。しかも、どれと重なるかは /login し直すたびに変わります。

契約の選び方

7 日枠の 「残り」を「リセットまでの時間」で割った値 が大きいものから選びます。リセット間近で余っている枠は リセットで消えてしまうので先に使い、1 週間丸ごと残っている契約は後回しにします。こうすると、1 週間を通して どの契約の枠もなるべく平らに減っていきます。

いまその契約で動いているセッションがあれば、その数で分け合います(値を「1 + 動いているセッション数」で割ります)。 なので、セルを何枚も一緒に開いても、いちばん急ぐ契約 1 つに全部が乗らず、いくつかの契約に散らばります。

5 時間枠が 90% 以上、または 7 日枠が 98% 以上の契約は選びません。

組織が Claude Code での利用を止めている契約は、あとの使用量の確認がまた通るまで、まったく選びません。 それ以外の理由で最後の使用量の確認に失敗した契約は、最後の数字がもう確かめられていないので、 新しい数字が取れているどの契約よりも後に回します。

週の枠を少し残しておく

ある契約の枠を MulmoTerminal の外で使う分として残したいときは、その項目に reserveWeeklyPercent を足します。

{ "id": "personal", "label": "Personal", "email": "me@example.com", "keychain": "mulmoterminal-token-personal", "reserveWeeklyPercent": 5 }

5 なら、その契約は 7 日枠が 95% に達した時点で使い切ったものとして扱います。新しいセッションはそこで始めず、 そこで動いているセッションはターンの終わりに別の契約へ移ります。他の契約がすべて使い切っていても、残した分には 手を付けません。0 より大きく 99 以下の値が使えます。それ以外の値は無視され、残さない設定として動きます。

枠が少なくなったとき

  • 98% になったら: 5 時間枠か 7 日枠が 98% 以上の契約でセッションがターンを終えると、その場で別の契約へ移ります。 ターンの切れ目で移るので、作業が途中で切れることはありません。
  • それでも上限に当たったら(使用量の値は数分遅れることがあります): Claude Code が上限を知らせてきた時点で、すぐ移ります。

どちらの場合も、セルは自動でつなぎ直して同じ会話を再開し、何が起きたかを 1 行で表示します。

[mulmoterminal] Personal (me@example.com) is close to its usage limit — continuing this conversation on Work.

上限で止まった質問は 送り直しません。もう一度送ってください。他の契約もすべて使い切っているときは移らず、 Claude Code の上限メッセージのまま残ります。

画面で見えるもの

  • セルの見出し に、そのセルが動いている契約の名前が、複数の契約と同じ印で出ます。 この印をクリックすると、そのセッションを自分で別の契約へ移せます。一覧から選ぶと、選んだ契約でセッションを再起動し、 同じ会話を続けます。実行中のやり取りは止まります。一覧には設定にある契約が並び、includeDefaultLogin が有効なら /login の契約も入ります。 それぞれに週の枠の残りと、その枠がリセットされるまでの時間が出ます。ツールバーの使用量と同じ読み取りを使うので、測れるまでは空欄で、使い切っていれば「上限に達しています」と出ます。
  • ツールバーの使用量 に、契約ごとの表示が並びます。マウスを載せると名前とメールアドレスが出ます。 枠を使い切った契約は、数字の代わりに警告色で「上限」と出ます。マウスを載せると、最後に読めた枠のリセット時刻が出ます。 /login の契約の数字には /login の名札が付くので、トークンの数字が二重に出ていると見間違えません。
  • 「その他の機能」→「トークンの使用量」 に、契約ごとの 5 時間枠と週の枠の残りと、それぞれのリセットまでの時間が一覧で出ます。 トークンのローテーションを設定しているときだけメニューに出ます。

トークンの使用量

「その他の機能」→「トークンの使用量」 で、tokenRotation に登録した契約すべての残りを一度に見られます(/login のアカウントは並びません)。5 時間枠と週の枠がそれぞれどれだけ残っていて、 いつリセットされるかが並びます。「なぜこのセッションはこの契約になったのか」「上限のあと、どの契約がいちばん早く戻るか」を 知りたいときに開いてください。

「その他の機能」メニュー。いちばん下に「トークンの使用量」

「トークンの使用量」画面。登録したトークンごとの 5 時間枠と週の枠の残り(契約名は置き換えています)

  • バーは使った量ではなく 残り です。短いバーは、その契約がもうすぐ尽きることを表します。
  • リセットまでの時間は、契約を選ぶときの判断材料と同じです。リセット間近で余っている枠から先に使われます。
  • トークンのローテーションを設定しているときだけメニューに出ます。ツールバーの使用量ゲージにも、契約ごとに同じ値が小さく出ます。

契約が替わるタイミング

契約が選ばれるのは、セッションの プロセスが起動するとき です。新しいセル、閉じた会話の開き直し、再起動ボタン、 上限による移動がそれにあたります。ブラウザの再読み込みや接続が切れての再接続は、動いているプロセスにつなぎ直すだけなので、 契約は変わりません。

ローテーションするセル

ふつうの Claude のセルだけです。プロバイダ、カスタムエージェント、複数の契約(accounts)のセルは、 どの契約で動くかがもう決まっているので、ローテーションしません。

動いているかの確かめ方

  • ローテーションしているセルで /status を見ると、Auth token: CLAUDE_CODE_OAUTH_TOKEN と出ます。
  • Claude Code 自身が表示するアカウント(/status など)は、/login のアカウントのままのことがあります。これは Claude Code が自分の設定から読んだだけの表示で、使用量はセルの見出しに出ている契約から引かれます。
  • 読めないトークンは飛ばされ、サーバーのログに項目名だけが出ます(トークンの値は出ません)。

複数の契約を回して使うことが Anthropic の利用規約に照らして問題ないかは、ご自身で確認してください。


This site uses Just the Docs, a documentation theme for Jekyll.