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

# 移動するセッション

> 1 つの Kana セッションは、ターンごとにマシン、コーディングエージェント、チームメンバーを移りながら、履歴をすべて引き継ぎます。

Kana セッションは、1 台のコンピューター、1 つのコーディングエージェント、1 人の担当者に縛られません。**ターン**（1 つのメッセージと、それに対して Kana が行う作業）ごとに、実行先を変えられます。

* **別のマシンへ。** クラウドとローカルを、どの方向にも切り替えられます。クラウドからローカル、ローカルからクラウド、クラウドマシンから別のクラウドマシン、自分のコンピューターから別のコンピューターへ。
* **別のランタイムへ。** Claude Code で始め、Codex で続け、ほかの任意の[ランタイム](/ja/machines/runtimes)で仕上げられます。モデルと推論量も変えられます。
* **別のメンバーへ。** 同じ会社のメンバーなら誰でもワークスペースのチャットを開いて次のターンを担当したり、実行中のターンが終わったあとに送るメッセージをキューに追加したりできます。そのターンは、そのメンバー自身のマシン上で、そのメンバーのランタイムとサインインで実行されます。

会話、コード、計画はセッションと一緒に移ります。やり直す必要も、コンテキストを手で写す必要もありません。

## セッションが移っていく様子

Aiko は自分のノート PC でセッションを始めます。ノート PC を閉じるとき、セッションを自分のクラウドマシンに移し、Codex に切り替えます。チームメンバーの Ben は続きのメッセージをキューに入れ、その後セッションを自分のデスクトップで、さらに自分のクラウドマシンで引き継ぎます。すべてのターンが同じ履歴に積み重なります。

```mermaid theme={null}
%%{init: {"theme":"base","themeVariables":{"fontFamily":"Inter, ui-sans-serif, system-ui, sans-serif","fontSize":"16px","primaryColor":"#FFF1E0","primaryBorderColor":"#A94604","primaryTextColor":"#3B1A02","secondaryColor":"#FFE4C2","tertiaryColor":"#FFF8F0","lineColor":"#A94604","clusterBkg":"#FFF8F0","clusterBorder":"#E8B98A","edgeLabelBackground":"#FFFFFF","noteBkgColor":"#FFE4C2","noteBorderColor":"#E8B98A","noteTextColor":"#3B1A02","actorBkg":"#FFF1E0","actorBorder":"#A94604","actorTextColor":"#3B1A02","signalColor":"#A94604","signalTextColor":"#3B1A02"}}}%%
sequenceDiagram
  participant AL as Aiko のノート PC（ローカル）
  participant AC as Aiko のクラウドマシン
  participant S as Kana セッション（履歴・計画・チェックポイント）
  participant BL as Ben のデスクトップ（ローカル）
  participant BC as Ben のクラウドマシン

  Note over AL,S: ターン 1 · Aiko · Claude Code
  S->>AL: ターンを実行
  AL-->>S: 返信
  Note over AC,S: ターン 2 · Aiko · Codex、クラウドへ移動
  S->>AC: 起動、チェックポイントを復元、履歴を再生
  AC-->>S: 返信
  Note over S,BL: ターン 3 · Ben · Copilot CLI、キューから実行
  S->>BL: チェックポイントを復元、履歴を再生
  BL-->>S: 返信
  Note over S,BC: ターン 4 · Ben · Claude Code、再びクラウドへ
  S->>BC: 起動、チェックポイントを復元、履歴を再生
  BC-->>S: 返信
  Note over AL,S: ターン 5 · Aiko · Codex、ノート PC に戻る
  S->>AL: 最新のチェックポイントを取得、履歴を再生
  AL-->>S: 返信
```

5 つのターンはすべて 1 つの会話です。Kanaeru は、各メッセージを誰が送り、どのランタイム、モデル、マシンが答えたかを記録します。

## 別のマシンに移る

エージェントピッカーで別のマシンを選んで送信するか、[`kana conv send`](/ja/cli/reference) に `--machine` を渡します。新しいマシンが作業を始める前に、Kana は次のことを行います。

1. 前のターンを実行したマシンに、作業をコミットしてリポジトリの `origin` 上のチェックポイント ref にプッシュするよう依頼します。スリープ中のクラウドマシンは、このために起動されます。
2. 移動先がスリープ中のクラウドマシンなら起動します。移動先はそのチェックポイントを取得し、同じタスクのワークツリーを用意します。
3. 古いランタイムを止め、ここまでの会話を引き継いで新しいマシンでセッションを開始します。
4. エージェントにマシンを移ったことを伝えます。エージェントは作業を続ける前に、ブランチ、ツール、環境を確認し直します。

Kana が各タスクを作る場であるタスクのワークツリーは、ターンが完了するたびと、マシンのシャットダウン時にもチェックポイントが作成されます。そのため、切り替える前の時点で、タスクの最新の作業はたいていすでにリポジトリにあります。計画やビジョンなど、それ以外のセッションは、移動するときにだけ作業をプッシュします。

### 前のマシンがオフのとき

