何のためのものか
セッション開始時に選ぶ環境が、Claude がどこで実行され、どう接続するかを決める。Local は自分のマシン、Cloud は既定では Anthropic 管理のインフラ(アプリを閉じても継続する)、SSH は自分で管理するリモート、WSL は Windows の WSL 2 の中。
触る
- プロンプトボックスの環境ドロップダウンを開く
- Local にホバーして歯車アイコンをクリックし、local environment editor を開く
- 変数を 1 つ保存する。暗号化されてマシン上に保存され、すべてのローカルセッションとプレビューサーバーに適用される
入れる
環境変数がどこから来るかを押さえる。
- macOS — Dock や Finder から起動したとき、
~/.zshrcや~/.bashrcを読んでPATHと決まった一群の Claude Code 変数だけを取り出す。そこで export した他の変数は拾わない - Windows — ユーザーおよびシステムの環境変数は引き継ぐが、PowerShell のプロファイルは読まない
- 届く先が違う —
~/.claude/settings.jsonのenvは Claude のセッションにしか届かない。dev サーバーにも渡すなら local environment editor - SSH を足す — 環境ドロップダウンの + Add SSH connection。初回接続時に Desktop がリモートへ Claude Code を自動インストールする(リモートは Linux または macOS)
効かせる
- WSL を使う判断 — リポジトリがディストリビューションのファイルシステムにあるなら WSL セッション。Windows 側から扱うとネットワークファイルシステム経由になり、遅く、ファイル監視が壊れる。要件は WSL 2(WSL 1 は非対応)とディストリビューション内の
git - 信頼の単位を知る — WSL の信頼はディストリビューションとフォルダの組ごと。あるディストリビューションで信頼したフォルダは、別のディストリビューションでも、Windows 側の同じパスでも信頼済みにならない
- thinking を制御する — extended thinking は既定で有効。Anthropic API では
MAX_THINKING_TOKENSを0にすると切れる(Fable 5 には効かない)。adaptive reasoning を持つモデルでは0以外の値は無視される
落とし穴
- WSL セッションで使えないもの: 統合ターミナル、connectors と plugins、セッションの fork、ファイルブラウザのペイン、
@によるファイル候補 - cloud セッションで使えないもの: 統合ターミナル、ファイルペイン、@mention、plugin ブラウザ、Bypass permissions
- 組織が管理するデバイスでは WSL セッションが利用できないことがある