使い方ガイド · Claude Code + Codex
次に自分が対応するAIは、どれ?
AIを2〜3本並べて動かすと、タブを順番に確かめること自体が仕事になります。Turnlaneの「自分の番」で、返答・許可・レビューを待っている作業を見つけ、元の作業へ戻りましょう。
まず「何を待っているか」を見る
ひとつのAIにリファクタ、もうひとつに不具合の調査を任せ、自分の作業へ移る。戻ってみると、ひとつは許可を求め、別のAIは質問し、もうひとつは変更の確認を待っています。通知は気づくきっかけに、一覧は今も対応が必要なものを確かめる場所になります。
- 「自分の番」を開く。件名、リポジトリ、待っている理由、経過時間を見ます。ボードでは、自分のタスクやカレンダーとAIの作業が同じ日に並びます。
- 対応する前に中身を読む。詳細を開いて、確認できる情報を見ます。許可、質問、PRのレビュー、エラーでは、必要な対応が違います。
- 「開いて対応」を選ぶ。対応する端末でセッションが動いていれば、そのタブが前に出ます。そこで返答するか、対応している場合はTurnlaneの「答える」を使えます。送るのは自分で送信した内容だけです。Turnlaneが答えを決めたり、自動で許可したりはしません。
- 後でよいものは後へ回す。スヌーズするか、状況に応じて「完了」または「対応不要」にします。AIが先へ進んだことをTurnlaneが検知すると、自動で閉じる項目もあります。
Codexの動いているタブへ戻る操作と、Turnlaneからの回答にはhooksが必要です。端末にも条件があります。tmux、ターミナル、iTerm2、Ghostty 1.3以降、Orcaには対応する経路があり、WarpとKittyで「答える」を使うにはtmuxが必要です。デスクトップアプリの記録は取り込めますが、そのチャット画面へ「答える」で送信することはできません。元のセッションを自分で開いて確認することもできます。
普段使っているAIで試す
macOS 14以降のApple Silicon Macと、ローカルのClaude CodeまたはCodexのセッションが必要です。Turnlaneのアカウントは要りません。
1. インストールして開く
ZIPを展開し、Turnlaneをアプリケーションフォルダへ移して開きます。Homebrewでもインストールできます。
brew install --cask turnlane/tap/turnlane2. 取り込む記録を選ぶ
初期設定でエージェントの記録フォルダを選び、取り込みに同意します。直近7日分の作業が取り込まれます。カレンダーへのアクセスと通知は任意です。カレンダーをつながなくても、AIの一覧を試せます。
Claude DesktopのCodeタブとCodexのデスクトップアプリも、同じ形式のローカル記録を使います。Webのチャット、Claudeの通常のチャット画面、ChatGPTのチャットは取り込みません。
3. hooksを追加して、待ちを早く拾う
初期設定の画面でTurnlaneのhooksを入れるか、CLIで次を実行します。
turnlane hooks installZIPで入れた場合は、先に初期設定か「設定 → 一般」でコマンドラインツールをインストールします。Homebrewの場合はPATHに追加されます。hooksを入れたら、起動中のClaude CodeとCodexを再起動してください。Codexでは /hooks を実行し、Turnlaneの項目を承認します。
作業の取り込みと表示にhooksは必須ではありません。入れない場合はローカル記録から待ちを推定するため、表示まで1分ほどかかることがあります。Codexの「開いて対応」「答える」には、動いているプロセスを特定するためhooksが必要です。外すときは turnlane hooks uninstall を使います。
4. 普段の作業で、ひとつ確かめる
いつもの作業を続け、次にAIが入力を求めたり確認する結果を残したりしたら、「自分の番」の行と理由を見てください。「開いて対応」が使えれば、そこから戻れます。一覧を試すためだけに許可待ちを作る必要はありません。
行が出る時刻と、通知が届く時刻は別
「自分の番」は一覧の名前です。内部の状態では、許可や入力を求めて止まっているものが needs_input、ターンが終わって返答やレビューを待つものが your_turn です。エラーも一覧に出ることがあります。
- 許可や入力で止まったとき:hooksから速く信号を受け取ります。ただし許可待ちの通知は10秒待ちます。すぐ解決して先へ進んだ許可で、作業を中断させないためです。
- 質問でターンが終わったとき:Macの前にいれば、既定で15分の猶予があります。その間は薄い行で表示され、一覧の件数には入りません。猶予が過ぎると通常の行になります。長さは設定で変更できます。ターンが終わったときに席を外していれば、この猶予はありません。
- 通知:新しい許可・入力待ちやエラーは即時通知の対象で、許可待ちには上記の10秒の待機があります。それ以外の「自分の番」は15分ごとにまとめて通知します。質問の猶予と、まとめ通知の間隔は別の仕組みです。
バナーを受け取るには、Turnlaneのデスクトップアプリを起動し、macOSで通知を許可してください。Turnlaneの集中モードでは通知を保留し、終了時にまとめます。許可・入力待ちだけを通す設定もあります。macOS側の設定でバナーが抑えられることもあります。同じ項目は5分以内に再通知せず、初回の取り込みで過去の通知をまとめて出すこともありません。この一覧は現在の待ちを確認する場所で、通知履歴の保管場所ではありません。
行の時間は、待ちが始まってからの経過時間です。一方、その日の記録の「放置」(英語UIではIdle)は、猶予を過ぎてMacの前にいた時間を数え、不在とカレンダーの予定がある時間は除きます。
何を読み、何を残すか
Turnlaneは、Claude CodeとCodexのローカル記録と、任意で追加したhooksの情報を読みます。時刻、リポジトリ、ブランチ、状態などの作業情報を保存します。また、指示の先頭行、AIの問いと選択肢、許可を求めたツールとコマンドやパス、エラーの種類を、長さを制限し、可能な範囲で秘密を伏せて保存します。保存した中身は「設定 → データ」で保存を止めたり、削除したりできます。
セッション記録全体、差分、ファイルの内容をデータベースへコピーすることはありません。AIの最後の返答は、詳細を開いたときにローカル記録から読み、最大2,000文字の抜粋として表示しますが、保存はしません。Turnlaneのアカウント、クラウド同期、テレメトリはありません。更新の確認とダウンロードはGitHub Releasesに接続し、設定で止められます。自分のAIツールを呼ぶ機能や、MCPでデータを渡す機能には、それぞれ別のデータの受け渡しがあります。有効にする前にプライバシーの詳細(英語)をご確認ください。
最初の表示が想定と違ったら
- 作業が出ない:使っているエージェントの記録フォルダを選び、取り込みに同意したか確認してください。
- 質問の行が薄い:まだ猶予中かもしれません。バナーが出ていなくても、待っている作業がないとは限りません。
- Codexへ戻れない・答えられない:hooksのインストール、
/hooksでの承認、セッション再起動後の反映を確認してください。 - 行と会話の内容が合わない:記録からの判定は完全ではありません。元のセッションを確認し、必要に応じて「完了」または「対応不要」にしてください。
まず普段のやり取りをひとつ確かめて、その日の作業と一緒に見えると便利か試してください。インストールと初期設定へ戻るか、Turnlaneの概要をご覧ください。