VS Code 1.146 Local harness の移行方法は？2026年ガイド

VS Codeの公式リリースノートによると、1.146でLocal harnessは非推奨となり、削除は2027年2月に予定されています。今週は設定を棚卸しして退避し、Copilot harnessで代表タスクを試してください。Remote SSHを使うなら、実際の作業環境と実行結果まで確かめてから移行を広げましょう。 (VS Code 1.146のリリースノート)

Local harnessをまだ使っている開発者は、既存セッションとカスタマイズの依存関係を確認してください。
Remote SSHでリモートMacを使うエンジニアは、接続先だけでなくAgent Hostとコマンドの実行場所も検証しましょう。
チーム管理者は、全体へ展開する前にポリシー、サンドボックス、権限が想定どおりか確かめてください。

移行時期と新旧harnessの役割を切り分ける

VS Code 1.146ではLocal harnessが非推奨になり、公式は2027年2月の削除を予定しています。新しいセッションではCopilot harnessが既定ですが、既存のセッションや各種設定が自動で同じ状態に移るという意味ではありません。削除時期と移行の案内は、公式リリースノートとLocalからCopilotへの移行ガイドで照合してください。

ここで混同しやすいのが、harness、モデル、実行場所、Agent Hostです。harnessはエージェントの実行方法やツールとの連携を扱う仕組みで、モデルの選択や、エディターが接続しているマシンとは別の判断軸です。Agent harnessの概念説明とAgent Hostの説明を確認し、どの設定がどの層に属するかを整理します。

本番切り替え前に基準タスクと設定を残す

まず、同じ条件で繰り返せる小さなタスクをひとつ選びます。対象のリポジトリ、必要なコマンド、使用するツール、承認が必要な操作、期待する変更やテスト結果を記録してください。移行前後の差を比べられる基準がなければ、見た目上セッションが動いたことを成功と誤認しやすくなります。

次に、個人Agent、指示ファイル、Hooks、MCPサーバーの設定、ターミナルのシェル設定、関連する認証や権限を洗い出して退避します。セッションでCopilotを選ぶだけでは、これらの項目がすべて変換されるとは限りません。特に秘密情報は、リポジトリへ平文で書き込まず、既存の管理方法と権限設定を維持してください。

注意：切り替え後に以前の動作が変わった場合、モデルの違いだけを原因と決めつけないでください。harness、モデル、利用ツール、Agent Host、実行場所を別々に記録すると、差分を調べやすくなります。

Copilot harnessの試行では既定値と設定移行を分ける

新しいセッションを作成し、Session TargetでCopilotが選ばれていることを確認します。そのうえで、利用アカウント、利用可能なモデル、タスクに必要なツールを確認してください。Copilot harnessが既定であることと、旧設定が引き継がれたことは別の確認事項です。

準備した基準タスクを実行し、変更差分、実行されたコマンド、ツールの利用、承認を求められる場面、最終的なテスト結果を記録します。旧セッションと新セッションで差があれば、モデルを固定できる場合は条件をそろえて比較し、harnessの選択とモデル選択の影響を切り分けます。

MCPサーバーを利用している場合は、設定ファイルの読み込み場所や環境変数、接続権限を確認してください。VS CodeのMCP設定資料を参照し、設定が存在することだけでなく、試行セッションから必要なサーバーとツールが利用できることを確かめます。Hooksや指示ファイルも同様に、名前や配置が残っているだけで互換性ありと判断しないでください。

会話の引き継ぎとRemote SSH上の実行場所を検証する

過去のLocal harnessセッションを引き継ぐ必要がある場合は、公式の移行ガイドに示された手順を使います。履歴、未送信の草稿、開いているワークスペース、許可済み操作が新しいセッションでも必要かを個別に点検してください。旧セッションと新セッションを双方向に切り替えられると想定せず、引き継ぐ情報と作り直す情報を分けておくと、作業状態の取り違えを防げます。

Remote SSHでは、エディターの接続先とAgent Hostの動作場所を別々に確認します。対象リポジトリのパス、シェル、PATH、必要なコマンドが意図したリモート環境にあるかを調べてください。Remote SSHの公式資料とAgent Hostの説明を参照し、エージェントがローカル側とリモート側のどちらで処理しているかを確認します。

リモートMacでmacOS固有のツールチェーンを使う場合は、セッション開始やSSH接続の成功だけを合格条件にしないでください。プロジェクト自身のビルド、テスト、署名など、実際に必要な処理を実行し、その出力と終了状態を基準タスクの期待結果に照らします。リモートMacを使う構成を検討している場合は、Mac環境の比較情報も確認し、作業環境の要件と利用方法を先に整理できます。

チーム展開はポリシーと実プロジェクトの合格後に行う

試行結果をもとに、代表的なプロジェクト、連携ツール、実行環境で問題がないかを確認します。特に、読み書き権限、承認の挙動、サンドボックス、組織で許可されたAI機能が、個人の設定と管理者ポリシーの両方で意図どおりに適用されているかを見てください。VS Codeの企業向けAI設定資料は、管理対象の設定を照合する際の参照先になります。

移行後も失敗する操作がある場合は、無理に展開せず、再現手順と該当設定を記録してブロッカーとして扱います。削除予定までに解消する担当と対応方針を決め、VS Codeの後続リリースノートやポリシー文書に変更があれば計画を見直してください。

よくある疑問と確認事項

Local harnessの削除時期はいつですか？

VS Code 1.146の公式リリースノートでは、Local harnessは非推奨とされ、削除は2027年2月に予定されています。日付だけを基準に一括変更するのではなく、後続のリリースノートも確認しながら、既存依存の解消期限を決めます。

Copilot harnessへ切り替えると設定は自動で移りますか？

すべての設定や過去の会話が自動変換されるとは限りません。指示ファイル、個人Agent、Hooks、MCP、認証情報、ツールの権限をそれぞれ棚卸しし、公式移行ガイドで対応方法を確認したうえで個別に検証してください。

新しいセッションのharnessはどう確認しますか？

セッション作成時にSession TargetでCopilotが選択されているかを見ます。さらに、アカウント、モデル、必要なツールを確認し、代表タスクを実行してコマンドと承認の挙動が意図したとおりかを照合します。

Remote SSHで接続した作業環境は何を検証すべきですか？

エディターの接続先、Agent Hostの実行場所、対象リポジトリ、シェルと必要なコマンドをそれぞれ確認します。最後にプロジェクト固有のビルドやテストを実行し、リモート接続が成功しただけではなく、成果物や終了状態が受け入れ条件を満たすことを確かめてください。

最終更新：2026年11月12日。移行時期と機能の確認にはVS Code 1.146リリースノートを参照しています。

代表プロジェクトで移行を終え、必要なコマンドが目標の作業環境で実行できた後は、macOS環境を継続して確保する必要があるかを検討してください。ローカルMacを購入すれば物理機器へ直接アクセスできる一方、初期費用や保守が発生します。一般的なLinux環境ではmacOS専用ツールチェーンをそのまま実行できず、社内の既存機器だけに頼る場合は利用時間や性能が制約になることもあります。macOSでの継続実行が必要でも、常時稼働の実機を買うほどではないなら、VpsHoldのリモートMac環境を選択肢として確認できます。

よくある質問