> ## Documentation Index
> Fetch the complete documentation index at: https://cogno.studio/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Taskをターミナルで引き継ぐ

> TaskのClaude CodeまたはCodex sessionを、埋め込みまたはローカルのターミナルで続けます。

Task composerの横にあるターミナル操作から、コーディングエージェントのsessionを自分で続けられます。Cognoは、作業中もsession、作業ディレクトリ、Taskのつながりを保ちます。

## 前提条件

* CognoデスクトップアプリでTaskを開いていること。
* TaskがClaude CodeまたはCodexのexecutorを特定できること。
* TaskがEnvironmentへ接続済みであること。保存済み実行sessionは自身のEngine targetを持ち、sessionがないTaskにはローカルディレクトリが必要です。

Cognoが利用可否を確認している間も、ターミナルアイコンはcomposer内に残ります。Taskにターミナルの実行先がない場合は無効のままです。

## ターミナルメニューを開く

ターミナルアイコンにポインターを合わせると、保存済みsessionがある場合は**CLIで再開**、sessionなしで判明済みexecutorを開始できる場合は**CLIで開始**と表示します。

アイコンを選び、利用できる実行先を選びます。

| 選択肢 | 利用条件 |
| - | - |
| **このアプリ内で開く** | Taskの横に埋め込みターミナルを開きます。ローカルまたはリモートsessionを所有するEngineへ接続できます。 |
| **ターミナルで開く** | このコンピューターのターミナルアプリを開きます。Taskがこのコンピューターで動く場合だけ利用できます。 |
| **コマンドをコピー** | このコンピューターのshell向けに`cd`と再開コマンドをコピーします。Taskがここで動く場合だけ利用できます。 |

別マシン上のTaskでは、**このアプリ内で開く**だけを表示します。ネイティブターミナルやコピーしたpathは、現在のコンピューターのディスクを参照するためです。

## Sessionを続ける

保存済みsessionでは、CognoがEngineから正確な作業ディレクトリと再開コマンドを取得します。コマンドの形は次のとおりです。

```bash theme={"system"}
cd <task-directory> && claude --resume <session-id>
cd <task-directory> && codex resume <session-id>
```

埋め込みターミナルは、Taskのエージェントターミナルがすでに存在する場合に再利用します。操作を開き直しても、同じsessionの2つ目のコピーを意図的には開始しません。

CognoがTaskの引き継ぎ情報から手動sessionを開始するときは、ターミナルを開く前または同時に手動作業を記録します。これによりTaskが**進行中**に保たれ、同じTaskで2つ目のrunを開始できなくなります。記録はbest-effortであり、無関係な追跡エラーのためにターミナルを開けなくすることはありません。

Cognoの外で始めたターミナルは追跡しません。

## エージェントのrunを読む

会話には依頼と最終回答が表示されたままになります。run中はアクティビティ見出しに\*\*... 作業中**と表示し、現在の説明も表示します。runが終わると、**... 作業しました\*\*が途中の作業を折り畳み、回答を読みやすく保ちます。

連続するファイルの読み取り、検索、編集、コマンドは、1つのアクティビティ概要にまとまります。概要を開くと各toolが表示され、さらにtoolを開くとコマンド、出力、またはファイル変更を確認できます。長いターミナル出力は詳細表示内で上限が設定されるため、古いrunが会話を埋めたり停止させたりしません。

長いCodexまたはClaude Codeの会話では、次の回答に向けて履歴を整理している間、**会話履歴を圧縮中**と表示します。この行はtoolの概要に折り畳まれずに表示されます。圧縮が終わると**会話履歴を圧縮しました**に変わり、コーディングエージェントが回答を続けます。

Mobileでもアーカイブアイコンの横に同じ状態を表示します。圧縮が停止または失敗すると、**会話履歴の圧縮を停止しました**または**会話履歴の圧縮に失敗しました**と表示します。この状態行には開く操作がなく、画面幅と文字サイズに合わせて文言が折り返されます。

## 会話内の質問に答える

Cognoが判断や情報を必要とすると、Taskの会話内に質問が表示されます。そこで選択肢を選ぶか、会話下部の既存のメッセージ入力欄に回答を入力して送信します。質問専用の入力欄はありません。送信に失敗しても入力した回答が残り、再試行できます。

