OpenCode のセッションはどこに保存される？バックアップ前の5チェック

短い答え：セッションはローカルかつプロジェクト単位で保存される

この検索をする人は、過去の会話を戻したい、別の端末へ移したい、ディスク使用量を確認したい、または機密情報が残っていないか知りたい場合が多いです。OpenCode のセッションは、公開してよいログではなく、プロジェクトの私的な作業記録として扱います。

公式ドキュメントのパスは出発点です。ただし WSL、Docker、SSH、Dev Container、リモートサーバーでは、ホスト OS とは別のデータディレクトリに保存されることがあります。

セッション履歴、プロジェクト設定、Provider の認証情報は別物です。履歴をバックアップしても API キー管理は解決しませんし、設定ファイルをコピーしても過去の会話が必ず移るわけではありません。

コピーや削除前に確認する5つのポイント

まずセッションを作成した同じリポジトリに戻ります。次に OpenCode が実際に使っているデータディレクトリを確認し、プロジェクトに対応するフォルダを探し、更新日時を確認してから、フォルダ全体を私的な場所へコピーします。

場所が分からない場合は、捨ててもよいテストプロジェクトで短いセッションを作り、どのファイルが更新されるか見ます。実プロジェクトを触らずに保存ルールを確認できます。

見えている JSON だけをコピーしないでください。隣接するメタデータやインデックスが、履歴の復元に必要な場合があります。

どのセッション作業を解決したいか

セッション履歴、プロジェクト設定、Provider 接続は別の作業です。まず、探す、コピーする、復元する、削除する、共有するのどれが目的かを分けてください。

OpenCode セッションを安全にバックアップ・移行する方法

コピー前に OpenCode を閉じます。書き込み中のファイルを避けるためです。セッションフォルダは Git リポジトリ外の私的な場所、できれば暗号化された保存先に置きます。

新しい端末へ移す場合は、先に OpenCode をインストールし、対象プロジェクトを一度開いて基本ディレクトリを作ります。その後でコピーを戻し、履歴が見えることを確認します。

チームで共有する場合、原本ファイルより技術的な要約が安全です。要約なら判断や原因は伝えられますが、ローカルパス、社内コード、端末出力の露出を減らせます。

共有や削除の前に行うプライバシーチェック

セッションにはプロンプト、ファイルパス、コマンド出力、エラー、コード断片、モデル回答が含まれることがあります。共有前に API キー、トークン、社内ドメイン、顧客 ID、環境変数を検索してください。

バグ報告が目的なら、実プロジェクトの長いセッションを編集するより、最小再現プロジェクトで新しいセッションを作るほうが安全です。

古いセッションの削除はディスク容量と情報漏えいリスクを減らします。ただし監査、引き継ぎ、デバッグに使う可能性がある場合は、先に私的バックアップを残します。

想定したフォルダが空の場合

実行環境、ユーザー、プロジェクト名、OpenCode のバージョンを確認します。セッションは WSL、SSH、コンテナ、リモートマシン、別ユーザーで作られたかもしれません。

リポジトリを移動した場合、古いセッションはディスクに残っていても現在のパスに紐づかないことがあります。候補フォルダをコピーしてから日時と構造を確認します。

重要な履歴を探している間は、不要な新規セッション作成を避けます。更新日時の手がかりが上書きされる可能性があります。

まとめ：セッションは私的なプロジェクト記録として扱う

安全な順番は、場所を確認し、バックアップし、内容を点検し、最後に削除することです。Git に入れず、チーム内の AI コーディング運用メモにルールを書いておくと再発を防げます。