スリープ中のクラウドマシンは自動で起動されます。電源が切れている、またはオフラインのローカルコンピューターは起動できません。その場合、Kana は確認カードを表示し、そのマシンなしで続けるかどうかを尋ねます。

| 引き継がれるもの | 条件 |
| - | - |
| **すべて** | 前のマシンが応答し、現在の作業をプッシュした |
| **最後のチェックポイント** | 前のマシンには接続できないが、最後のチェックポイントかプッシュ済みのブランチがリポジトリにある。プッシュされていない作業は引き継がれない |
| **会話のみ** | このセッションの作業が一度もプッシュされていない。会話、計画、ブループリントは引き継がれるが、コードは引き継がれない |

移動に参加しなかったマシンからは何も削除されません。プッシュされていない作業はそのマシンに残るので、あとで回収できます。あとでセッションをそのマシンに戻すとき、そのマシン上のコピーがセッションの新しい作業と食い違っていると、そのコピーを整理するか調整するまで移動は拒否されます。引き継がれなかったリポジトリがあれば、その名前を示す通知が表示されます。エージェントにも同じことが伝えられ、続ける前に各リポジトリの実際の状態を確認します。CLI では `--accept-degraded-handoff` で同じ同意を与えます。

## ランタイムを切り替える

送信する前にエージェントピッカーで別のランタイム、モデル、推論量を選ぶか、`--runtime` を渡します。セッションは履歴を保ちます。

* **同じランタイム、同じマシン：** ランタイムが自分の会話を中断した地点から再開します。
* **新しいランタイム、モデル、マシン：** Kanaeru が保存済みの履歴からセッションを再生します。エージェントには直近 40 件のメッセージがそのまま渡され、それより古いものは要約されます。残りは Kanaeru のツールでページをめくって読めます。各メッセージには、誰が送り、何が生成したかのラベルが付きます。

どのランタイムにも、同じスキル、ルール、フックのハーネスと、Kanaeru 上の同じ計画とブループリントが渡されるため、同じプロセスのまま作業を続けます。[セッションプラグイン](/ja/machines/session-plugins)を参照してください。

## チームでセッションを進める

同じ会社のメンバーなら誰でも、ワークスペースのチャットを開いてそのセッションに参加できます。

* **次のターンを担当する。** 実行中のターンが終わったらメッセージを送ります。あなたのターンは **あなたの** マシンのいずれかで、あなたのランタイムとプロバイダーのサインインで実行されます。前のターンがチームメンバーのマシンで実行されていた場合、Kana は上の手順でセッションをあなたのマシンに移します。
* **メッセージをキューに追加する。** ターンの実行中にメッセージをキューに入れられます。キューは会話の参加者全員に表示され、タブを閉じても残ります。ターンが終わると、古いものから順に送信されます。あなたが続けて入れたメッセージは 1 つのターンとしてまとめて送られます。チームメンバーのメッセージは、そのメンバーのマシンで別のターンとして始まります。キューに入れたメッセージを編集・削除できるのは、入れた本人だけです。1 つのセッションには最大 50 件までキューに入れられます。

<Note>
  ターンを実行できるのは自分のマシンだけです。マシンはそれぞれ 1 人のユーザーに属するため、チームメンバーのノート PC やクラウドマシンにターンを送ることはできず、あなたのメッセージがその人の認証情報で実行されることもありません。あなたのプロバイダーキーとサインインは、あなたのマシンにとどまります。
</Note>

セッションは一度に 1 つのターンを実行し、1 本の履歴を保ちます。並行するコピーに分かれることはないため、全員が同じ会話と同じコードを見ます。

## セッションと一緒に移るもの

| | 保存場所 | 次のマシンやランタイムでは |
| - | - | - |
| **会話** | Kanaeru | 直近のメッセージはそのまま再生され、古いものは要約される |
| **コードとリポジトリの変更** | リポジトリ内のチェックポイント ref `refs/kanaeru/checkpoints/<session>/<repo>` | 取得され、前のマシンが報告したコミットと一致するか確認される |
| **計画、ブループリント、パイプラインの状態、メモリ** | Kanaeru | Kanaeru から読み込まれ、どのマシンでも同じ |
| **ハーネス** | 各マシンのエージェントマネージャー | エージェントマネージャーと一緒にインストールされる。どのランタイムにも同じスキル、ルール、フックが渡される |
| **認証情報** | ターンを実行する人のマシン | コピーされない。各ターンはそのマシンのサインインを使う |

チェックポイントには、`.env` ファイル、秘密鍵、認証情報ファイルなどのシークレットは含められません。含まれそうになると、チェックポイントは失敗し、理由が表示されます。

<Tip>
  セッションを移すには、両方のマシンのエージェントマネージャーが新しいバージョンである必要があります。どちらかが古すぎる場合、Kana は移動を拒否し、どちらのマシンかを伝えます。[アップグレード](/ja/machines/connect-a-machine)してから、もう一度送信してください。
</Tip>


## Related topics

- [Kanaeruの概要](/ja/index.md)
- [ランタイム](/ja/machines/runtimes.md)
- [Kana と作業する](/ja/guides/working-with-kana.md)


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