MobileのTaskチャットでも、既存の入力欄から回答できます。質問の×ボタンで無視することもできます。回答または無視した質問は、Homeの未対応通知から消えます。

自分宛ての質問は、別マシンで実行中のTaskをDesktopの説明画面やブラウザのTask詳細で開いたときにも表示されます。同じ入力欄から回答でき、ローカルのmodel選択やProjectフォルダの準備は不要です。回答または無視しても、実行は現在のマシンに残ります。質問の宛先はTaskを実行するEnvironmentの所有者で、Taskの担当者と異なる場合があります。

ネイティブのTaskプレビューには、この質問入力欄はありません。

質問は入力欄の外側・すぐ上に1枚ずつ表示します。**保留**で回答せずに次の質問へ進めます。保留した質問は再表示でき、書きかけの回答も質問ごとに残ります。

Desktopには質問がすぐに表示されます。約1分未回答なら[モバイル](/docs/ja/mobile-decisions.md)にも表示され、モバイル通知が有効な場合は通知が届きます。それまでにDesktopで回答すればスマホへの通知は出ません。Desktopでの回答にモバイルアプリは不要です。

## ログアウトしたコーディングエージェントに再接続する

Claude CodeまたはCodexがログアウトすると、会話に接続状態の案内が表示されます。停止したターンを実行したコンピューターでサインインしてください。

| Taskを開く場所 | 操作 |
| - | - |
| 実行マシン上のDesktop | **サインイン**を選び、ターミナルでサインインを完了します。CognoがCLIの状態を未接続から接続済みへの変化として確認すると、停止したRunが自動で再開します。 |
| ブラウザまたは別マシン上のDesktop | 案内に従い、実行マシンで`claude auth login`または`codex login`を実行します。この画面には**サインイン**ボタンがありません。**Run を再開**が表示されたら選びます。 |
| 再ログインが必要と表示される場合 | 保存されたログインが接続済みと判定されても、有効期限が切れている場合があります。再ログインを完了してから**Run を再開**を選びます。保存された状態だけでは自動で再開しません。 |

ターミナルを開けない場合は、案内にエラーが表示されます。macOSのAutomation権限で拒否された場合は、**システム設定 → プライバシーとセキュリティ → オートメーション**でCognoによるターミナルの操作を許可するよう案内されます。許可後に**サインイン**を再試行してください。

## 新しい会話でproviderを切り替える

Claude CodeまたはCodexが利用上限に達したときや、作業をもう一方のproviderで続けたいときは、Taskのcomposerから切り替えられます。Cognoは同じworking copyで完全に新しい会話を開始するため、未commitの変更は残ります。新しいagentには以前の会話をchat historyとして渡しません。

### 利用上限のあとに切り替える

ワークスペース上部の案内には、自分の実行マシンで起きた利用上限による停止だけが表示されます。Desktopでは今使っているマシン、ブラウザーではそのワークスペース内の自分のマシンが対象です。ほかのメンバーの停止は表示されません。記録された再試行の待機期限を過ぎるか、同じマシン・同じエージェントで停止後に開始したRunが成功すると、別のTaskであっても案内が消えます。マシン、所有者、待機期限が分からない過去の停止は、Taskの履歴に残り、この案内には表示されません。待機期限は、providerが確認した上限リセット時刻ではありません。

利用上限の案内の下にある**Codex で続ける**または**Claude Code で続ける**を選び、dialogでproviderの切り替えを確認します。そのproviderの既定modelで新しい会話が始まります。

### 特定のmodelへ切り替える

composerの下にあるmodel menuを開くと、両方のproviderで利用できるmodelが一覧表示されます。現在のproviderのmodelを選ぶと、既存の会話のmodelだけが変わります。もう一方のproviderのmodelは**新しい会話**groupに表示されます。選ぶと確認dialogが開き、providerとmodelの名前が表示されます。run中の場合は、**止めて \<model> で続ける**を確認すると、runを止めてから新しい会話を開始します。

すでに入力していたメッセージがある場合は、切り替えを受け入れたあと、composerから消して新しい会話の**最後に届いたメッセージ**として引き継ぎます。

新しい会話にはTaskの説明と、Engineが書き込める場合はworking copy内の次の2つのfileを指すpromptが渡されます。

