desktop.md +30 −3
116 116
117Claude 可以啟動開發伺服器並在「瀏覽器」窗格中開啟它以驗證其變更。這適用於前端網路應用程式以及後端伺服器:Claude 可以測試 API 端點、檢視伺服器日誌,並對它發現的問題進行迭代。在大多數情況下,Claude 在編輯專案檔案後會自動啟動伺服器。您也可以隨時要求 Claude 進行預覽。預設情況下,Claude [自動驗證](#auto-verify-changes)每次編輯後的變更。117Claude 可以啟動開發伺服器並在「瀏覽器」窗格中開啟它以驗證其變更。這適用於前端網路應用程式以及後端伺服器:Claude 可以測試 API 端點、檢視伺服器日誌,並對它發現的問題進行迭代。在大多數情況下,Claude 在編輯專案檔案後會自動啟動伺服器。您也可以隨時要求 Claude 進行預覽。預設情況下,Claude [自動驗證](#auto-verify-changes)每次編輯後的變更。
118 118
119119在本機工作階段中,點擊聊天中的 HTML、PDF 或影片路徑,即可在「瀏覽器」窗格中開啟它。在本機工作階段中,點擊聊天中的 HTML、PDF 或影片路徑,即可在「瀏覽器」窗格中開啟它。在 SSH 或 WSL 工作階段中,您可以[預覽 HTML 檔案](#preview-html-files-in-ssh-and-wsl-sessions)。
120 120
121> [!NOTE]121> [!NOTE]
122>122>
137 137
138若要清除「瀏覽器」已儲存的資料,請在「瀏覽器」窗格的 **⋮** 選單中選擇**清除瀏覽資料**。若要完全關閉「瀏覽器」,請在**設定 > Code** 或**設定 > Claude Code** 中關閉**瀏覽器工具**。138若要清除「瀏覽器」已儲存的資料,請在「瀏覽器」窗格的 **⋮** 選單中選擇**清除瀏覽資料**。若要完全關閉「瀏覽器」,請在**設定 > Code** 或**設定 > Claude Code** 中關閉**瀏覽器工具**。
139 139
140#### 在 SSH 和 WSL 工作階段中預覽 HTML 檔案
141
142在 [SSH](#ssh-sessions) 或 [WSL](https://code.claude.com/docs/zh-TW/desktop-wsl.md) 工作階段中,點擊聊天中 HTML 檔案的路徑,即可在「瀏覽器」窗格中預覽該檔案。如果預覽中的圖表或表格一直是空的,預覽上方的通知會告訴您原因:
143
144* **`This preview doesn't load anything from the web`**:檔案中撰寫的指令碼會執行,但從網路載入其程式庫的圖表會保持空白。如果通知中有**匯出**按鈕,請選擇它,並在您的瀏覽器中開啟儲存的檔案,在那裡來自網路的內容會載入。
145* **`This preview doesn't run scripts or load anything from the web`**:在 Claude Desktop v4.23118.0 之前,這些預覽不會執行指令碼,因此請更新 Desktop 並再次開啟該檔案。如果 Desktop 已是最新版本而通知仍然存在,請重新啟動 Desktop。如果通知依然存在,指令碼可能已[為您的組織關閉](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization),請詢問您的管理員。
146
147如果您關閉了通知,請再次開啟該檔案以重新顯示它。
148
149#### 為您的組織關閉 SSH 和 WSL 預覽中的指令碼
150
151若要讓 [SSH 和 WSL 工作階段中的 HTML 預覽](#preview-html-files-in-ssh-and-wsl-sessions)不執行指令碼,請將 [`disableBrowserExternalNavigation` 受管設定](#managed-settings)設定為 `true`。使用此設定後,使用者也無法在「瀏覽器」窗格中[瀏覽外部網站](#restrict-external-browsing-for-your-organization)。
152
153請在您的[伺服器受管設定](https://code.claude.com/docs/zh-TW/server-managed-settings.md)中設定它,或在執行 Desktop 的電腦上的 [Claude Code MDM 政策或受管設定檔](https://code.claude.com/docs/zh-TW/managed-settings.md#where-each-mechanism-stores-the-policy)中設定它。Desktop 不會從遠端機器或 WSL 發行版讀取此設定。使用[第三方供應商](https://code.claude.com/docs/zh-TW/third-party-integrations.md)時,請使用 MDM 政策或該檔案。
154
155> [!WARNING]
156>
157> 如果執行 Desktop 的電腦尚未接收任何 Claude Code 受管設定,請同時在您建立的受管設定中將 [`parentSettingsBehavior`](https://code.claude.com/docs/zh-TW/settings-reference#parentsettingsbehavior) 設定為 `"merge"`。Desktop 會將其自身的政策傳遞給 Claude Code,若沒有 `"merge"`,一旦電腦有受管設定,Claude Code 就會[忽略該政策](https://code.claude.com/docs/zh-TW/managed-settings.md#let-an-embedding-host-add-policy)。在 Windows 上,如果您建立受管設定檔,使用者也會失去 WSL 工作階段,直到您[允許它們](https://code.claude.com/docs/zh-TW/admin-setup.md#wsl-sessions-in-claude-code-desktop)為止。
158>
159> 如果電腦已接收 Claude Code 受管設定,請將此設定新增至那些設定中,並保留其中的 `parentSettingsBehavior` 不變。在具有多個 MDM 政策或受管設定檔的電腦上,請使用[優先順序最高的那一個](https://code.claude.com/docs/zh-TW/managed-settings.md#how-claude-code-combines-managed-sources)。
160
161接著請使用者重新啟動 Desktop 以確保設定生效,並告知他們預期的情況:
162
163* **他們開啟的檔案**:預覽不會執行指令碼,因此由指令碼繪製的圖表和表格會保持空白
164* **正在執行指令碼的預覽**:如果 Desktop 在重新啟動之前就套用了此設定,這些預覽會關閉。使用者會看到 `This preview closed because scripts are turned off for previews. Open the file again to view it without scripts.`
165* **他們匯出的檔案**:如果使用者[匯出檔案](#preview-html-files-in-ssh-and-wsl-sessions)並在瀏覽器中開啟,無論是否有此設定,其指令碼都會在那裡執行
166
140### 瀏覽外部網站167### 瀏覽外部網站
141 168
142「瀏覽器」窗格是一個標籤式瀏覽器,因此您可以在執行中的應用程式旁邊開啟文件、問題追蹤器或任何其他網站。若要開啟「瀏覽器」,請在 macOS 上按 **Cmd+Shift+B**,或在 Windows 上按 **Ctrl+Shift+B**,或點擊工作階段標題列中的**瀏覽器**。您可以登入窗格中的網站,包括彈出式登入流程,例如 Google OAuth。169「瀏覽器」窗格是一個標籤式瀏覽器,因此您可以在執行中的應用程式旁邊開啟文件、問題追蹤器或任何其他網站。若要開啟「瀏覽器」,請在 macOS 上按 **Cmd+Shift+B**,或在 Windows 上按 **Ctrl+Shift+B**,或點擊工作階段標題列中的**瀏覽器**。您可以登入窗格中的網站,包括彈出式登入流程,例如 Google OAuth。
162 189
163「瀏覽器」遵循與 Claude in Chrome 擴充功能相同的[網站允許清單和封鎖清單控制](https://support.claude.com/en/articles/13065128-claude-in-chrome-admin-controls)。如果您的組織已為擴充功能設定了這些清單,「瀏覽器」會自動尊重它們。管理員也可以使用 [`browserExternalPageTools` 受管設定](#managed-settings)關閉 Claude 在外部頁面上的工具。停用工具後,使用者仍然可以導航到外部網站;Claude 的工具無法讀取或對其進行操作。190「瀏覽器」遵循與 Claude in Chrome 擴充功能相同的[網站允許清單和封鎖清單控制](https://support.claude.com/en/articles/13065128-claude-in-chrome-admin-controls)。如果您的組織已為擴充功能設定了這些清單,「瀏覽器」會自動尊重它們。管理員也可以使用 [`browserExternalPageTools` 受管設定](#managed-settings)關閉 Claude 在外部頁面上的工具。停用工具後,使用者仍然可以導航到外部網站;Claude 的工具無法讀取或對其進行操作。
164 191
165192若要完全關閉外部瀏覽,請將 [`disableBrowserExternalNavigation` 受管設定](#managed-settings)設定為 `true`。這會阻止「瀏覽器」中的所有外部導航,包括您的組織允許清單上的網站;localhost 開發伺服器和檔案預覽保持運作。使用 `browserExternalPageTools` 讓使用者繼續瀏覽外部網站而不使用 Claude 的工具,並使用 `disableBrowserExternalNavigation` 為使用者和 Claude 阻止外部網站。若要完全關閉外部瀏覽,請將 [`disableBrowserExternalNavigation` 受管設定](#managed-settings)設定為 `true`。這會阻止「瀏覽器」中的所有外部導航,包括您的組織允許清單上的網站。localhost 開發伺服器和檔案預覽保持運作,但 [SSH 和 WSL 工作階段中的 HTML 預覽](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization)不會執行指令碼。使用 `browserExternalPageTools` 讓使用者繼續瀏覽外部網站而不使用 Claude 的工具,並使用 `disableBrowserExternalNavigation` 為使用者和 Claude 阻止外部網站。
166 193
167### 使用差異檢視檢查變更194### 使用差異檢視檢查變更
168 195
2009| `autoMode` | 自訂自動模式分類器在您的組織中信任和封鎖的內容。請參閱[設定自動模式](https://code.claude.com/docs/zh-TW/auto-mode-config.md)。 |2036| `autoMode` | 自訂自動模式分類器在您的組織中信任和封鎖的內容。請參閱[設定自動模式](https://code.claude.com/docs/zh-TW/auto-mode-config.md)。 |
2010| `browserExternalPageTools` | 設定為 `"disabled"` 以防止 Claude 使用工具來讀取或操作[瀏覽器窗格](#browse-external-sites)中的外部頁面。使用者仍然可以自行瀏覽外部網站,本機開發伺服器預覽不受影響。 |2037| `browserExternalPageTools` | 設定為 `"disabled"` 以防止 Claude 使用工具來讀取或操作[瀏覽器窗格](#browse-external-sites)中的外部頁面。使用者仍然可以自行瀏覽外部網站,本機開發伺服器預覽不受影響。 |
2011| `disableMobileSimulatorTools` | 設定為 `true` 以封鎖 Claude 在 [iOS Simulator 窗格](https://code.claude.com/docs/zh-TW/desktop-ios-simulator.md#turn-off-simulator-access)中控制和擷取裝置的工具。該窗格仍可供使用者自行點擊使用;只有 Claude 的存取被移除。該值必須是 JSON 布林值 `true`;字串 `"true"` 會被忽略。 |2038| `disableMobileSimulatorTools` | 設定為 `true` 以封鎖 Claude 在 [iOS Simulator 窗格](https://code.claude.com/docs/zh-TW/desktop-ios-simulator.md#turn-off-simulator-access)中控制和擷取裝置的工具。該窗格仍可供使用者自行點擊使用;只有 Claude 的存取被移除。該值必須是 JSON 布林值 `true`;字串 `"true"` 會被忽略。 |
20122039| `disableBrowserExternalNavigation` | 設定為 `true` 以完全關閉[瀏覽器窗格](#browse-external-sites)中的外部瀏覽。使用者和 Claude 都無法瀏覽外部網站,localhost 開發伺服器預覽不受影響。該值必須是 JSON 布林值 `true`;字串 `"true"` 會被忽略。 || `disableBrowserExternalNavigation` | 設定為 `true` 以完全關閉[瀏覽器窗格](#browse-external-sites)中的外部瀏覽。使用者和 Claude 都無法瀏覽外部網站,localhost 開發伺服器預覽不受影響。SSH 和 WSL 工作階段中的 HTML 預覽[不會執行指令碼](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization)。該值必須是 JSON 布林值 `true`;字串 `"true"` 會被忽略。 |
2013| `sshConfigs` | 預先設定顯示在環境下拉式選單中的 [SSH 連線](#pre-configure-ssh-connections-for-your-team)。使用者無法刪除受管連線,除了自己的 **Worktree folder** 之外也無法編輯任何內容。 |2040| `sshConfigs` | 預先設定顯示在環境下拉式選單中的 [SSH 連線](#pre-configure-ssh-connections-for-your-team)。使用者無法刪除受管連線,除了自己的 **Worktree folder** 之外也無法編輯任何內容。 |
2014| `sshHostCommands` | 為使用者提供[主機來自命令的 SSH 連線](#distribute-commands-to-your-team),與使用者自己的連線並存。Desktop 從電腦上的受管設定檔案或 MDM 原則讀取此鍵,並在[伺服器管理的設定](https://code.claude.com/docs/zh-TW/server-managed-settings.md)中忽略它。需要在 macOS 或 Linux 上使用 Claude Desktop v3.6556.0 或更新版本,或在 Windows 上使用 v4.16336.0 或更新版本,並以 Claude 帳戶登入。在 Windows 上,Desktop 還必須[透過 OpenSSH 用戶端連線](#use-your-ssh-configuration)。 |2041| `sshHostCommands` | 為使用者提供[主機來自命令的 SSH 連線](#distribute-commands-to-your-team),與使用者自己的連線並存。Desktop 從電腦上的受管設定檔案或 MDM 原則讀取此鍵,並在[伺服器管理的設定](https://code.claude.com/docs/zh-TW/server-managed-settings.md)中忽略它。需要在 macOS 或 Linux 上使用 Claude Desktop v3.6556.0 或更新版本,或在 Windows 上使用 v4.16336.0 或更新版本,並以 Claude 帳戶登入。在 Windows 上,Desktop 還必須[透過 OpenSSH 用戶端連線](#use-your-ssh-configuration)。 |
2015| `sshHostAllowlist` | 將 [SSH 工作階段](#restrict-which-ssh-hosts-users-can-connect-to)限制在已解析主機名稱符合這些模式之一的主機。僅從受管設定讀取。 |2042| `sshHostAllowlist` | 將 [SSH 工作階段](#restrict-which-ssh-hosts-users-can-connect-to)限制在已解析主機名稱符合這些模式之一的主機。僅從受管設定讀取。 |