desktop.md +32 −5
120 120
121> [!NOTE]121> [!NOTE]
122>122>
123123> [SSH セッション](#ssh-sessions)では、Claude は Browser ペインのツールを利用できないため、Browser ペインでアプリを開くことができません。アプリを自分で確認するには、[そのポートをコンピューターに転送](#reach-a-port-on-the-remote-machine)します。> [SSH セッション](#ssh-sessions)では、Claude は Browser ペインのツールを利用できないため、ペインでアプリを開いたり、変更を[自動検証](#auto-verify-changes)したりすることができません。ペインの **Dev servers** メニューと[設定済みのプレビューサーバー](#configure-preview-servers)も利用できません。アプリを自分で確認するには、リモートマシンでサーバーを起動してから、[そのポートをコンピューターに転送](#reach-a-port-on-the-remote-machine)します。
124 124
125ローカルセッションで Claude がサーバーを起動した後に Browser ペインが開いていない場合は、チャット内のサーバーのカードにある **Open** をクリックします。125ローカルセッションで Claude がサーバーを起動した後に Browser ペインが開いていない場合は、チャット内のサーバーのカードにある **Open** をクリックします。
126 126
1002* **`MaxSessions 1` でのワンタイムコード**: ワンタイムコードのようにログインのたびにプロンプトが表示される場合、`!` コマンドは失敗します。代わりに、それらのコマンドはターミナルタブで実行してください。ターミナルタブでは、独自のペインでプロンプトが表示されます。1002* **`MaxSessions 1` でのワンタイムコード**: ワンタイムコードのようにログインのたびにプロンプトが表示される場合、`!` コマンドは失敗します。代わりに、それらのコマンドはターミナルタブで実行してください。ターミナルタブでは、独自のペインでプロンプトが表示されます。
1003* **インストールフォルダ**：Desktop は、ホームディレクトリの `~/.claude/remote/` の下にヘルパープログラムと Claude Code をインストールします。そこからそれらを実行するため、そのフォルダを `noexec` でマウントされたファイルシステム上に置くことはできません。接続する各ユーザーのホームディレクトリに約 1 GB のディスク容量を確保してください。そのフォルダに含まれる内容については、[リモートマシン上のファイルとプロセス](#files-and-processes-on-the-remote-machine)を参照してください。1003* **インストールフォルダ**：Desktop は、ホームディレクトリの `~/.claude/remote/` の下にヘルパープログラムと Claude Code をインストールします。そこからそれらを実行するため、そのフォルダを `noexec` でマウントされたファイルシステム上に置くことはできません。接続する各ユーザーのホームディレクトリに約 1 GB のディスク容量を確保してください。そのフォルダに含まれる内容については、[リモートマシン上のファイルとプロセス](#files-and-processes-on-the-remote-machine)を参照してください。
1004* **シェル**：リモートマシン上のアカウントに設定されているシェルは、Bash、Zsh、`sh` と同様に、SSH 経由で送信されたコマンドを実行できる必要があります1004* **シェル**：リモートマシン上のアカウントに設定されているシェルは、Bash、Zsh、`sh` と同様に、SSH 経由で送信されたコマンドを実行できる必要があります
10051005* **ネットワーク**：Claude Code はリモートマシンで実行され、そこからネットワークリクエストを行うため、マシンには [Claude Code が必要とするネットワークアクセス](https://code.claude.com/docs/ja/network-config.md#network-access-requirements)が必要です。マシンが Claude Code をダウンロードできない場合、Desktop はコンピューター上でダウンロードしてアップロードします。Claude Code のその他のリクエストは引き続きリモートマシンから送信されます。Linux のリモートマシンで、それらのリクエストにプロキシが必要な場合は、[SSH セッション用に設定してください](#set-a-proxy-or-a-ca-certificate-for-ssh-sessions)。* **ネットワーク**: Claude Code はリモートマシン上で実行され、そこからネットワークリクエストを送信するため、マシンには [Claude Code が必要とするネットワークアクセス](https://code.claude.com/docs/ja/network-config.md#network-access-requirements)が必要です。マシンが Claude Code をダウンロードできない場合、Desktop が自分のコンピューターでダウンロードしてアップロードします。Claude Code のその他のリクエストは引き続きリモートマシンから送信されます。Linux のリモートマシンでプロキシや CA 証明書が必要な場合は、[SSH セッション用に設定](#set-a-proxy-or-a-ca-certificate-for-ssh-sessions)してください。
1006 1006
1007#### リモートマシンのホスト鍵を確認する1007#### リモートマシンのホスト鍵を確認する
1008 1008
1030 1030
1031Linux のリモートマシンがプロキシ経由でインターネットに接続する場合、または CA 証明書が必要な場合は、そのマシン上の `~/.claude/settings.json` の `env` に[プロキシと CA の変数](https://code.claude.com/docs/ja/network-config.md)を追加してください。そのマシンの `~/.profile`、`~/.bash_profile`、`~/.zprofile`、または `~/.zshrc` ですでにエクスポートしている場合でも追加してください。1031Linux のリモートマシンがプロキシ経由でインターネットに接続する場合、または CA 証明書が必要な場合は、そのマシン上の `~/.claude/settings.json` の `env` に[プロキシと CA の変数](https://code.claude.com/docs/ja/network-config.md)を追加してください。そのマシンの `~/.profile`、`~/.bash_profile`、`~/.zprofile`、または `~/.zshrc` ですでにエクスポートしている場合でも追加してください。
1032 1032
10331033SSH セッションでは、そのマシンのターミナルで実行した `claude` にはそれらのファイルの変数が渡される場合でも、Claude Code には渡されません。その結果、セッションがハングしたり、**The connection from … to the API failed** や **Authentication failed** が表示されたりすることがあり、再度サインインしても解決しません。SSH セッションでは、そのマシンのターミナルで実行する `claude` には変数が渡される場合でも、Claude Code にはこれらのファイルの変数が渡されません。その結果、セッションがハングしたり、**The connection from … to the API failed**、**Authentication failed**、**Claude Code on … couldn’t verify the API connection’s certificate** と表示されたりすることがあります。再度サインインしても解決しません。
1034 1034
1035**1. 変数を追加する**1035**1. 変数を追加する**
1036 1036
1948 1948
1949管理ソースのみが設定できる権限、プラグイン、および配信キーについては、[管理設定のみが設定できるキー](https://code.claude.com/docs/ja/managed-settings.md#managed-only-settings)を参照してください。1949管理ソースのみが設定できる権限、プラグイン、および配信キーについては、[管理設定のみが設定できるキー](https://code.claude.com/docs/ja/managed-settings.md#managed-only-settings)を参照してください。
1950 1950
1951#### Code タブで動作が異なる Claude Code 設定
1952
1953ローカルセッションでは、Code タブがターミナルインターフェースを置き換えるため、以下のキーをはじめとする一部のキーは、効果が異なるか、目に見える効果がありません。これらのキーはターミナルでは引き続き適用されるため、設定したままにしておいてかまいません。
1954
1955| キー | ローカルセッションでの動作 |
1956| - | - |
1957| `askUserQuestionTimeout` | タイムアウトは適用されないため、Claude からの質問はユーザーが回答するまで開いたままになります |
1958| `awaySummaryEnabled` | このキーは効果がありません |
1959| `bashEditDiffEnabled` | Code タブには、Bash コマンドが変更したファイルの一覧は表示されません |
1960| `companyAnnouncements` | Code タブにはアナウンスは表示されません |
1961| `defaultShell` | ユーザーが`!`の後に入力したコマンドは、アプリが選択するシェルで実行されます。macOS と Linux ではユーザーのログインシェル、Windows では PowerShell です |
1962| `fileSuggestion` | `@`ファイルピッカーは独自のファイルリストを作成し、設定したコマンドは実行しません |
1963| `modelPicker` | モデルピッカーには、各ユーザーのアカウントで利用可能なモデルが表示されます。これを制限するには、[`availableModels`](https://code.claude.com/docs/ja/model-config#restrict-model-selection)を設定します。 |
1964| `pluginTrustMessage` | ユーザーがプラグインをインストールするときに表示される警告には、設定したメッセージは含まれません |
1965| `prUrlTemplate` | プルリクエストのリンクには、テンプレートではなくプルリクエスト自体の URL が使用されます |
1966| `respectGitignore` | `@`ファイルピッカーは独自のファイルリストを作成し、このキーは読み取りません |
1967| `respondToBashCommands` | 値に関係なく、Claude はユーザーが`!`で実行したコマンドの出力に応答します |
1968| `showClearContextOnPlanAccept` | ユーザーがプランを承認するときに、コンテキストをクリアするオプションは表示されません |
1969| `skipDangerousModePermissionPrompt` | Code タブには[Bypass permissions モード](#choose-a-permission-mode)用の独自の確認があり、このキーではその確認をスキップできません |
1970| `verbose`、`viewMode` | 各ユーザーが[セッションメニューの **Transcript view**](#switch-view-modes)でビューを選択します |
1971| `worktree.baseRef`、`worktree.sparsePaths`、`worktree.symlinkDirectories` | Code タブがセッション用に作成する worktree には使用されません |
1972
1951### デバイス管理ポリシー1973### デバイス管理ポリシー
1952 1974
1953IT チームは、macOS の MDM、Windows のグループポリシー、または Linux のポリシーファイルを通じてデスクトップアプリを管理できます。利用可能なポリシーには、Claude Code 機能の有効化または無効化、macOS と Windows での自動更新の制御、およびカスタムデプロイ URL の設定が含まれます。1975IT チームは、macOS の MDM、Windows のグループポリシー、または Linux のポリシーファイルを通じてデスクトップアプリを管理できます。利用可能なポリシーには、Claude Code 機能の有効化または無効化、macOS と Windows での自動更新の制御、およびカスタムデプロイ URL の設定が含まれます。
2100* プロジェクト内の **[CLAUDE.md](https://code.claude.com/docs/ja/memory.md)** および `CLAUDE.local.md` ファイルは両方で使用されます2122* プロジェクト内の **[CLAUDE.md](https://code.claude.com/docs/ja/memory.md)** および `CLAUDE.local.md` ファイルは両方で使用されます
2101* `~/.claude.json` または `.mcp.json` で設定された **[MCP サーバー](https://code.claude.com/docs/ja/mcp.md)** は両方で機能します2123* `~/.claude.json` または `.mcp.json` で設定された **[MCP サーバー](https://code.claude.com/docs/ja/mcp.md)** は両方で機能します
2102* 設定で定義された **[フック](https://code.claude.com/docs/ja/hooks.md)** および **[スキル](https://code.claude.com/docs/ja/skills.md)** は両方に適用されます2124* 設定で定義された **[フック](https://code.claude.com/docs/ja/hooks.md)** および **[スキル](https://code.claude.com/docs/ja/skills.md)** は両方に適用されます
21032125* `~/.claude.json` および `~/.claude/settings.json` の **[設定](https://code.claude.com/docs/ja/settings.md)** は共有されます。`settings.json` の権限ルール、許可されたツール、およびその他の設定は Desktop セッションに適用されます。* `~/.claude.json` および `~/.claude/settings.json` の **[設定](https://code.claude.com/docs/ja/settings.md)** は共有されます。`settings.json` の権限ルール、許可されたツール、およびその他の設定は Desktop セッションに適用されます。一部のキーは[コードタブでは異なる動作をします](#claude-code-settings-that-behave-differently-in-the-code-tab)。
2104* **モデル**：同じ[モデル](https://code.claude.com/docs/ja/model-config.md#available-models)が両方で利用可能です。Desktop では、プロンプトボックスの下の行にあるモデルピッカーからモデルを選択します。セッション中にも同じピッカーからモデルを変更できます。2126* **モデル**：同じ[モデル](https://code.claude.com/docs/ja/model-config.md#available-models)が両方で利用可能です。Desktop では、プロンプトボックスの下の行にあるモデルピッカーからモデルを選択します。セッション中にも同じピッカーからモデルを変更できます。
2105 2127
2106#### Claude Desktop チャットアプリからの MCP サーバー2128#### Claude Desktop チャットアプリからの MCP サーバー
2281 2303
2282ファイルには環境内の名前やその他の詳細が含まれる可能性があるため、送信する前に内容を確認してください。`<host>` と `<user>` は、Desktop が置き換えた名前を表します。Desktop はすべての名前を置き換えるわけではなく、SSH のホスト名やユーザー名が記述されたまま表示される場合もあります。zip ファイルを誰かに送信する場合は、ログにホスト名が記載されていない可能性があるため、どのホストでいつ失敗したかを伝えてください。2304ファイルには環境内の名前やその他の詳細が含まれる可能性があるため、送信する前に内容を確認してください。`<host>` と `<user>` は、Desktop が置き換えた名前を表します。Desktop はすべての名前を置き換えるわけではなく、SSH のホスト名やユーザー名が記述されたまま表示される場合もあります。zip ファイルを誰かに送信する場合は、ログにホスト名が記載されていない可能性があるため、どのホストでいつ失敗したかを伝えてください。
2283 2305
22842306zip ファイルには、Desktop がリモートマシンにインストールするヘルパープログラムのログは含まれていません。そのログも取得するには、接続したユーザーのホームディレクトリにある [`~/.claude/remote/run/`](#files-and-processes-on-the-remote-machine) 配下のヘルパーのフォルダから `remote-server.log` をコピーします。このファイルも送信する前に内容を確認してください。zip ファイルには、Desktop がリモートマシンにインストールするヘルパープログラムのログは含まれていません。そのログも取得するには、接続したユーザーのホームディレクトリにある [`~/.claude/remote/run/`](#files-and-processes-on-the-remote-machine) 配下のヘルパーのフォルダから、以下のファイルをコピーします：
2307
2308* **`remote-server.log`**：ヘルパーの最新の実行のログです。
2309* **`remote-server.log.old`**（存在する場合）：その前の実行のログです。Desktop が次回接続してヘルパーを再起動する必要が生じると失われるため、できるだけ早くコピーしてください。
2310
2311これらのファイルも送信する前に内容を確認してください。
2285 2312
2286### アプリが終了しない2313### アプリが終了しない
2287 2314