← ブログ

ワークフロー

アプリではなく、エージェントを切り替える。

コーディングエージェントは作業途中で利用枠を使い切ることがあります。リポジトリは何も使い切っていません。作業をその場に残し、別のエージェントを開いて、同じターミナルで続けましょう。

変わったのはエージェントだけ。ホスト、リポジトリ、ワーキングツリー、モバイル画面はそのままです。

たいてい、有用な作業が始まってから起きます。エージェントはリポジトリを読み、失敗箇所を見つけ、2つのファイルを変更しました。そこでターミナルが、コードとは無関係な一文で止まります。使用量または支出上限に達しました。

Claude Code の実際のメッセージは率直です。You've hit your individual spend limit · run /usage-credits to ask your admin for a higher limit。Codex にも、アカウントごとの上限通知と選択肢があります。文言は違っても中断は同じ。ワーキングツリーの真ん中にベンダー境界が現れます。

まず、どの上限に達したのか

すべてを「トークン上限」と呼びがちですが、実際には3つの問題があります。会話のコンテキストが満杯になる、プランの利用枠を使い切る、アカウントがクレジットや支出上限に達する、です。次の行動は製品が実際に示す内容で決まります。

コンテキストまたは長さ

ひとつの会話が、モデルが能動的に保持できる情報量に達しました。

対処: 対応していれば圧縮・要約し、そうでなければ要点を引き継いで新しいセッションを始めます。

使用量枠

現在の時間枠におけるプランの利用枠を使い切りました。

対処: 表示されたリセットと、そのアカウントに用意されたアップグレードやクレジットを確認します。

支出・クレジット上限

有料での継続が、個人、ワークスペース、組織の予算境界に達しました。

対処: 資金追加、上限変更、管理者への依頼、待機、または別エージェントへの移行を選びます。

画面の通知を読み、ベンダーの使用量ページでそのアカウントに用意されたリセット、クレジット、管理者向けの選択肢を確認してください。上限と対処はプランごとに異なり、変化します。しかし支払い、待機、管理者への依頼だけが、開発作業を進める方法ではありません。

止まったのは契約です。リポジトリではありません。

分かりやすい代替策には、アプリを替えるコストがある

スマートフォンなら、Claude アプリを閉じて Codex のために ChatGPT を開く、またはその逆が自然です。別のエージェントを使えるという狭い意味では機能します。しかし継続性が最も必要な瞬間に、操縦席全体まで交換されます。

ナビゲーション、承認操作、履歴の整理方法が変わります。一方にしかないワークフローもあり、どちらも普段の tmux セッション、SFTP ブラウザー、トンネルを並べられる汎用 SSH ターミナルではありません。最初の数分は前の変更を理解するのでなく、新しい操作場所を覚えるために消えます。

ターミナルを安定した層にする

Claude Code と Codex を、作業が存在する同じマシン上で、同じ SSH クライアントから実行します。Mobile SSH なら、ベンダー変更は別の tmux ペインを開いてもう一方のコマンドを実行するだけです。画面は単一のモデルベンダーではなく自分のサーバーのためのものなので、使い勝手も変わりません。

エージェント変更後も残るもの
作業状態引き継げる?
リポジトリのファイルと未コミット変更同じディスク上 ✓ はい
Git 状態、diff、テスト出力どちらの CLI も確認可能 ✓ はい
SSH ホスト、シェル、作業ディレクトリ同じセッション ✓ はい
tmux、SFTP、トンネル、エージェント通知同じモバイルツール ✓ はい
別ベンダーの会話履歴新しい引き継ぎが必要 — いいえ
ファイルは共有状態、チャット履歴はベンダー状態です。リポジトリを正としてください。

これが実用的な移植性です。次のエージェントはディスク上のファイル、差分、テスト結果、プロジェクト指示を確認できます。Mobile SSH は接続を、tmux はセッションを保持し、SFTP とポート転送もそのままです。エージェント通知は端末状態を報告するため、どちらのエージェントでも機能します。

ベンダー中立とは、コンテキストが魔法のように移ることではありません。証拠が切り替え後も残ることです。

正直な引き継ぎ

Claude の会話が Codex の会話になることも、その逆もありません。代替エージェントに「続けて」とだけ言い、別サービスのチャットが見えると期待しないでください。リポジトリ規則、ワーキングツリーの差分、実行済みコマンド、まだ必要な結果という永続的な状態を渡します。

4段階の引き継ぎ

  1. 証拠を固定する

    ツリーを消去・上書きせず、git status --short を記録し git diff --stat を確認します。

  2. ローカル規則を読む

    新しいエージェントに、編集前に AGENTS.md と関連ドキュメントを読ませます。

  3. 基準を再確認する

    最小の関連テストを実行し、成功・失敗・未実施を記録します。

  4. 新しいペインで続ける

    古いペインの隣で別 CLI を起動し、目標と制約を渡し、まず既存 diff を確認させます。

役立つ最初のプロンプト AGENTS.md、git status、現在の diff を読んでください。既存の作業を保ち、対象テストを実行し、残作業を説明してから続行してください。

最初のエージェントが要約前に止まったなら、diff が正式な要約です。編集前に確認するよう依頼してください。途中の作業を守り、パッチに含まれた前提を見つけ、続行・修正・取り消しを判断する明確な地点になります。

今日役立つエージェントを、ひとつの画面で

Codex と Claude Code が同じだという主張ではありません。得意分野、モデル、ツール、上限、アカウント規則は異なります。だからこそ画面が永久の選択を強いるべきではありません。タスク、利用枠、リポジトリの方針に合うものを選びます。

ベンダー純正アプリは、多くの場合そのクラウドエージェントを設定なしで使う最短経路です。必要なら使い続ければよいのです。ただし作業が自分の管理するマシン上にあるなら、汎用ターミナルはより長く使える拠点になります。ひとつのアプリでサーバーへ行き、そこに入れた任意のエージェントと、通常の開発に戻ったときの SSH ツール一式を使えます。

能力でエージェントを選び、作業環境は自分の条件で保つ。