* `.cogno/inputs/switch/<session>/previous-conversation.md` — 以前の会話の読みやすい記録。message、tool call、turnの終了状態を含みます。
* `.cogno/inputs/switch/<session>/<claude|codex>-transcript.jsonl` — providerのraw transcriptです。

agentは必要な範囲だけ、末尾からfileを読みます。fileを書き込めなくても、新しい会話はTaskの説明から開始します。以前の会話はTaskの履歴として残ります。

## 権限を理解する

Cogno管理のrunでは、toolに対する1回限りの承認依頼を表示できます。ネイティブの許可ルールとtool metadataにより、確認なしで進む操作もあります。UIを閉じることや接続切れは、保留中の依頼を承認しません。

承認カードは会話内に表示され、どの操作の承認なのかを名前で示します。ターミナルの依頼にはコマンドが表示されます。Cogno の連携 tool では**Slack · メッセージを送信**や**GitHub · Pull Request を作成**のようにサービスと操作が表示され、その下の行にメッセージやタイトルが出ます。他の人の目に触れる操作には**外部に送信されます**、参照だけの操作には**読み取りのみ**のバッジが付きます。agent が理由を添えていない場合、カードは「Slack にメッセージを送信しようとしています。許可しますか？」のように操作そのものを尋ねます。Cogno が知らない tool は tool 名のまま表示されます。残りの引数は**詳細を表示**で確認し、**拒否**または**一度だけ許可**を選びます。カードにフォーカスがある場合は、Escで拒否、Enterで一度だけ許可できます。

保留中の承認は15分で期限切れになります。自律runでは、Cloudへ待機件数や期限などのメタデータを送り、toolの引数や認証情報は送りません。実行policyの応答互換性を保つため、CognoとEngineを更新してください。

connector設定は、CognoからClaude CodeまたはCodexを起動するときに適用されます。自分で起動したCLIは、自身のグローバル設定を使います。

## トラブルシューティング

| 症状 | 対処 |
| - | - |
| ターミナルアイコンが無効のまま | Taskを一度実行するか、ProjectのEnvironmentを接続し、executorと実行先を解決できるようにします。 |
| **このアプリ内で開く**だけが表示される | Taskが別マシンで動いています。そのEngineへ接続する埋め込みターミナルを使います。 |
| **ターミナルで開く**または**コマンドをコピー**にsessionがない | Taskはexecutorを特定でき、再開できるsessionがありません。紐づいたディレクトリでexecutorを開始します。 |
| コピーしたコマンドがディレクトリを見つけられない | 所有マシンの埋め込みターミナルを開くか、ProjectのEnvironmentを修復します。 |
| 別のrunを開始できない | 手動sessionを終了または停止します。1つのTaskで実行中にできるrunは1つです。 |
| Claude CodeまたはCodexの利用上限でメッセージを送信できない | エラーの下にある**Codex で続ける**または**Claude Code で続ける**を選び、dialogで確認します。もう一方のproviderの既定modelで新しい会話が始まります。同じworking copyを使い、利用できる場合はTaskの説明と以前の会話のfileを新しいagentへ示します。 |
| composerの上に**Codex が利用上限に達しました**(またはClaude Code)と表示されてrunが止まった | その案内の**Claude Code で続ける**(または**Codex で続ける**)を選び、dialogで確認します。ボタンは、Taskを実行するマシンでもう一方のエージェントにサインインしているときだけ表示されます。 |
| Cogno自身のrunが一方のエージェントの利用上限で失敗し続ける | 実行マシンで両方のエージェントにサインインしていれば対応は不要です。一方が利用上限を報告すると、Cognoは上限メッセージにあるリセット時刻まで、次の新しいrunをもう一方のエージェントで開始します。進行中の会話は同じエージェントのままです。片方しかサインインしていない場合は、そのマシンで `claude auth login` または `codex login` でもう一方にサインインします。 |

その他の問題は[トラブルシューティング](/docs/ja/troubleshooting.md)を参照してください。

## モバイルの待機メッセージ

待機中のメッセージは入力欄の上に表示されます。本文の編集、取り下げ、今すぐ送信ができ、編集しても元の添付と実行設定は維持されます。本文編集には対応したEngineが必要です。

## 関連ドキュメント

* [Taskをエージェントに実行させる](/docs/ja/agents.md)
* [Taskを扱う](/docs/ja/tasks.md)
* [マシン](/docs/ja/machines.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.