desktop.md +32 −5
120 120
121> [!NOTE]121> [!NOTE]
122>122>
123123> 在 [SSH 工作階段](#ssh-sessions)中，Claude 無法在「瀏覽器」窗格中開啟您的應用程式，因為它在那裡沒有該窗格的工具。若要自行查看應用程式，請[將其連接埠轉送到您的電腦](#reach-a-port-on-the-remote-machine)。> 在 [SSH 工作階段](#ssh-sessions)中，Claude 沒有「瀏覽器」窗格的工具，因此無法在該窗格中開啟您的應用程式，也無法[自動驗證](#auto-verify-changes)其變更。該窗格的**開發伺服器**選單和您[已設定的預覽伺服器](#configure-preview-servers)也無法使用。若要自行查看應用程式，請在遠端機器上啟動其伺服器，然後[將其連接埠轉送到您的電腦](#reach-a-port-on-the-remote-machine)。
124 124
125如果 Claude 在本機工作階段中啟動伺服器後「瀏覽器」窗格沒有開啟，請點擊聊天中該伺服器卡片上的**開啟**。125如果 Claude 在本機工作階段中啟動伺服器後「瀏覽器」窗格沒有開啟，請點擊聊天中該伺服器卡片上的**開啟**。
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* **Shell**：遠端機器上為您帳戶設定的 shell 必須能執行透過 SSH 傳送的命令，如同 Bash、Zsh 和 `sh`1004* **Shell**：遠端機器上為您帳戶設定的 shell 必須能執行透過 SSH 傳送的命令，如同 Bash、Zsh 和 `sh`
10051005* **網路**：Claude Code 在遠端機器上執行，並從該處發出網路請求，因此該機器需要 [Claude Code 所需的網路存取](https://code.claude.com/docs/zh-TW/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/zh-TW/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
1031如果 Linux 遠端機器透過代理伺服器連上網際網路或需要 CA 憑證，請在該機器的 `~/.claude/settings.json` 中的 `env` 下加入[代理伺服器和 CA 變數](https://code.claude.com/docs/zh-TW/network-config.md)。即使您已在該機器的 `~/.profile`、`~/.bash_profile`、`~/.zprofile` 或 `~/.zshrc` 中匯出這些變數，也請加入。1031如果 Linux 遠端機器透過代理伺服器連上網際網路或需要 CA 憑證，請在該機器的 `~/.claude/settings.json` 中的 `env` 下加入[代理伺服器和 CA 變數](https://code.claude.com/docs/zh-TW/network-config.md)。即使您已在該機器的 `~/.profile`、`~/.bash_profile`、`~/.zprofile` 或 `~/.zshrc` 中匯出這些變數，也請加入。
1032 1032
10331033在 SSH 工作階段中，即使該機器終端機中的 `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/zh-TW/managed-settings.md#managed-only-settings)。1949有關只有受管來源可以設定的權限、外掛和傳遞鍵，請參閱[只有受管設定可以設定的鍵](https://code.claude.com/docs/zh-TW/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` | 使用者在 `!` 之後輸入的命令會在應用程式選擇的 shell 中執行：macOS 和 Linux 上為其登入 shell，Windows 上為 PowerShell |
1962| `fileSuggestion` | `@` 檔案選擇器會建立自己的檔案清單，不會執行您設定的命令 |
1963| `modelPicker` | 模型選擇器會列出每位使用者帳戶可用的模型。若要限制這些模型，請設定 [`availableModels`](https://code.claude.com/docs/zh-TW/model-config#restrict-model-selection)。 |
1964| `pluginTrustMessage` | 使用者安裝外掛時看到的警告不會包含您設定的訊息 |
1965| `prUrlTemplate` | pull request 連結使用 pull request 本身的 URL，而非範本 |
1966| `respectGitignore` | `@` 檔案選擇器會建立自己的檔案清單，不會讀取此鍵 |
1967| `respondToBashCommands` | 無論值為何，Claude 都會回應使用者以 `!` 執行的命令輸出 |
1968| `showClearContextOnPlanAccept` | 使用者核准計畫時不會有清除上下文的選項 |
1969| `skipDangerousModePermissionPrompt` | Code 分頁對[略過權限模式](#choose-a-permission-mode)有自己的確認步驟，此鍵不會略過該確認 |
1970| `verbose`、`viewMode` | 每位使用者在[工作階段選單中的**逐字稿檢視**](#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/zh-TW/memory.md)** 和 `CLAUDE.local.md` 檔案在您的專案中由兩者使用2122* **[CLAUDE.md](https://code.claude.com/docs/zh-TW/memory.md)** 和 `CLAUDE.local.md` 檔案在您的專案中由兩者使用
2101* 在 `~/.claude.json` 或 `.mcp.json` 中設定的 **[MCP 伺服器](https://code.claude.com/docs/zh-TW/mcp.md)** 在兩者中都有效2123* 在 `~/.claude.json` 或 `.mcp.json` 中設定的 **[MCP 伺服器](https://code.claude.com/docs/zh-TW/mcp.md)** 在兩者中都有效
2102* 在設定中定義的 **[Hooks](https://code.claude.com/docs/zh-TW/hooks.md)** 和 **[skills](https://code.claude.com/docs/zh-TW/skills.md)** 適用於兩者2124* 在設定中定義的 **[Hooks](https://code.claude.com/docs/zh-TW/hooks.md)** 和 **[skills](https://code.claude.com/docs/zh-TW/skills.md)** 適用於兩者
21032125* `~/.claude.json` 和 `~/.claude/settings.json` 中的 **[設定](https://code.claude.com/docs/zh-TW/settings.md)** 是共用的。`settings.json` 中的權限規則、允許的工具和其他設定適用於 Desktop 工作階段。* `~/.claude.json` 和 `~/.claude/settings.json` 中的 **[設定](https://code.claude.com/docs/zh-TW/settings.md)** 是共用的。`settings.json` 中的權限規則、允許的工具和其他設定適用於 Desktop 工作階段。部分設定鍵[在 Code 標籤中的行為不同](#claude-code-settings-that-behave-differently-in-the-code-tab)。
2104* **模型**：相同的[模型](https://code.claude.com/docs/zh-TW/model-config.md#available-models)在兩者中都可用。在 Desktop 中，從提示詞方塊下方列中的模型選擇器選擇模型。您可以在工作階段期間從相同的選擇器變更模型。2126* **模型**：相同的[模型](https://code.claude.com/docs/zh-TW/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