settings.json

worktree.location

型string記述場所-

Desktop の SSH セッションが <project-root>/.claude/worktrees/ の代わりに worktree を作成するリモートマシン上のフォルダを選択する設定で、このキーを読み取るのはデスクトップアプリのみであり、--worktree、EnterWorktree ツール、分離サブエージェント、バックグラウンドセッションは無視する(Claude Desktop v1.44121.0 以降が必要)。

既定値: 未設定の場合、worktree はプロジェクト内に作成されます。

記述例

{
  "worktree": {
    "location": "~/worktrees"
  }
}

使い方・用途

  • リモートマシン上で Desktop の SSH セッションが作成する worktree の配置先フォルダを指定するための設定
  • このキーを読み取るのはデスクトップアプリのみで、--worktree、EnterWorktree ツール、分離サブエージェント、バックグラウンドセッションはこの設定を無視する
  • 利用には Claude Desktop v1.44121.0 以降が必要
英語原文(公式ドキュメントより)

Choose the folder on a remote machine where [Desktop SSH sessions](/docs/en/desktop#choose-where-ssh-session-worktrees-go) create their worktrees, instead of <project-root>/.claude/worktrees/. Only the desktop app reads this key: --worktree, the EnterWorktree tool, isolated subagents, and background sessions ignore it. Requires Claude Desktop v1.44121.0 or later.

関連ドキュメント

関連する変更履歴

v2.1.299(1件)

Fixed
macOS のサンドボックス化されたコマンドが、拒否されたパスがシンボリックリンクを経由する場合に、実体の場所を経由してそのパスを読み書きできる問題を修正した
英語原文を表示
Fixed sandboxed commands on macOS being able to read or write a denied path by its real location when the denied path passes through a symlink

関連ドキュメント

v2.1.274(1件)

Fixed
マルチバイト文字を含むファイルで、Edit 権限のプロンプトプレビューに表示される場所が承認された編集箇所と異なることがある問題を修正した
英語原文を表示
Fixed the Edit permission prompt preview sometimes showing a different location than the approved edit in files with multi-byte characters

関連ドキュメント

v2.1.273(1件)

Improved
[Code Review] 影響を受ける 2 つ目の場所を指すレビューコメントについて、途切れた断片的な表現ではなく、その場所の問題を完全な文で説明するように改善した。
英語原文を表示
[Code Review] Improved review comments that point to a second affected location to state that location's issue in a full sentence instead of a cut-off stub

変更後

コードレビューで、2 つ目の該当箇所を指すレビューコメントが切れ端のような断片的な文ではなく、その箇所の問題を完全な文で説明するようになり、該当箇所の問題内容を読みやすく確認できる。

関連ドキュメント

v2.1.268(1件)

Fixed
シンボリックリンクされたディレクトリ(macOS の /etc、/tmp、/var、Linux の /bin)への deny および ask 権限ルールが、実パスで指定された場合に適用されない問題と、Bash コマンドがシンボリックリンクパス表記で書かれた deny ルールを無視する問題を修正した
英語原文を表示
Fixed deny and ask permission rules on symlinked directories (/etc, /tmp, /var on macOS; /bin on Linux) not applying when a path was given by its real location, and Bash commands ignoring deny rules written on a symlinked path spelling

関連ドキュメント

v2.1.251(1件)

Fixed
ファイルツール(Read、Write、Edit)が、権限チェック後に作業ディレクトリ内で差し替えられたシンボリックリンクを追跡し、承認された場所の外を読み書きできてしまう問題を修正した
英語原文を表示
Fixed file tools (Read, Write, Edit) following a symlink swapped inside the working directory after the permission check, which could read or write outside the approved location

関連ドキュメント

v2.1.208(1件)

Fixed
ワークフロー保存ダイアログにおいて、ユーザー指定の保存先が CLAUDE_CONFIG_DIR ではなく誤って ~/.claude/workflows/ と表示される問題を修正した。
英語原文を表示
Fixed the workflow save dialog showing ~/.claude/workflows/ instead of the CLAUDE_CONFIG_DIR location for user-scope saves

変更後

設定ファイルを標準以外の場所に置いている場合でも、ワークフローの保存先を迷わず確信できるようになります。

関連ドキュメント

v2.1.133(1件)

Added
LinuxおよびWSL向けに、bubblewrapとsocatの実行ファイルのパスを指定する設定(sandbox.bwrapPath, sandbox.socatPath)を追加しました
英語原文を表示
Added sandbox.bwrapPath and sandbox.socatPath managed settings (Linux/WSL) to specify custom bubblewrap and socat binary locations

変更後

OS標準のパッケージ管理以外でツールを導入している環境でも、安全な隔離実行環境を維持できるようになります。

関連ドキュメント

v2.1.110(1件)

Fixed
パイプ出力(非TTY環境)において、一行が極端に長い出力を処理する際にメモリ割り当てが過大になる可能性を修正
英語原文を表示
Fixed potential excessive memory allocation when piped (non-TTY) Ink output contains a single very wide line

変更後

膨大なログやビルド結果を解析させる際の安定性が向上し、システムの限界を気にせずデータを投入できるようになります。

関連ドキュメント

v2.1.101(1件)

Fixed
埋め込みripgrepバイナリのパスが古くなった際にGrepツールが失敗する問題を修正(自動修復機能を追加)
英語原文を表示
Fixed Grep tool ENOENT when the embedded ripgrep binary path becomes stale (VS Code extension auto-update, macOS App Translocation); now falls back to system rg and self-heals mid-session

変更後

ツールの内部的な整合性を気にすることなく、常に安定したコード検索機能を利用できます。

関連ドキュメント

v2.1.98(1件)

Fixed
Windows版VS Codeにて、Gitが標準的な場所にインストールされている、または CLAUDE_CODE_GIT_BASH_PATH が正しく設定されている場合でも「Git Bashが必要」という誤判定エラーが出る問題を修正
英語原文を表示
[VSCode] Fixed false-positive "requires git-bash" error on Windows when CLAUDE_CODE_GIT_BASH_PATH is set or Git is installed at a default location

変更後

WindowsユーザーがVS Codeの統合ターミナルからClaude Codeを起動する際、不要なエラーに悩まされることなく、スムーズに開発を開始できます。

関連ドキュメント

v2.1.85(1件)

Fixed
プラグインのインストール先が設定ファイル内の宣言と異なる場合に、/plugin enable/disableが失敗する問題を修正
英語原文を表示
Fixed /plugin enable and /plugin disable failing when a plugin's install location differs from where it's declared in settings

変更後

プラグイン管理操作の確実性が増し、環境構築時のトラブルに悩まされることが少なくなります。

関連ドキュメント

v2.1.47(1件)

Fixed
LSPのfindReferencesおよびその他の場所ベースの操作が、gitignoredファイル(例：node_modules/、venv/)からの結果を返す問題を修正しました(anthropics/claude-code#26051)。
英語原文を表示
Fixed LSP findReferences and other location-based operations returning results from gitignored files (e.g., node_modules/, venv/) (anthropics/claude-code#26051)

変更後

LSP機能の精度が向上し、gitignoredファイルが除外されるようになったことで、コードナビゲーションや参照検索がより正確になり、開発効率が向上しました。

関連ドキュメント

v2.1.7(1件)

Improved
ターミナルレンダリングにおけるメモリ割り当てオーバーヘッドを削減することで、タイピング応答性を向上させました。
英語原文を表示
Improved typing responsiveness by reducing memory allocation overhead in terminal rendering

v2.0.59(1件)

v2.0.55(1件)

Fixed
Fixed keyboard navigation becoming unresponsive when holding down arrow keys in memory location selector