44 開始會話44 開始會話
45</h2>45</h2>
46 46
47在發送第一條訊息之前，在提示區域中配置四項內容：47在傳送第一則訊息之前，請在提示詞方塊下方的列中選擇環境、專案資料夾、權限模式和模型：
48 48
49* **環境**：選擇 Claude 執行的位置。選擇 **Local** 用於您的機器、**Cloud** 用於[雲端工作階段](#cloud-sessions)（在您關閉應用程式後仍會繼續），[**SSH 連線**](#ssh-sessions)用於您管理的遠端機器，或在 Windows 上選擇 [**WSL 發行版**](/docs/zh-TW/desktop-wsl)。SSH 工作階段中的任務可以[在 Desktop 中斷連線時繼續執行](#keep-a-task-running-while-desktop-is-disconnected)，但若使用 Claude 帳戶，任務可能會在登入過期時停止。請參閱[環境設定](#environment-configuration)。49* **環境**：使用環境選擇器（該列中的第一個控制項）選擇 Claude 執行的位置。請參閱[環境設定](#environment-configuration)。
50* **專案資料夾**：選擇 Claude 工作的資料夾或儲存庫。對於雲端會話，您可以新增[多個儲存庫](#run-long-running-tasks-in-the-cloud)。50 * 如果新工作階段的提示詞方塊下方沒有環境選擇器，請依照[舊版版面配置的步驟](#check-which-layout-you-have)操作。
51* **模型**：從傳送按鈕旁的下拉式選單中選擇[模型](/docs/zh-TW/model-config#available-models)。您可以在會話期間變更此設定。51* **專案資料夾**：點擊環境選擇器旁的專案資料夾控制項，選擇 Claude 工作的資料夾。
52* **權限模式**：從[模式選擇器](#choose-a-permission-mode)中選擇 Claude 擁有多少自主權。您可以在會話期間變更此設定。52 * **雲端工作階段**：選擇[儲存庫](#run-long-running-tasks-in-the-cloud)而非資料夾
53 * **[已儲存的本機或 SSH 環境](#create-a-saved-environment)**：該環境已包含其資料夾，因此該列不會顯示專案資料夾控制項。若要變更資料夾，請[編輯環境](#use-edit-or-remove-a-saved-environment)。
54* **權限模式**：使用[模式選擇器](#choose-a-permission-mode)選擇 Claude 擁有多少自主權。您可以在工作階段期間變更權限模式。
55* **模型**：從該列靠右側的模型選擇器中選擇[模型](/docs/zh-TW/model-config#available-models)。您可以在工作階段期間變更模型。
53 56
54輸入您的任務並按 **Enter** 開始。每個會話都會追蹤自己的上下文並獨立進行變更。57輸入您的任務並按 **Enter** 開始。每個會話都會追蹤自己的上下文並獨立進行變更。
55 58
82 將檔案和背景資訊新增至提示詞85 將檔案和背景資訊新增至提示詞
83</h3>86</h3>
84 87
85提示詞輸入框支援兩種方式來引入外部背景資訊：88若要將檔案提供給 Claude，請在提示詞輸入框中 @mention 該檔案或將其附加：
86 89
87* **@mention 檔案**：輸入 `@` 後跟檔案名稱，將檔案新增至對話背景資訊。Claude 隨後可以讀取並參考該檔案。@mention 在雲端或 WSL 工作階段中不可用。90* **@mention 檔案**：輸入 `@` 後跟檔案名稱，將檔案新增至對話背景資訊。
88* **附加檔案**：使用附件按鈕將影像、PDF 和其他檔案附加到您的提示詞，或直接將檔案拖放到提示詞中。這對於分享錯誤的螢幕截圖、設計模型或參考文件很有用。91 * **在雲端工作階段中**：`@` 只有在您傳送第一則訊息後才能列出檔案。如果 `@` 沒有列出任何檔案，請先在不附帶該檔案的情況下傳送第一則訊息，然後在下一則訊息中 @mention 該檔案。
92* **附加檔案**：使用提示詞輸入框旁的 **+** 按鈕將影像、PDF 和其他檔案附加到您的提示詞，或直接將檔案拖放到提示詞中。這對於分享錯誤的螢幕截圖、設計模型或參考文件很有用。
93 * **在 [WSL 工作階段](/docs/zh-TW/desktop-wsl)中**：如果 **+** 選單顯示的是**新增影像**而不是**新增檔案或相片**，則您只能附加影像。若要將工作階段資料夾中的任何其他檔案提供給 Claude，請 @mention 該檔案。
89 94
90<h3 id="choose-a-permission-mode">95<h3 id="choose-a-permission-mode">
91 選擇權限模式96 選擇權限模式
92</h3>97</h3>
93 98
94權限模式控制 Claude 在工作階段期間的自主程度：它是否在編輯檔案、執行命令或兩者之前詢問。您可以隨時使用傳送按鈕旁的模式選擇器切換權限模式。若要自行核准每項變更，請切換至「手動」。99權限模式控制 Claude 在工作階段期間的自主程度：它是否在編輯檔案、執行命令或兩者之前詢問。您可以隨時使用提示詞輸入框下方那一列中的模式選擇器切換權限模式。若要自行核准每項變更，請切換至「手動」。
95 100
96若要為新的本機工作階段設定預設模式，請將 `permissions.defaultMode` 新增至您的[設定檔](/docs/zh-TW/settings#where-settings-live)。桌面應用程式讀取與 CLI 相同的設定檔。您在選擇器中選擇的模式會記住每個資料夾，並優先於該資料夾的 `defaultMode`，但 Plan 除外，它僅適用於目前工作階段。101若要為新的本機工作階段設定預設模式，請將 `permissions.defaultMode` 新增至您的[設定檔](/docs/zh-TW/settings#where-settings-live)。桌面應用程式讀取與 CLI 相同的設定檔。您在選擇器中選擇的模式會記住每個資料夾，並優先於該資料夾的 `defaultMode`，但 Plan 除外，它僅適用於目前工作階段。
97 102
129 134
130Claude 可以啟動開發伺服器並在「瀏覽器」窗格中開啟它以驗證其變更。這適用於前端網路應用程式以及後端伺服器：Claude 可以測試 API 端點、檢視伺服器日誌，並對它發現的問題進行迭代。在大多數情況下，Claude 在編輯專案檔案後會自動啟動伺服器。您也可以隨時要求 Claude 進行預覽。預設情況下，Claude [自動驗證](#auto-verify-changes)每次編輯後的變更。135Claude 可以啟動開發伺服器並在「瀏覽器」窗格中開啟它以驗證其變更。這適用於前端網路應用程式以及後端伺服器：Claude 可以測試 API 端點、檢視伺服器日誌，並對它發現的問題進行迭代。在大多數情況下，Claude 在編輯專案檔案後會自動啟動伺服器。您也可以隨時要求 Claude 進行預覽。預設情況下，Claude [自動驗證](#auto-verify-changes)每次編輯後的變更。
131 136
132「瀏覽器」窗格也可以從您的專案中開啟靜態 HTML 檔案、PDF、影像和影片。在聊天中點擊 HTML、PDF、影像或影片路徑以在那裡開啟它。137在本機工作階段中，點擊聊天中的 HTML、PDF 或影片路徑，即可在「瀏覽器」窗格中開啟它。
133 138
134<Note>139<Note>
135 在 [SSH 工作階段](#ssh-sessions)中，Claude 無法在「瀏覽器」窗格中開啟您的應用程式，因為它在那裡沒有該窗格的工具。若要自行查看應用程式，請[將其連接埠轉送到您的電腦](#reach-a-port-on-the-remote-machine)。140 在 [SSH 工作階段](#ssh-sessions)中，Claude 無法在「瀏覽器」窗格中開啟您的應用程式，因為它在那裡沒有該窗格的工具。若要自行查看應用程式，請[將其連接埠轉送到您的電腦](#reach-a-port-on-the-remote-machine)。
136</Note>141</Note>
137 142
143如果 Claude 在本機工作階段中啟動伺服器後「瀏覽器」窗格沒有開啟，請點擊聊天中該伺服器卡片上的**開啟**。
144
138從「瀏覽器」窗格，您可以：145從「瀏覽器」窗格，您可以：
139 146
140* 直接在「瀏覽器」窗格中與執行中的應用程式互動147* 直接在「瀏覽器」窗格中與執行中的應用程式互動
185 使用差異檢視檢查變更192 使用差異檢視檢查變更
186</h3>193</h3>
187 194
188Claude 對您的程式碼進行變更後，差異檢視可讓您在建立 pull request 之前逐個檔案檢查修改。195Claude 對您的程式碼進行變更後，差異檢視可讓您在建立 pull request 之前逐個檔案檢查修改。若要開啟差異檢視，請點擊[工作階段詳細資料面板](#see-session-details)中**變更**卡片上的行數，例如 `+12 -1`。您也可以點擊工作階段標題列中的**變更**。
189
190當 Claude 變更檔案時，會出現差異統計指示器，顯示新增和移除的行數，例如 `+12 -1`。點擊此指示器以開啟差異檢視器，它在左側顯示檔案清單，在右側顯示每個檔案的變更。
191 196
192若要對特定行進行評論，請點擊差異中的任何行以開啟評論框。輸入您的意見反應並按 **Enter** 鍵以新增評論。在多行新增評論後，一次提交所有評論：197若要對特定行進行評論，請點擊差異中的任何行以開啟評論框。輸入您的意見反應並按 **Enter** 鍵以新增評論。在多行新增評論後，一次提交所有評論：
193 198
213 監控 pull request 狀態218 監控 pull request 狀態
214</h3>219</h3>
215 220
216開啟 pull request 後，CI 狀態列會出現在工作階段中。Claude Code 使用 GitHub CLI 輪詢檢查結果並顯示失敗。221若要讓 Claude 修復失敗的檢查，或讓 GitHub 合併 pull request，請開啟**自動修復**或**就緒時合併**。開啟 pull request 後，它會連同其 CI 檢查的狀態出現在[工作階段詳細資料面板](#see-session-details)的**變更**卡片中。開啟其標題旁的 **⋮** 選單：
217 222
218* **自動修復 CI 並處理評論**：啟用後，Claude 會自動嘗試透過讀取失敗輸出並進行迭代來修復失敗的 CI 檢查。在本機工作階段中，當作者是儲存庫擁有者、組織成員、協作者或 GitHub App 時，Claude 也會處理由您以外的人留下的新審查評論。223* **自動修復**：在本機工作階段中，Claude 也會處理由您以外的人留下的新審查評論。評論的作者必須是儲存庫擁有者、組織成員、協作者或 GitHub App。
219* **就緒時自動合併**：啟用後，Claude 會在所有檢查通過後合併 PR。合併方法是壓縮。首先在您的 [GitHub 儲存庫設定](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository)中啟用自動合併；沒有它，Claude 無法合併 PR。224* **就緒時合併**：為該 PR 開啟 GitHub 的自動合併。在本機工作階段中，Desktop 會請求壓縮合併，除非基礎分支使用合併佇列。
225 * **在 SSH 和 WSL 工作階段中**：**就緒時合併**已停用，因此請在 GitHub 上為該 pull request 開啟自動合併
226 * **如果儲存庫不允許自動合併**：**就緒時合併**無法開啟，因此請先在您的 [GitHub 儲存庫設定](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository)中啟用自動合併
227* **[較早的版面配置](#check-which-layout-you-have)**：工作階段有 pull request 後，點擊其狀態列上的 **CI**。
220 228
221若要開啟這些選項，請點擊狀態列中的 **CI**。若要在 PR 合併或關閉後自動封存工作階段，請在**設定 > Claude Code** 中開啟[自動封存](#work-in-parallel-with-sessions)。229若要在 PR 合併或關閉後自動封存工作階段，請在**設定 > Claude Code** 中開啟[自動封存](#archive-a-session)。
222 230
223<Note>231<Note>
224 PR 監控需要在您的機器上安裝並驗證 [GitHub CLI (`gh`)](https://cli.github.com/)。如果未安裝 `gh`，Desktop 會在您首次嘗試建立 PR 時提示您安裝它。232 PR 監控需要在您的機器上安裝並驗證 [GitHub CLI (`gh`)](https://cli.github.com/)。如果未安裝 `gh`，Desktop 會在您首次嘗試建立 PR 時提示您安裝它。
235若要跨螢幕工作，將窗格（例如差異或終端機）彈出到其自己的視窗中，完成後將其停靠回來。Claude 會在主視窗中繼續工作。243若要跨螢幕工作，將窗格（例如差異或終端機）彈出到其自己的視窗中，完成後將其停靠回來。Claude 會在主視窗中繼續工作。
236 244
237<Note>245<Note>
238 本節中的窗格佈局、終端機、檔案編輯器和檢視模式需要 Claude Desktop v1.2581.0 或更新版本。在 macOS 上開啟 **Claude → Check for Updates** 或在 Windows 上開啟 **Help → Check for Updates** 以更新。246 本節中的窗格佈局、終端機、檔案編輯器和檢視模式需要 Claude Desktop v1.2581.0 或更新版本。在 macOS 上開啟 **Claude > Check for Updates…** 或在 Windows 上開啟 **Help > Check for Updates…** 以更新。
239</Note>247</Note>
240 248
249<h3 id="see-session-details">
250 查看工作階段詳細資訊
251</h3>
252
253工作階段詳細資訊面板是聊天旁的一組卡片，顯示工作階段在何處執行、變更了什麼以及正在執行什麼。此面板會在您啟動工作階段後出現，前提是聊天區域的寬度足以容納它。
254
255<h4 id="hide-or-show-the-session-details-panel">
256 隱藏或顯示工作階段詳細資訊面板
257</h4>
258
259若要隱藏或顯示面板，請點擊工作階段標題列中的 **Hide session rail** 或 **Show session rail**，或在視窗較窄時點擊標題列 **⋮** 選單中的對應項目。如果您仍然看不到面板，請[檢查您使用的是哪種 Code 標籤佈局](#check-which-layout-you-have)。
260
241<h3 id="run-commands-in-the-terminal">261<h3 id="run-commands-in-the-terminal">
242 在終端機中執行命令262 在終端機中執行命令
243</h3>263</h3>
244 264
245整合終端機讓您在工作階段旁執行命令，而無需切換到另一個應用程式。點擊工作階段標題列中的 **Terminal**，或在 macOS 或 Windows 上按 **Ctrl+\`**。終端機在您工作階段的工作目錄中開啟，並與 Claude 共用相同的環境，因此 `npm test` 或 `git status` 等命令會看到 Claude 正在編輯的相同檔案。若要開啟第二個終端機標籤，請點擊終端機窗格標題中的 **+** 或右鍵點擊聊天中的資料夾以選擇 **Open in terminal**。265整合終端機讓您在工作階段旁執行命令，而無需切換到另一個應用程式。點擊工作階段標題列中的 **Terminal**，或在 macOS 或 Windows 上按 **Ctrl+\`**。終端機在您工作階段的工作目錄中開啟，並與 Claude 共用相同的環境，因此 `npm test` 或 `git status` 等命令會看到 Claude 正在編輯的相同檔案。若要開啟第二個終端機標籤，請點擊終端機窗格標題中的 **+** 或右鍵點擊聊天中的資料夾以選擇 **Open in terminal**。
246 266
247終端機可在本機和 [SSH](#ssh-sessions) 工作階段中使用，但在 [Windows 遠端機器](#windows-remote-machines)上有所限制。267如果 WSL 工作階段沒有終端機，請參閱[如果終端機或連接器無法使用](/docs/zh-TW/desktop-wsl#check-for-the-terminal-and-connectors)。終端機可在本機和 [SSH](#ssh-sessions) 工作階段中使用，但在 [Windows 遠端機器](#windows-remote-machines)上有所限制。
248 268
249<h3 id="open-and-edit-files">269<h3 id="open-and-edit-files">
250 開啟和編輯檔案270 開啟和編輯檔案
251</h3>271</h3>
252 272
253點擊聊天或差異檢視器中的檔案路徑以在檔案窗格中開啟它。HTML、PDF、影像和影片路徑改為在[瀏覽器窗格](#preview-your-app)中開啟。進行現場編輯並點擊 **Save** 以寫回。如果自您開啟檔案以來檔案在磁碟上已變更，窗格會警告您並讓您覆寫或放棄。點擊 **Discard** 以還原您的編輯，或點擊窗格標題中的路徑以複製絕對路徑。273若要開啟 Claude 提及的檔案，請點擊聊天中的檔案路徑。
254 274
255檔案窗格在本機和 SSH 工作階段中可用。對於雲端工作階段，請要求 Claude 進行變更。275若要自行編輯檔案，請使用[檔案窗格](#arrange-your-workspace)：
276
277* **本機工作階段**：您可以編輯工作階段工作目錄內的檔案，但某些僅供檢視的檔案除外，例如 `.mcp.json` 和 `.claude/settings.json`。若要變更這類檔案，請[在其他應用程式中開啟它](#open-files-in-other-apps)。
278* **雲端、SSH 和 WSL 工作階段**：檔案窗格僅供檢視，因此請要求 Claude 進行編輯。
279
280<h4 id="save-edits-in-the-file-pane">
281 在檔案窗格中儲存編輯
282</h4>
283
284預設情況下，您在檔案窗格中的編輯會自動儲存，因此窗格不會顯示 **Save** 按鈕。若要自行儲存編輯，請在窗格的 **⋮** 選單中取消勾選 **Auto save**。關閉 **Auto save** 後，變更檔案後點擊 **Save** 以寫入您的編輯，或點擊 **Cancel** 以還原編輯。
285
286如果窗格警告檔案已在磁碟上變更，請點擊 **Override** 以用您的編輯覆寫磁碟上的版本，或點擊 **Discard** 以捨棄您的編輯。
256 287
257<h3 id="open-files-in-other-apps">288<h3 id="open-files-in-other-apps">
258 在其他應用程式中開啟檔案289 在其他應用程式中開啟檔案
283 鍵盤快捷鍵314 鍵盤快捷鍵
284</h3>315</h3>
285 316
286在 macOS 上按 **Cmd+/** 或在 Windows 上按 **Ctrl+/** 以查看 Code 標籤中可用的所有快捷鍵。在 Windows 上，對下面的快捷鍵使用 **Ctrl** 代替 **Cmd**。工作階段循環、終端機切換和檢視模式切換在每個平台上都使用 **Ctrl**。317在 macOS 上按 **Cmd+/** 或在 Windows 上按 **Ctrl+/** 以查看 Code 標籤中可用的所有快捷鍵。本節中的表格顯示 macOS 按鍵。在 Windows 和 Linux 上，請替換以下按鍵：
318
319* **Cmd+Option**：按 **Alt**
320* **Cmd**：按 **Ctrl**
321
322工作階段循環、終端機切換和檢視模式切換在每個平台上都使用 **Ctrl**。
287 323
288| 快捷鍵 | 操作 |324| 快捷鍵 | 操作 |
289| - | - |325| - | - |
290| `Cmd` `/` | 顯示鍵盤快捷鍵 |326| `Cmd` `/` | 顯示鍵盤快捷鍵 |
291| `Cmd` `N` | 新工作階段 |327| `Cmd` `N` | 新工作階段 |
328| `Cmd` `Option` `1`–`9` | 在[目前佈局](#check-which-layout-you-have)的新工作階段畫面中，選擇環境 |
329| `Cmd` `Option` `0` | 在目前佈局的新工作階段畫面中，開啟 [**New environment** 對話框](#create-a-saved-environment) |
292| `Cmd` `W` | 關閉工作階段 |330| `Cmd` `W` | 關閉工作階段 |
293| `Ctrl` `Tab` / `Ctrl` `Shift` `Tab` | 下一個或上一個工作階段 |331| `Ctrl` `Tab` / `Ctrl` `Shift` `Tab` | 下一個或上一個工作階段 |
294| `Cmd` `Shift` `]` / `Cmd` `Shift` `[` | 下一個或上一個工作階段 |332| `Cmd` `Shift` `]` / `Cmd` `Shift` `[` | 下一個或上一個工作階段 |
404 使用工作階段並行工作442 使用工作階段並行工作
405</h3>443</h3>
406 444
407點擊側邊欄中的 **+ New session**，或在 macOS 上按 **Cmd+N** 或在 Windows 上按 **Ctrl+N**，以並行處理多個任務。按 **Ctrl+Tab** 和 **Ctrl+Shift+Tab** 以循環瀏覽側邊欄中的工作階段。對於 Git 儲存庫，選擇分支名稱旁邊的 **worktree** 選項，以使用 [Git worktrees](/docs/zh-TW/worktrees) 為工作階段提供自己的隔離專案副本。445點擊側邊欄中的 **+ New**，或在 macOS 上按 **Cmd+N** 或在 Windows 上按 **Ctrl+N**，以並行處理多個任務。按 **Ctrl+Tab** 和 **Ctrl+Shift+Tab** 以循環瀏覽側邊欄中的工作階段。
408 446
409若要同時檢視兩個工作階段，請在 macOS 上按住 **Cmd** 或在 Windows 上按住 **Ctrl**，然後點擊側邊欄中的工作階段。工作階段會在您已開啟的工作階段旁邊的第二個窗格中開啟。當分割處於活動狀態時，點擊另一個側邊欄工作階段會取代具有焦點的窗格。在 macOS 上按 **Cmd+\\** 或在 Windows 上按 **Ctrl+\\** 以關閉焦點窗格並返回單一工作階段。447若要同時檢視兩個工作階段，請在 macOS 上按住 **Cmd** 或在 Windows 上按住 **Ctrl**，然後點擊側邊欄中的工作階段。工作階段會在您已開啟的工作階段旁邊的第二個窗格中開啟。當分割處於活動狀態時，點擊另一個側邊欄工作階段會取代具有焦點的窗格。在 macOS 上按 **Cmd+\\** 或在 Windows 上按 **Ctrl+\\** 以關閉焦點窗格並返回單一工作階段。
410 448
411Worktrees 預設儲存在 `<project-root>/.claude/worktrees/` 中。您可以將其變更為自訂目錄：449<h4 id="run-a-session-in-its-own-worktree">
450 在專屬的 worktree 中執行工作階段
451</h4>
452
453在屬於 Git 儲存庫的專案中，請在啟動工作階段之前開啟 **Worktree**，讓工作階段在自己的 [Git worktree](/docs/zh-TW/worktrees)（專案的隔離副本）中執行。預設情況下，**Worktree** 為關閉狀態，Claude 會直接在專案資料夾中工作。點擊[提示詞輸入框下方那一列](#start-a-session)中的專案資料夾控制項，然後開啟 **Worktree**。
454
455* **使用[已儲存的環境](#create-a-saved-environment)時**：在建立或編輯環境時設定 **Worktree**
456* **[較早的版面配置](#check-which-layout-you-have)**：選取提示詞輸入框上方、分支名稱旁邊的 **worktree** 核取方塊
457
458Worktrees 預設儲存在 `<project-root>/.claude/worktrees/` 中。若要改為將其儲存在自訂目錄中：
412 459
413* **本機工作階段**：在 **Settings > Claude Code** 中設定 **Worktree location**460* **本機工作階段**：在 **Settings > Claude Code** 中設定 **Worktree location**
414* **SSH 工作階段**：在 [SSH 連線](#choose-where-ssh-session-worktrees-go)上設定 **Worktree folder**461* **SSH 工作階段**：在 [SSH 連線](#choose-where-ssh-session-worktrees-go)上設定 **Worktree folder**
415 462
416您也可以在 **Settings > Claude Code** 中設定 **Branch prefix**。Desktop 會將其加在每個 worktree 分支名稱前面，這對於保持 Claude 建立的分支井然有序很有用。463您也可以在 **Settings > Claude Code** 中設定 **Branch prefix**。Desktop 會將其加在每個 worktree 分支名稱前面，這對於保持 Claude 建立的分支井然有序很有用。
417 464
418若要在完成後移除 worktree，請將滑鼠懸停在側邊欄中的工作階段上，然後點擊存檔圖示。若要在 pull request 合併或關閉後自動存檔工作階段，請在 **Settings > Claude Code** 中開啟 **Auto-archive after PR merge or close**。自動存檔僅適用於已完成執行的本機工作階段。
419
420若要在新 worktrees 中包含 gitignored 檔案（如 `.env`），請在您的專案根目錄中建立 [`.worktreeinclude` 檔案](/docs/zh-TW/worktrees#copy-gitignored-files-into-worktrees)。請參閱 [worktree 與主要簽出共用的內容](/docs/zh-TW/worktrees#what-worktrees-share-with-the-main-checkout)，了解 worktree 工作階段從何處讀取專案設定、hook 和 skill。465若要在新 worktrees 中包含 gitignored 檔案（如 `.env`），請在您的專案根目錄中建立 [`.worktreeinclude` 檔案](/docs/zh-TW/worktrees#copy-gitignored-files-into-worktrees)。請參閱 [worktree 與主要簽出共用的內容](/docs/zh-TW/worktrees#what-worktrees-share-with-the-main-checkout)，了解 worktree 工作階段從何處讀取專案設定、hook 和 skill。
421 466
422<Note>467<Note>
423 工作階段隔離需要 [Git](https://git-scm.com/downloads)。大多數 Mac 預設包含 Git。在終端機中執行 `git --version` 進行檢查；如果它列印版本號，表示已安裝 Git。如果您遇到 Git 錯誤，請在 [Cowork 標籤](https://claude.com/product/cowork) 中詢問 Claude 以幫助排除您的設定問題。468 工作階段隔離需要 [Git](https://git-scm.com/downloads)。大多數 Mac 預設包含 Git。在終端機中執行 `git --version` 進行檢查；如果它列印版本號，表示已安裝 Git。如果您遇到 Git 錯誤，請在 [Cowork 標籤](https://claude.com/product/cowork) 中詢問 Claude 以幫助排除您的設定問題。
424</Note>469</Note>
425 470
426使用側邊欄頂部的控制項按狀態、專案或環境篩選工作階段，並按專案分組工作階段。若要重新命名工作階段，請點擊活動工作階段頂部工具列中的工作階段標題。471<h3 id="add-folders-to-a-session">
472 將資料夾新增到工作階段
473</h3>
474
475在工作階段啟動之前或執行期間新增資料夾：
476
477* **在本機工作階段啟動之前**：在[建立已儲存的環境](#create-a-saved-environment)或編輯環境時，於 **Folders** 下新增資料夾，然後[從該已儲存的環境啟動工作階段](#use-edit-or-remove-a-saved-environment)。
478* **在本機或 [SSH](#ssh-sessions) 工作階段執行期間**：點擊提示詞輸入框旁的 **+**，然後選擇 **Add folder**。Claude 會直接在該資料夾中工作，不使用 [worktree](#run-a-session-in-its-own-worktree)。
479
480<h3 id="archive-a-session">
481 存檔工作階段
482</h3>
483
484在存檔 worktree 中有未提交變更的工作階段之前，請參閱[在工作階段存檔時保留未提交的變更](#keep-uncommitted-changes-when-a-session-is-archived)。若要存檔工作階段，請將滑鼠懸停在側邊欄中的該工作階段上，開啟其選單，然後選擇 **Archive**。該工作階段會移至您的[已存檔工作階段](#organize-and-find-sessions)。
485
486若要讓工作階段在其 pull request 合併或關閉時自動存檔，請在 **Settings > Claude Code** 中開啟 **Auto-archive after PR merge or close**。雲端工作階段和仍在執行中的工作階段不會自動存檔。
487
488<h4 id="keep-uncommitted-changes-when-a-session-is-archived">
489 在工作階段存檔時保留未提交的變更
490</h4>
491
492工作階段存檔時，您可能會遺失該工作階段 worktree 中未提交的變更，因此請先提交您想保留的內容：
493
494* **如果 Desktop 詢問這些變更**：選擇 **Archive anyway** 以捨棄變更，或取消並提交變更
495* **如果變更僅有未追蹤的檔案**：請在 Claude 於該工作階段中開啟的 pull request 合併之前，提交您想保留的檔案，因為屆時 Desktop 可能會在不詢問的情況下將其刪除
496* **其他任何情況**：worktree 及其變更會保留在磁碟上。對於本機工作階段，Desktop 會在工作階段存檔後或您最後一次開啟它後約 30 天（以較晚者為準）將兩者移除。若要保留變更，請從 [**Archived** 標籤](#organize-and-find-sessions)開啟該工作階段，然後選擇 **Unarchive**
497
498<h3 id="organize-and-find-sessions">
499 整理和尋找工作階段
500</h3>
501
502您可以從側邊欄工作階段清單中的圖示來分組、排序和尋找工作階段：
503
504* **目前的版面配置**：將滑鼠懸停在工作階段清單中的標題上以顯示 **Group and sort** 圖示，然後點擊它。若要尋找已存檔的工作階段，請選擇選單最後一列的 **View all**，然後開啟 **Archived** 標籤。
505* **[較早的版面配置](#check-which-layout-you-have)**：**Filter** 圖示無須懸停即會顯示。點擊它以使用 **Group by** 或 **Sort by** 排列清單。若要顯示已存檔的工作階段，請選擇 **Status**，然後選擇 **Archived**。
506
507若要重新命名工作階段，請開啟該工作階段，然後點擊標題列中的工作階段標題。
508
509<h3 id="check-and-free-up-context">
510 檢查並釋放上下文
511</h3>
427 512
428若要檢查上下文使用情況，請參閱[檢查使用情況](#check-usage)。當上下文填滿時，Claude 會自動總結對話並繼續工作。您也可以輸入 `/compact` 來更早觸發總結並釋放上下文空間。有關壓縮如何運作的詳細資訊，請參閱[上下文視窗](/docs/zh-TW/how-claude-code-works#the-context-window)。513若要檢查上下文使用情況，請參閱[檢查使用情況](#check-usage)。當上下文填滿時，Claude 會自動總結對話並繼續工作。您也可以輸入 `/compact` 來更早觸發總結並釋放上下文空間。有關壓縮如何運作的詳細資訊，請參閱[上下文視窗](/docs/zh-TW/how-claude-code-works#the-context-window)。
429 514
515<h3 id="get-notified-when-a-session-finishes">
516 在工作階段完成時收到通知
517</h3>
518
430桌面應用程式會在 Code 工作階段完成任務且您目前未檢視該工作階段時傳送作業系統通知。對於屬於[專案](/docs/zh-TW/claude-projects#see-what-needs-you-in-overview)的工作階段，您會改為收到專案的通知。519桌面應用程式會在 Code 工作階段完成任務且您目前未檢視該工作階段時傳送作業系統通知。對於屬於[專案](/docs/zh-TW/claude-projects#see-what-needs-you-in-overview)的工作階段，您會改為收到專案的通知。
431 520
432<h3 id="ask-a-side-question-without-derailing-the-session">521<h3 id="ask-a-side-question-without-derailing-the-session">
451 跨工作階段工作540 跨工作階段工作
452</h3>541</h3>
453 542
454Claude 可以列出您的其他 Code 標籤工作階段、讀取每個工作階段一直在執行的操作，以及在它們之間傳送訊息。以日常用語詢問：「哪個工作階段涉及了身份驗證重構？」、「API 工作階段得出了什麼結論？」或「告訴付款工作階段 schema 已變更」。您也可以詢問 Claude 重新命名或存檔工作階段。Claude 存檔工作階段的方式與側邊欄的存檔圖示相同，因此可以請它清理 PR 已合併的工作階段。543Claude 可以列出您的其他 Code 標籤工作階段、讀取每個工作階段一直在執行的操作，以及在它們之間傳送訊息。以日常用語詢問：「哪個工作階段涉及了身份驗證重構？」、「API 工作階段得出了什麼結論？」或「告訴付款工作階段 schema 已變更」。
544
545您也可以詢問 Claude 重新命名或存檔工作階段。例如，請它存檔 PR 已合併的工作階段。
455 546
456透過此使用介面，Claude 只能看到桌面應用程式本身執行的工作階段：Code 標籤中的本機、[SSH](#ssh-sessions) 和 [WSL](/docs/zh-TW/desktop-wsl) 工作階段。Claude 看不到雲端工作階段，或您從終端機 CLI 或 VS Code 擴充功能啟動的工作階段，即使在同一專案的 worktrees 中也是如此，因此有九個終端機 worktrees 開啟和兩個桌面工作階段時，Claude 在其中一個回答會報告另一個桌面工作階段。Claude 永遠不會列出您詢問的工作階段。預設情況下，它會看到 20 個最近活躍的工作階段，並跳過已存檔的工作階段，除非您要求它們。[跨工作階段傳訊](/docs/zh-TW/cross-session-messaging)另外讓 Claude 傳送訊息到[您的其他 Claude Code 工作階段](/docs/zh-TW/cross-session-messaging#see-which-sessions-claude-can-reach)，包括終端機工作階段。547透過此使用介面，Claude 只能看到桌面應用程式本身執行的工作階段：Code 標籤中的本機、[SSH](#ssh-sessions) 和 [WSL](/docs/zh-TW/desktop-wsl) 工作階段。Claude 看不到雲端工作階段，或您從終端機 CLI 或 VS Code 擴充功能啟動的工作階段，即使在同一專案的 worktrees 中也是如此，因此有九個終端機 worktrees 開啟和兩個桌面工作階段時，Claude 在其中一個回答會報告另一個桌面工作階段。Claude 永遠不會列出您詢問的工作階段。預設情況下，它會看到 20 個最近活躍的工作階段，並跳過已存檔的工作階段，除非您要求它們。[跨工作階段傳訊](/docs/zh-TW/cross-session-messaging)另外讓 Claude 傳送訊息到[您的其他 Claude Code 工作階段](/docs/zh-TW/cross-session-messaging#see-which-sessions-claude-can-reach)，包括終端機工作階段。
457 548
470 在雲端執行長時間執行的任務561 在雲端執行長時間執行的任務
471</h3>562</h3>
472 563
473對於大型重構、測試套件、遷移或其他長時間執行的任務，在開始工作階段時選擇 **Cloud** 而不是 **Local**。雲端工作階段預設在 Anthropic 管理的基礎設施上執行，即使您關閉應用程式或關閉電腦，也會繼續執行。隨時檢查以查看進度或引導 Claude 朝不同方向發展。您也可以從 [claude.ai/code](https://claude.ai/code) 或 [Claude 行動應用程式](/docs/zh-TW/mobile)監控雲端工作階段。564對於大型重構、測試套件、遷移或其他長時間執行的任務，在開始工作階段時，於[環境選擇器](#start-a-session)中選擇 **Cloud** 下的環境。雲端工作階段預設在 Anthropic 管理的基礎設施上執行，即使您關閉應用程式或關閉電腦，也會繼續執行。隨時檢查以查看進度或引導 Claude 朝不同方向發展。您也可以從 [claude.ai/code](https://claude.ai/code) 或 [Claude 行動應用程式](/docs/zh-TW/mobile)監控雲端工作階段。
565
566雲端工作階段也支援多個儲存庫。選擇儲存庫的位置：
474 567
475雲端工作階段也支援多個儲存庫。選擇雲端環境後，點擊所選儲存庫旁邊的 **+** 按鈕，將其他儲存庫新增到工作階段。每個儲存庫都有自己的分支選擇器。這對於跨越多個程式碼庫的任務很有用，例如更新共用程式庫及其使用者。568* **目前的版面配置**：選擇雲端環境後，在提示詞輸入框下方的那一列中選擇。
569* **[較早的版面配置](#check-which-layout-you-have)**：在提示詞輸入框上方選擇。若要新增另一個儲存庫，請點擊所選儲存庫旁邊的 **+**。
476 570
477有關雲端工作階段如何運作的更多資訊，請參閱[在雲端使用 Claude Code](/docs/zh-TW/claude-code-on-the-web)。當一項工作需要許多雲端工作階段時，請在側邊欄中選擇 **Projects** 以建立[專案](/docs/zh-TW/claude-projects)，Claude 會從一個對話中為您啟動並追蹤工作階段。571有關雲端工作階段如何運作的更多資訊，請參閱[在雲端使用 Claude Code](/docs/zh-TW/claude-code-on-the-web)。當一項工作需要許多雲端工作階段時，請在側邊欄中選擇 **Projects** 以建立[專案](/docs/zh-TW/claude-projects)，Claude 會從一個對話中為您啟動並追蹤工作階段。
478 572
500* **您為該工作階段開啟**：使用該工作階段的 **Remote Control** 開關，或在其提示詞輸入框中輸入 `/remote-control`。594* **您為該工作階段開啟**：使用該工作階段的 **Remote Control** 開關，或在其提示詞輸入框中輸入 `/remote-control`。
501* **在啟動時連線**：當 **Settings > Claude Code** 中的 **Connect new sessions to Remote Control** 開啟時，新工作階段會自動連線。如果您從未變更該設定，Desktop 會遵循您使用者設定或受管設定中的 [`remoteControlAtStartup`](/docs/zh-TW/settings-reference#remotecontrolatstartup)，其次是您組織的預設值。595* **在啟動時連線**：當 **Settings > Claude Code** 中的 **Connect new sessions to Remote Control** 開啟時，新工作階段會自動連線。如果您從未變更該設定，Desktop 會遵循您使用者設定或受管設定中的 [`remoteControlAtStartup`](/docs/zh-TW/settings-reference#remotecontrolatstartup)，其次是您組織的預設值。
502 596
503若要查看工作階段是否已連線，請查看工具列中工作階段標題前的筆記型電腦圖示。當工作階段已連線或正在連線時，該圖示會反白顯示。點擊它以開啟該工作階段的 **Remote Control** 開關。597若要查看工作階段是否已連線，請查看其[工作階段詳細資料面板](#see-session-details)中 **Environment** 卡片上的 **Remote Control** 開關。
504 598
505若要讓工作階段不出現在您的其他裝置上，請在您需要的層級關閉 Remote Control：599若要讓工作階段不出現在您的其他裝置上，請在您需要的層級關閉 Remote Control：
506 600
538 連接外部工具632 連接外部工具
539</h3>633</h3>
540 634
541對於本機和 [SSH](#ssh-sessions) 會話，點擊提示框旁的 **+** 按鈕，然後選擇 **Connectors** 以新增 Google Calendar、Slack、GitHub、Linear、Notion 等整合。您可以在會話之前或期間新增連接器。**+** 按鈕在雲端或 WSL 會話中不可用，但 [routines](/docs/zh-TW/routines) 在 routine 建立時配置連接器。635連接器是具有圖形化設定流程的 [MCP 伺服器](/docs/zh-TW/mcp)。
636
637在使用 Claude 帳戶的本機或 [SSH](#ssh-sessions) 工作階段中，於工作階段開始前或進行期間，點擊提示詞輸入框旁的 **+** 以新增連接器。選擇 **Add connectors** 以開啟連接器目錄。如果選單改為顯示 **Connectors**，請選擇它，然後選擇 **Browse connectors**。
638
639<Note>
640 以下情況在其他頁面中說明：
542 641
543若要管理或斷開連接器，請在桌面應用程式中前往「設定」→「Connectors」，或從提示框中的「Connectors」選單中選擇 **Manage connectors**。642 * **Connectors 在 WSL 工作階段中呈現灰色**：請參閱[如果終端機或連接器無法使用](/docs/zh-TW/desktop-wsl#check-for-the-terminal-and-connectors)
643 * **雲端工作階段**：請參閱[連接器如何連至 Claude Code](/docs/zh-TW/mcp#how-connectors-reach-claude-code)
644</Note>
544 645
545連接後，Claude 可以讀取您的日曆、傳送訊息、建立問題，並直接與您的工具互動。您可以詢問 Claude 在您的會話中配置了哪些連接器。646連接後，Claude 可以讀取您的日曆、傳送訊息、建立問題，並直接與您的工具互動。您可以詢問 Claude 在您的工作階段中設定了哪些連接器。若要管理或中斷連接器，請在桌面應用程式中前往 **Settings > Connectors**。
546 647
547連接器是 [MCP servers](/docs/zh-TW/mcp)，具有圖形設定流程。使用它們可以快速與支援的服務整合。對於「Connectors」中未列出的整合，透過 [settings files](/docs/zh-TW/mcp#installing-mcp-servers) 手動新增 MCP servers。您也可以 [create custom connectors](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp)。648對於 Connectors 中未列出的整合，請透過[設定檔](/docs/zh-TW/mcp#installing-mcp-servers)手動新增 MCP 伺服器。您也可以[建立自訂連接器](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp)。
548 649
549<h3 id="use-skills">650<h3 id="use-skills">
550 使用 skills651 使用 skills
564 665
565[Plugins](/docs/zh-TW/plugins/overview) 是可重複使用的套件，可將 skills、agents、hooks、MCP servers 和 LSP 配置新增到 Claude Code。您可以從桌面應用程式安裝 plugins，而無需使用終端機。666[Plugins](/docs/zh-TW/plugins/overview) 是可重複使用的套件，可將 skills、agents、hooks、MCP servers 和 LSP 配置新增到 Claude Code。您可以從桌面應用程式安裝 plugins，而無需使用終端機。
566 667
567對於本機和 [SSH](#ssh-sessions) 會話，點擊提示框旁的 **+** 按鈕，然後選擇 **Plugins** 以查看您已安裝的 plugins 及其 skills。若要新增 plugin，從子選單中選擇 **Add plugin** 以開啟 plugin 瀏覽器，它顯示來自您配置的 [marketplaces](/docs/zh-TW/plugins/overview)（包括官方 Anthropic 市場）的可用 plugins。選擇 **Manage plugins** 以啟用、停用或解除安裝 plugins。668在本機工作階段或 [SSH 工作階段](#ssh-sessions)中，點擊提示詞輸入框旁的 **+** 並選擇 **Add plugins** 以開啟外掛瀏覽器。如果選單改為顯示 **Plugins**，請選擇它，然後選擇 **Browse plugins**，或選擇 **Manage plugins** 以啟用、停用或解除安裝外掛。
568 669
569您可以將 plugins 限定於您的使用者帳戶、特定專案或僅本機。如果您的組織集中管理 plugins，這些 plugins 在桌面會話中的可用方式與在 CLI 中相同，除了桌面應用程式在 [`disableSideloadFlags`](/docs/zh-TW/settings-reference#disablesideloadflags) 下扣留的那些。670您可以將 plugins 限定於您的使用者帳戶、特定專案或僅本機。如果您的組織集中管理 plugins，這些 plugins 在桌面會話中的可用方式與在 CLI 中相同，除了桌面應用程式在 [`disableSideloadFlags`](/docs/zh-TW/settings-reference#disablesideloadflags) 下扣留的那些。
570 671
632| `runtimeArgs` | string\[] | 傳遞給 `runtimeExecutable` 的引數，例如 `["run", "dev"]` |733| `runtimeArgs` | string\[] | 傳遞給 `runtimeExecutable` 的引數，例如 `["run", "dev"]` |
633| `port` | number | 您的伺服器監聽的連接埠。預設為 3000 |734| `port` | number | 您的伺服器監聽的連接埠。預設為 3000 |
634| `cwd` | string | 相對於您的專案根目錄的工作目錄。預設為專案根目錄。使用 `${workspaceFolder}` 明確參考專案根目錄 |735| `cwd` | string | 相對於您的專案根目錄的工作目錄。預設為專案根目錄。使用 `${workspaceFolder}` 明確參考專案根目錄 |
635| `env` | object | 其他環境變數作為鍵值對，例如 `{ "NODE_ENV": "development" }`。不要在此處放置機密，因為此檔案會提交到您的儲存庫。若要將機密傳遞到您的開發伺服器，請在 [local environment editor](#local-sessions) 中設定它們。 |736| `env` | object | 以鍵值對表示的其他環境變數，例如 `{ "NODE_ENV": "development" }`。請勿在此處放置機密，因為此檔案會提交到您的儲存庫。關於機密，請參閱[為開發伺服器設定環境變數](#set-environment-variables-for-dev-servers)。 |
636| `autoPort` | boolean | 如何處理連接埠衝突。請參閱 [Port conflicts](#port-conflicts) |737| `autoPort` | boolean | 如何處理連接埠衝突。請參閱 [Port conflicts](#port-conflicts) |
637| `program` | string | 使用 `node` 執行的指令碼。請參閱 [when to use `program` vs `runtimeExecutable`](#when-to-use-program-vs-runtimeexecutable) |738| `program` | string | 使用 `node` 執行的指令碼。請參閱 [when to use `program` vs `runtimeExecutable`](#when-to-use-program-vs-runtimeexecutable) |
638| `args` | string\[] | 傳遞給 `program` 的引數。僅在設定 `program` 時使用 |739| `args` | string\[] | 傳遞給 `program` 的引數。僅在設定 `program` 時使用 |
795* **SSH**：在您透過 SSH 連線的遠端機器上執行，例如您自己的伺服器、雲端 VM 或開發容器。正在執行的任務可以[在 Desktop 中斷連線時繼續進行](#keep-a-task-running-while-desktop-is-disconnected)，但使用 Claude 帳戶時，任務可能會在其登入過期時停止。896* **SSH**：在您透過 SSH 連線的遠端機器上執行，例如您自己的伺服器、雲端 VM 或開發容器。正在執行的任務可以[在 Desktop 中斷連線時繼續進行](#keep-a-task-running-while-desktop-is-disconnected)，但使用 Claude 帳戶時，任務可能會在其登入過期時停止。
796* **WSL**（Windows）：在您機器上的 [WSL 2 發行版](/docs/zh-TW/desktop-wsl)內執行，使用其 Linux 工具鏈和原生路徑897* **WSL**（Windows）：在您機器上的 [WSL 2 發行版](/docs/zh-TW/desktop-wsl)內執行，使用其 Linux 工具鏈和原生路徑
797 898
899<h3 id="create-a-saved-environment">
900 建立已儲存的環境
901</h3>
902
903已儲存的環境是[環境選擇器](#start-a-session)中的一個項目，記錄 Claude 的執行位置，讓您之後可以在該處啟動工作階段。本機或 SSH 環境也會保存 Claude 工作所在的資料夾。已儲存的本機和 SSH 環境[需要 Claude Desktop v2.37337.0 或更新版本](#check-which-layout-you-have)。
904
905<Steps>
906 <Step title="開啟 New environment 對話方塊">
907 開啟提示詞輸入框下方的環境選擇器，然後選取其選單底部的 **New environment**。
908 </Step>
909
910 <Step title="選擇 Claude 的執行位置">
911 選取 **Local**、**SSH** 或 [**Cloud**](#cloud-sessions) 分頁，並填寫該分頁上的表單。在 **SSH** 分頁上，選擇一個[連線](#ssh-sessions)以及遠端機器上的資料夾。
912 </Step>
913
914 <Step title="儲存環境">
915 選取 **Create environment**，或在 **Cloud** 分頁上選取 **Add environment**。
916 </Step>
917</Steps>
918
919<h4 id="environments-that-desktop-creates-for-you">
920 Desktop 為您建立的環境
921</h4>
922
923如果環境選擇器列出了您未建立的本機或 SSH 環境，表示是 Desktop 為您建立的。當您第一次在[目前版面配置](#check-which-layout-you-have)中開啟 Code 分頁時，Desktop 最多會建立八個環境。這些環境來自您上個月最常使用的本機和 SSH 資料夾。您可以[編輯或刪除它們](#use-edit-or-remove-a-saved-environment)。
924
925<h4 id="use-edit-or-remove-a-saved-environment">
926 使用、編輯或移除已儲存的環境
927</h4>
928
929在[環境選擇器](#start-a-session)中找到該環境的項目：
930
931* **啟動工作階段**：選取該項目。
932* **編輯或刪除**：將滑鼠游標停留在該項目上，然後點選齒輪圖示。若要刪除本機或 SSH 環境，請在 **Edit environment** 中點選 **Delete environment**。
933* **封存雲端環境**：請參閱[封存環境](/docs/zh-TW/cloud-environments#archive-an-environment)。
934
798<h3 id="local-sessions">935<h3 id="local-sessions">
799 本機工作階段936 本機工作階段
800</h3>937</h3>
801 938
802桌面應用程式不一定會繼承您完整的 shell 環境。在 macOS 上，當您從 Dock 或 Finder 啟動應用程式時，它會讀取您的 shell 設定檔（例如 `~/.zshrc` 或 `~/.bashrc`），以提供 Claude Code `PATH` 和一組固定的 Claude Code 變數，但不會提供您在其中匯出的其他變數。在 Windows 上，應用程式會繼承使用者和系統環境變數，但不會讀取 PowerShell 設定檔。939桌面應用程式不一定會繼承您完整的 shell 環境。在 macOS 上，當您從 Dock 或 Finder 啟動應用程式時，它會讀取您的 shell 設定檔（例如 `~/.zshrc` 或 `~/.bashrc`），以提供 Claude Code `PATH` 和一組固定的 Claude Code 變數，但不會提供您在其中匯出的其他變數。在 Windows 上，應用程式會繼承使用者和系統環境變數，但不會讀取 PowerShell 設定檔。
803 940
804若要在任何平台上為本機工作階段和開發伺服器設定環境變數，請開啟提示詞方塊中的環境下拉選單，將滑鼠游標停在 **Local** 上，然後按一下齒輪圖示以開啟本機環境編輯器。您在此儲存的變數會加密儲存在您的機器上，並套用至您啟動的每個本機工作階段和預覽伺服器。您也可以將變數加入 `~/.claude/settings.json` 檔案中的 `env` 鍵，但這些變數只會傳遞給 Claude 工作階段，而不會傳遞給開發伺服器。如需支援的變數完整清單，請參閱[環境變數](/docs/zh-TW/env-vars)。941<h4 id="set-environment-variables-for-local-sessions">
942 為本機工作階段設定環境變數
943</h4>
944
945將變數新增至已儲存的本機環境，並從該環境啟動您的工作階段。Desktop [會自行設定某些變數](#environment-variables-desktop-sets-itself)，例如 `API_TIMEOUT_MS`，您的工作階段會取得 Desktop 的值，而不是您的值。
946
947<Note>
948 如果您的環境選擇器位於提示詞輸入框上方，表示您使用的是[較早的版面配置](#check-which-layout-you-have)，其中沒有已儲存的本機環境。請改用[本機環境編輯器](#use-the-local-environment-editor)。
949</Note>
950
951<Steps>
952 <Step title="開啟環境的表單">
953 開啟 [**New environment**](#create-a-saved-environment) 或 [**Edit environment**](#use-edit-or-remove-a-saved-environment)。
954 </Step>
955
956 <Step title="輸入變數">
957 選取 **Environment variables**，每行輸入一個 `KEY=value`，然後選取 **Done**。
958 </Step>
959
960 <Step title="儲存環境">
961 選取 **Create environment** 或 **Save**。
962 </Step>
963</Steps>
964
965只有從該環境啟動的工作階段才會取得這些變數。
966
967若要為每個本機工作階段設定變數，請將其新增至 `~/.claude/settings.json` 檔案中的 [`env` 鍵](/docs/zh-TW/env-vars#set-variables-in-settings-files)。如果該變數已存在於 Desktop 啟動工作階段時使用的環境中，Claude Code 會[忽略該值](/docs/zh-TW/settings-reference#how-env-values-interact-with-your-shell)。如需支援變數的完整清單，請參閱[環境變數](/docs/zh-TW/env-vars)。
968
969<h4 id="set-environment-variables-for-dev-servers">
970 為開發伺服器設定環境變數
971</h4>
972
973若要在不提交至 [`launch.json`](#configure-preview-servers) 的情況下為開發伺服器提供機密資訊，請在下列其中一處設定，然後重新啟動 Desktop：
974
975* **macOS 和 Linux**：在您的 shell 設定檔中匯出
976* **Windows**：將其新增至您的使用者或系統環境變數
977* **任何平台**：如果您能開啟[本機環境編輯器](#use-the-local-environment-editor)，請將其儲存在該編輯器中
978
979開發伺服器不會取得您新增至[已儲存的環境](#create-a-saved-environment)或 `~/.claude/settings.json` 的變數。
980
981<h4 id="use-the-local-environment-editor">
982 使用本機環境編輯器
983</h4>
984
985若要開啟本機環境編輯器，請點選您自己電腦項目上的齒輪圖示，而不是已儲存環境上的齒輪圖示：
986
987* **位於提示詞輸入框下方的選擇器**：將滑鼠游標停留在您電腦的項目上，即 **Local** 下的第一個項目。如果出現齒輪圖示，請點選它。如果沒有出現，表示無法使用該編輯器，請以其他方式為[本機工作階段](#set-environment-variables-for-local-sessions)或[開發伺服器](#set-environment-variables-for-dev-servers)設定變數。
988* **位於提示詞輸入框上方的選擇器**：將滑鼠游標停留在 **Local** 上，然後點選齒輪圖示
989
990每行輸入一個 `KEY=value`，然後選取 **Save changes**。您在此處儲存的變數會以加密方式儲存在您的電腦上。本機工作階段會取得這些變數，但 [Desktop 自行設定的](#environment-variables-desktop-sets-itself)任何變數（例如 `API_TIMEOUT_MS`）除外。重新啟動 Desktop 即可將您的變數提供給開發伺服器。
991
992<h4 id="environment-variables-desktop-sets-itself">
993 Desktop 自行設定的環境變數
994</h4>
995
996如果您設定了 `API_TIMEOUT_MS` 或 `ANTHROPIC_BASE_URL`，但本機工作階段中沒有任何變化，這是因為 Desktop 會自行設定這些[變數](/docs/zh-TW/env-vars#variables)以及其他變數。無論您是在 shell 設定檔、Windows 使用者或系統變數、本機環境編輯器，還是已儲存的環境中設定，本機工作階段都會取得 Desktop 的值。將您的值移至設定檔也沒有幫助，因為 Claude Code 在本機工作階段中會[忽略該值](/docs/zh-TW/settings-reference#how-env-values-interact-with-your-shell)。
997
998* `API_TIMEOUT_MS`：本機工作階段會取得 `900000`，即 15 分鐘。若需要更長的逾時時間，請[安裝 Claude Code CLI](/docs/zh-TW/quickstart) 並改用它取代 Desktop。[在您的 shell 中設定該變數](/docs/zh-TW/env-vars#set-variables-in-your-shell)，然後在終端機中執行 `claude`。
999* `ANTHROPIC_BASE_URL`：當您以 Claude 帳戶登入時，本機工作階段會取得 Anthropic 的 API 主機。若要使用閘道，請改為設定 Desktop 的[第三方推論設定](/docs/zh-TW/llm-gateway-connect#desktop-app)。
1000
1001<h4 id="turn-off-extended-thinking">
1002 關閉延伸思考
1003</h4>
805 1004
806[延伸思考](/docs/zh-TW/model-config#extended-thinking)預設為啟用，可提升複雜推理任務的效能，但會使用額外的 token。在 Anthropic API 上，於本機環境編輯器中將 `MAX_THINKING_TOKENS` 設為 `0` 即可關閉思考；這對 Opus 5.5、Sonnet 5.5、Haiku 5.5 或 Fable 模型沒有作用，因為這些模型一律使用延伸思考。在 Anthropic API 上關閉思考時，對於 Claude Code 已知[不接受該組合](/docs/zh-TW/errors#effort-isnt-available-with-thinking-turned-off)的模型（例如 Opus 5），Claude Code 會傳送 effort `high`，而非更高的等級。1005[延伸思考](/docs/zh-TW/model-config#extended-thinking)預設為啟用，可提升複雜推理任務的效能，但會使用額外的 token。若要關閉它，請在[已儲存的本機環境](#set-environment-variables-for-local-sessions)或[本機環境編輯器](#use-the-local-environment-editor)中將 `MAX_THINKING_TOKENS` 設定為 `0`。思考隨後會在 Anthropic API 上關閉，但 Opus 5.5、Sonnet 5.5、Haiku 5.5 和 Fable 模型除外，這些模型一律使用延伸思考。
1006
1007在 Opus 5 上，還必須在啟動工作階段之前選擇 `high` 或更低的 effort。在[目前版面配置](#check-which-layout-you-have)中，開啟模型選擇器並在 **Effort** 下選取一個等級。如果您以較高的等級啟動了工作階段，請以 `high` 或更低的等級啟動新的工作階段。
1008
1009<h4 id="fixed-thinking-budgets">
1010 固定思考預算
1011</h4>
807 1012
808在具有[自適應推理](/docs/zh-TW/model-config#adjust-effort-level)的模型上，Claude Code 會忽略正值 `MAX_THINKING_TOKENS` 中的數字本身，因為改由自適應推理控制思考深度。在 Opus 4.6 和 Sonnet 4.6 上，將 `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` 設為 `1` 即可使用固定的思考預算；Fable 模型、Sonnet 5 及更新版本、Haiku 5.5，以及 Opus 4.7 及更新版本一律使用自適應推理，沒有固定預算模式。1013在具有[自適應推理](/docs/zh-TW/model-config#adjust-effort-level)的模型上，Claude Code 會忽略正值 `MAX_THINKING_TOKENS` 中的數字本身，因為改由自適應推理控制思考深度。在 Opus 4.6 和 Sonnet 4.6 上，將 `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` 設為 `1` 即可使用固定的思考預算；Fable 模型、Sonnet 5 及更新版本、Haiku 5.5，以及 Opus 4.7 及更新版本一律使用自適應推理，沒有固定預算模式。
809 1014
811 受管裝置上的本機工作階段1016 受管裝置上的本機工作階段
812</h4>1017</h4>
813 1018
814您的管理員可以透過 [`disableDesktopLocalSessions` 受管設定](#managed-settings)關閉本機工作階段。若管理員已這樣做，**Local** 仍會留在環境下拉選單中，但會呈現灰色且無法選取，並顯示工具提示說明您的組織已將其關閉；在 Windows 上，[WSL](/docs/zh-TW/desktop-wsl) 項目（其在受管裝置上的可用性[另行管理](/docs/zh-TW/admin-setup#wsl-sessions-in-claude-code-desktop)）也會以相同方式呈現灰色。若已設定 SSH 連線，新工作階段預設會使用第一個 SSH 連線；若您嘗試繼續現有的工作階段，Desktop 會顯示訊息，說明此裝置無法使用本機工作階段。請改為選擇 [SSH](#ssh-sessions) 或[雲端](#cloud-sessions)環境，或聯絡您的 IT 團隊。1019如果您電腦的項目在環境選擇器中呈灰色，並顯示工具提示 **Disabled by your organization**，表示您的管理員已[關閉本機工作階段](#managed-settings)。在 Windows 上，[WSL](/docs/zh-TW/desktop-wsl) 項目（其在受管裝置上的可用性是[另外管理的](/docs/zh-TW/admin-setup#wsl-sessions-in-claude-code-desktop)）也會以相同方式呈灰色。
1020
1021如果已設定 SSH 連線，新的工作階段預設會使用第一個 SSH 連線。如果您嘗試繼續現有的本機工作階段，Desktop 會顯示訊息，告知此裝置無法使用本機工作階段。當您選取[已儲存的本機環境](#create-a-saved-environment)時，會顯示此錯誤：`Couldn’t switch environments: the Local environment isn’t available anymore.` 請改為選擇 [SSH](#ssh-sessions) 或[雲端](#cloud-sessions)環境，或聯絡您的 IT 團隊。
815 1022
816<h3 id="cloud-sessions">1023<h3 id="cloud-sessions">
817 雲端工作階段1024 雲端工作階段
819 1026
820即使您關閉應用程式，雲端工作階段仍會在背景繼續執行。使用量會計入您的[訂閱方案限制](/docs/zh-TW/costs)，不另外收取運算費用。1027即使您關閉應用程式，雲端工作階段仍會在背景繼續執行。使用量會計入您的[訂閱方案限制](/docs/zh-TW/costs)，不另外收取運算費用。
821 1028
822您可以建立具有不同網路存取層級和環境變數的自訂雲端環境。若要管理這些環境，請開啟提示詞方塊中的環境下拉選單，然後選取 **Cloud**：1029若要新增、編輯或[封存](/docs/zh-TW/cloud-environments#archive-an-environment)雲端環境，請開啟[環境選擇器](#start-a-session)：
823 1030
824* **新增環境**：選取 **Add cloud environment**1031* **新增環境**：選取選擇器選單底部的 **New environment**，然後選取 [**New environment** 對話方塊](#create-a-saved-environment)的 **Cloud** 分頁
825* **編輯或封存您自己的其中一個環境**：將滑鼠游標停在該環境上，然後按一下齒輪圖示1032* **編輯或封存您自己的其中一個環境**：將滑鼠游標停在該環境上，然後按一下齒輪圖示
826 1033
827如需設定網路存取和環境變數的詳細資訊，請參閱[設定雲端環境](/docs/zh-TW/cloud-environments)。1034如需設定網路存取和環境變數的詳細資訊，請參閱[設定雲端環境](/docs/zh-TW/cloud-environments)。
836 如果您搭配[第三方供應商](/docs/zh-TW/third-party-integrations)使用 Desktop，SSH 工作階段需要另外設定。請參閱 [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions)。1043 如果您搭配[第三方供應商](/docs/zh-TW/third-party-integrations)使用 Desktop，SSH 工作階段需要另外設定。請參閱 [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions)。
837</Note>1044</Note>
838 1045
839若要新增 SSH 連線，請在啟動工作階段之前開啟提示詞方塊中的環境下拉選單，然後選取 **SSH > Add SSH connection…** 並填寫連線詳細資料：1046在 [**New environment** 對話方塊](#create-a-saved-environment)中新增 SSH 連線，然後在該連線上啟動工作階段。如果新的工作階段在提示詞輸入框下方沒有環境選擇器，表示您使用的是較早的版面配置。請參閱[檢查您使用的版面配置](#check-which-layout-you-have)。
1047
1048<Steps>
1049 <Step title="開啟 New environment 對話方塊">
1050 在啟動工作階段之前，開啟提示詞輸入框下方的環境選擇器，然後選取其選單底部的 **New environment**。
1051 </Step>
1052
1053 <Step title="新增連線">
1054 在 **New environment** 對話方塊的 **SSH** 分頁上，開啟 **Host** 清單，選取 **Add SSH connection…**，然後填寫連線詳細資訊：
840 1055
841* **Name**：此連線的易記標籤1056 * **Name**：此連線的易記標籤。
842* **SSH host**：`user@hostname` 或 `~/.ssh/config` 中定義的主機1057 * **SSH host**：`user@hostname` 或在 `~/.ssh/config` 中定義的主機。
843* **SSH port**：若留空則預設為 22，或使用您 SSH 設定中的連接埠1058 * **SSH port**：若留空則預設為 22，或使用您 SSH 設定中的連接埠。
844* **SSH key (optional)**：您私密金鑰的路徑，例如 `~/.ssh/id_ed25519`。留空則使用您的 SSH 設定或 SSH agent。1059 * **SSH key (optional)**：您私密金鑰的路徑，例如 `~/.ssh/id_ed25519`。留空即可使用您的 SSH 設定或 SSH agent。
845* **Worktree folder**：遠端機器上的資料夾，例如 `~/worktrees`，新工作階段會在其中建立 worktree。留空則使用[遠端機器的預設值](#choose-where-ssh-session-worktrees-go)。1060 * **Worktree folder**：遠端機器上的資料夾，例如 `~/worktrees`，新的工作階段會在其中建立 worktree。留空即可使用[遠端機器的預設值](#choose-where-ssh-session-worktrees-go)。
846 1061
847新增後，連線會出現在環境下拉選單的 **SSH** 下方。選取它即可在該機器上啟動工作階段。Claude 會在遠端機器上執行，並可存取其檔案和工具。1062 然後選取 **Add SSH connection**。
1063 </Step>
1064
1065 <Step title="在該連線上啟動工作階段">
1066 選取遠端機器上的資料夾，然後點選 **Create environment**。您會將該機器和資料夾一起保存為[已儲存的環境](#create-a-saved-environment)，以供之後的工作階段使用。Desktop 會為新的工作階段選取它，因此請輸入您的任務並按下 **Enter**。
1067 </Step>
1068</Steps>
848 1069
849遠端機器可以執行 Linux、macOS 或 [Windows](#windows-remote-machines)。Desktop 會在您第一次連線時自動在遠端機器上安裝 Claude Code。連線後，SSH 工作階段支援權限模式、連接器、外掛和 MCP 伺服器。1070遠端機器可以執行 Linux、macOS 或 [Windows](#windows-remote-machines)。Desktop 會在您第一次連線時自動在遠端機器上安裝 Claude Code。連線後，SSH 工作階段支援權限模式、連接器、外掛和 MCP 伺服器。
850 1071
1175 1396
1176Desktop 中斷連線時，檔案編輯和某些工具可能會失敗。如果任務需要它們，請讓 Desktop 保持連線：1397Desktop 中斷連線時，檔案編輯和某些工具可能會失敗。如果任務需要它們，請讓 Desktop 保持連線：
1177 1398
1178* **Worktree**：在使用 [worktree](#work-in-parallel-with-sessions) 的工作階段中，Desktop 會在 Claude 進行每次檔案編輯之前先檢查。Desktop 中斷連線時，每次編輯會等待約 30 秒後失敗。Shell 命令仍會執行。在 Linux 或 macOS 遠端機器上，[編輯可能會繼續運作](#worktree-edits-while-disconnected)。如果您不確定，請不使用 worktree 啟動工作階段。1399* **Worktree**：在使用 [worktree](#run-a-session-in-its-own-worktree) 的工作階段中，Desktop 會在 Claude 進行每次檔案編輯之前進行檢查。在 Desktop 中斷連線期間，每次編輯會等待約 30 秒然後失敗。Shell 命令仍會執行。在 Linux 或 macOS 遠端機器上，[編輯可以繼續運作](#worktree-edits-while-disconnected)。如果您不確定，請在不使用 worktree 的情況下啟動工作階段。
1179* **資料夾限制**：如果您的組織限制工作階段可使用的資料夾，無論是否使用 worktree，Desktop 都會檢查每次檔案讀取、搜尋和編輯。Desktop 中斷連線時，每項操作會等待最多 10 分鐘後失敗。1400* **資料夾限制**：如果您的組織限制工作階段可使用的資料夾，無論是否使用 worktree，Desktop 都會檢查每次檔案讀取、搜尋和編輯。Desktop 中斷連線時，每項操作會等待最多 10 分鐘後失敗。
1180* **連接器**：[連接器](#connect-external-tools)和 Desktop 提供的其他工具會透過 Desktop 執行，因此在 Desktop 中斷連線時，每次呼叫會在約 30 秒後失敗1401* **連接器**：[連接器](#connect-external-tools)和 Desktop 提供的其他工具會透過 Desktop 執行，因此在 Desktop 中斷連線時，每次呼叫會在約 30 秒後失敗
1181* **工作流程**：Desktop 會在每個新的[工作流程](/docs/zh-TW/workflows)啟動前進行檢查，因此在 Desktop 中斷連線時，新的工作流程會等待最多 10 分鐘後失敗1402* **工作流程**：Desktop 會在每個新的[工作流程](/docs/zh-TW/workflows)啟動前進行檢查，因此在 Desktop 中斷連線時，新的工作流程會等待最多 10 分鐘後失敗
1264 選擇 SSH 工作階段 worktree 的位置1485 選擇 SSH 工作階段 worktree 的位置
1265</h4>1486</h4>
1266 1487
1267除非您的組織限制工作階段可使用的資料夾，否則新的 SSH 工作階段會在下列項目中第一個已設定的位置建立其 [worktree](#work-in-parallel-with-sessions)：1488除非您的組織限制工作階段可使用的資料夾，否則新的 SSH 工作階段會在下列位置中第一個已設定的位置建立其 [worktree](#run-a-session-in-its-own-worktree)：
1268 1489
12691. SSH 連線上的 **Worktree folder**14901. SSH 連線上的 **Worktree folder**
12702. 遠端機器上 `~/.claude/settings.json` 中的 [`worktree.location`](/docs/zh-TW/settings-reference#worktree-location)14912. 遠端機器上 `~/.claude/settings.json` 中的 [`worktree.location`](/docs/zh-TW/settings-reference#worktree-location)
1272 1493
1273每個專案會在您設定的資料夾中取得自己的子資料夾，因此使用 `~/worktrees` 時，worktree 的路徑為 `~/worktrees/<project>-<id>/<worktree-name>`。如果您設定的資料夾位於專案內，Desktop 會對該專案忽略它並使用預設值。在 [Windows 遠端機器](#windows-remote-machines)上，Desktop 一律使用預設值。1494每個專案會在您設定的資料夾中取得自己的子資料夾，因此使用 `~/worktrees` 時，worktree 的路徑為 `~/worktrees/<project>-<id>/<worktree-name>`。如果您設定的資料夾位於專案內，Desktop 會對該專案忽略它並使用預設值。在 [Windows 遠端機器](#windows-remote-machines)上，Desktop 一律使用預設值。
1274 1495
1275若要在您先前新增的連線或您組織管理的連線上設定 **Worktree folder**，請在環境下拉選單中將滑鼠游標停在該連線上，然後按一下齒輪圖示。1496<a id="set-the-worktree-folder-on-an-existing-connection" />
1276 1497
1277此欄位需要 Claude Desktop v1.44121.0 或更新版本。如果您的組織限制工作階段可使用的資料夾，Desktop 會隱藏此欄位，並將 worktree 保留在專案內。1498<h5 id="set-the-worktree-folder-on-an-existing-connection">
1499 在現有連線上設定 worktree 資料夾
1500</h5>
1501
1502在您之前新增的連線或您組織管理的連線設定中，設定 **Worktree folder**。此欄位需要 Claude Desktop v1.44121.0 或更新版本。如果您的組織限制工作階段可使用的資料夾，Desktop 會隱藏此欄位，並將 worktree 保留在專案內。
1503
1504<Steps>
1505 <Step title="找到連線">
1506 開啟[環境選擇器](#start-a-session)，並在 **SSH** 下找到該連線。
1507 </Step>
1508
1509 <Step title="開啟連線的設定">
1510 將滑鼠游標停留在該連線上，然後點選齒輪圖示。如果開啟的對話方塊在 **Host** 旁顯示 **Edit connection…**，請選取 **Edit connection…**。
1511 </Step>
1512
1513 <Step title="設定資料夾">
1514 在 **Worktree folder** 中，輸入遠端機器上的資料夾，例如 `~/worktrees`，然後選取 **Save changes**。
1515 </Step>
1516</Steps>
1278 1517
1279<h4 id="files-and-processes-on-the-remote-machine">1518<h4 id="files-and-processes-on-the-remote-machine">
1280 遠端機器上的檔案和程序1519 遠端機器上的檔案和程序
1321 終止單一工作階段的程序1560 終止單一工作階段的程序
1322</h5>1561</h5>
1323 1562
1324若要終止單一工作階段的 Claude Code 程序，請在 Desktop 連線到遠端機器時，在 Desktop 中[封存該工作階段](#work-in-parallel-with-sessions)。該程序在任務完成後以及您結束 Desktop 後都會繼續執行。1563若要終止單一工作階段的 Claude Code 程序，請在 Desktop 連線至遠端機器時，於 Desktop 中[封存該工作階段](#archive-a-session)。該程序在其任務完成後以及您結束 Desktop 後仍會繼續執行。
1325 1564
1326在封存具有 worktree 的工作階段之前，請參閱[使用工作階段平行作業](#work-in-parallel-with-sessions)。1565在封存 worktree 中有未提交變更的工作階段之前，請參閱[在封存工作階段時保留未提交的變更](#keep-uncommitted-changes-when-a-session-is-archived)。
1327 1566
1328<h5 id="see-which-user-the-processes-run-as">1567<h5 id="see-which-user-the-processes-run-as">
1329 查看程序以哪位使用者身分執行1568 查看程序以哪位使用者身分執行
1474 為您的團隊預先設定 SSH 連線1713 為您的團隊預先設定 SSH 連線
1475</h4>1714</h4>
1476 1715
1477管理員可以在[受管設定](/docs/zh-TW/managed-settings)中設定 `sshConfigs`，將 SSH 連線分發給團隊成員。以此方式定義的連線會自動出現在每位使用者的環境下拉選單中，並顯示為受管連線。使用者可以選取它們並為它們[設定自己的 **Worktree folder**](#choose-where-ssh-session-worktrees-go)，但無法在應用程式中編輯其他任何內容或刪除它們。1716管理員可以在[受管設定](/docs/zh-TW/managed-settings)中設定 `sshConfigs`，將 SSH 連線分發給團隊成員。
1717
1718* **使用者看到的內容**：以此方式定義的連線會自動出現在每位使用者的環境選擇器中。
1719* **使用者可以變更的內容**：使用者可以選取受管連線，並為其[設定自己的 **Worktree folder**](#set-the-worktree-folder-on-an-existing-connection)。他們無法在應用程式中編輯其他欄位或刪除該連線。
1478 1720
1479下列範例預先設定了單一連線：1721下列範例預先設定了單一連線：
1480 1722
1563若要確認設定已套用，請檢查開發人員的電腦：1805若要確認設定已套用，請檢查開發人員的電腦：
1564 1806
1565<Steps>1807<Steps>
1566 <Step title="檢查環境下拉選單">1808 <Step title="檢查環境選擇器">
1567 結束並重新開啟 Desktop，然後開啟提示詞方塊中的環境下拉選單。**Local** 會呈現灰色，且 **Shared Dev VM** 會出現在 **SSH** 下方。如果 **Local** 仍可使用，請檢查 Desktop 版本、檔案是否為有效的 JSON，以及電腦讀取的是哪個受管來源。1809 結束並重新開啟 Desktop，然後開啟[環境選擇器](#start-a-session)。如果其中顯示以下內容，表示設定已生效：
1810
1811 * 該電腦的項目，以灰色顯示
1812 * **SSH** 下的 **Shared Dev VM**。如果該處未列出，請點擊單一的 **SSH** 列，或群組末端的 **More**。
1813
1814 如果該電腦的項目仍可使用，請檢查是否為下列原因：
1815
1816 * **Desktop 版本**：如果 Desktop 早於 v1.37937.0，請更新 Desktop。
1817 * **受管設定檔**：請確保該檔案為有效的 JSON。
1818 * **受管來源**：請確保該電腦會讀取存放這些鍵的[受管來源](/docs/zh-TW/managed-settings#how-claude-code-combines-managed-sources)。
1568 </Step>1819 </Step>
1569 1820
1570 <Step title="新增不在允許清單上的主機">1821 <Step title="新增不在允許清單上的主機">
1571 使用不在允許清單上的主機名稱（例如 `other.example.com`）[新增 SSH 連線](#ssh-sessions)。Desktop 會儲存該連線但拒絕連線，並說明您組織的設定不允許該連線。1822 使用不在允許清單上的主機名稱（例如 `other.example.com`）[新增 SSH 連線](#ssh-sessions)。Desktop 會儲存該連線但拒絕連線，並表示您組織的設定不允許此連線。
1572 </Step>1823 </Step>
1573</Steps>1824</Steps>
1574 1825
1756 2007
1757| CLI | Desktop 等效項 |2008| CLI | Desktop 等效項 |
1758| - | - |2009| - | - |
1759| `--model sonnet` | 傳送按鈕旁的模型下拉式選單 |2010| `--model sonnet` | 提示詞方塊下方列中的模型選擇器 |
1760| `--resume`, `--continue` | 點擊側邊欄中的工作階段，或在提示詞方塊中輸入 `/resume` 以取得您從 CLI 啟動的工作階段 |2011| `--resume`, `--continue` | 點擊側邊欄中的工作階段，或在提示詞方塊中輸入 `/resume` 以取得您從 CLI 啟動的工作階段 |
1761| `--permission-mode` | 傳送按鈕旁的模式選擇器 |2012| `--permission-mode` | 提示詞方塊下方列中的模式選擇器 |
1762| `--dangerously-skip-permissions` | 略過權限模式。在 Pro 和 Max 方案上，在「設定」→「Claude Code」→「允許略過權限模式」中啟用它；在 Team 和 Enterprise 方案上，組織政策控制它 |2013| `--dangerously-skip-permissions` | 略過權限模式。在 Pro 和 Max 方案上，在「設定」→「Claude Code」→「允許略過權限模式」中啟用它；在 Team 和 Enterprise 方案上，組織政策控制它 |
1763| `--add-dir` | 在雲端工作階段中使用 **+** 按鈕新增多個儲存庫 |2014| `--add-dir` | 在本機和 SSH 工作階段中[將資料夾新增至工作階段](#add-folders-to-a-session)，或在雲端工作階段中選擇[多個儲存庫](#run-long-running-tasks-in-the-cloud) |
1764| `--allowedTools`, `--disallowedTools` | 沒有各別工作階段等效項。[設定檔](/docs/zh-TW/settings)中的權限規則仍然適用。 |2015| `--allowedTools`, `--disallowedTools` | 沒有各別工作階段等效項。[設定檔](/docs/zh-TW/settings)中的權限規則仍然適用。 |
1765| `--verbose` | [Verbose 檢視模式](#switch-view-modes) |2016| `--verbose` | [Verbose 檢視模式](#switch-view-modes) |
1766| `--print`, `--output-format` | 不可用。Desktop 僅限互動。 |2017| `--print`, `--output-format` | 不可用。Desktop 僅限互動。 |
1767| `ANTHROPIC_MODEL` 環境變數 | 傳送按鈕旁的模型下拉式選單 |2018| `ANTHROPIC_MODEL` 環境變數 | 提示詞方塊下方列中的模型選擇器 |
1768| `MAX_THINKING_TOKENS` 環境變數 | 在本機環境編輯器中設定。請參閱[環境設定](#environment-configuration)。 |2019| `MAX_THINKING_TOKENS` 環境變數 | 請參閱[關閉延伸思考](#turn-off-extended-thinking) |
1769 2020
1770<h3 id="shared-configuration">2021<h3 id="shared-configuration">
1771 共用設定2022 共用設定
1777* 在 `~/.claude.json` 或 `.mcp.json` 中設定的 **[MCP 伺服器](/docs/zh-TW/mcp)** 在兩者中都有效2028* 在 `~/.claude.json` 或 `.mcp.json` 中設定的 **[MCP 伺服器](/docs/zh-TW/mcp)** 在兩者中都有效
1778* 在設定中定義的 **[Hooks](/docs/zh-TW/hooks)** 和 **[skills](/docs/zh-TW/skills)** 適用於兩者2029* 在設定中定義的 **[Hooks](/docs/zh-TW/hooks)** 和 **[skills](/docs/zh-TW/skills)** 適用於兩者
1779* `~/.claude.json` 和 `~/.claude/settings.json` 中的 **[設定](/docs/zh-TW/settings)** 是共用的。`settings.json` 中的權限規則、允許的工具和其他設定適用於 Desktop 工作階段。2030* `~/.claude.json` 和 `~/.claude/settings.json` 中的 **[設定](/docs/zh-TW/settings)** 是共用的。`settings.json` 中的權限規則、允許的工具和其他設定適用於 Desktop 工作階段。
1780* **模型**：相同的[模型](/docs/zh-TW/model-config#available-models)在兩者中都可用。在 Desktop 中，從傳送按鈕旁的下拉式選單中選擇模型。您可以在工作階段期間從相同的下拉式選單變更模型。2031* **模型**：相同的[模型](/docs/zh-TW/model-config#available-models)在兩者中都可用。在 Desktop 中，從提示詞方塊下方列中的模型選擇器選擇模型。您可以在工作階段期間從相同的選擇器變更模型。
1781 2032
1782<h4 id="mcp-servers-from-the-claude-desktop-chat-app">2033<h4 id="mcp-servers-from-the-claude-desktop-chat-app">
1783 Claude Desktop 聊天應用程式中的 MCP 伺服器2034 Claude Desktop 聊天應用程式中的 MCP 伺服器
1805| [第三方提供者](/docs/zh-TW/third-party-integrations) | Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry | Anthropic 的 API 預設。若要進行閘道路由，請參閱[將桌面應用程式連接到閘道](/docs/zh-TW/llm-gateway-connect#desktop-app)。若要在 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 或自託管 LLM 閘道上執行 Code 標籤，請參閱 [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)。 |2056| [第三方提供者](/docs/zh-TW/third-party-integrations) | Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry | Anthropic 的 API 預設。若要進行閘道路由，請參閱[將桌面應用程式連接到閘道](/docs/zh-TW/llm-gateway-connect#desktop-app)。若要在 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 或自託管 LLM 閘道上執行 Code 標籤，請參閱 [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)。 |
1806| [MCP 伺服器](/docs/zh-TW/mcp) | 在設定檔中設定 | 本機和 SSH 工作階段的連接器 UI，或設定檔 |2057| [MCP 伺服器](/docs/zh-TW/mcp) | 在設定檔中設定 | 本機和 SSH 工作階段的連接器 UI，或設定檔 |
1807| [外掛](/docs/zh-TW/plugins/overview) | `/plugin` 命令 | 外掛管理器 UI |2058| [外掛](/docs/zh-TW/plugins/overview) | `/plugin` 命令 | 外掛管理器 UI |
1808| @mention 檔案 | 文字型 | 具有自動完成；僅限本機和 SSH 工作階段 |2059| @mention 檔案 | 文字型 | 具有自動完成，但雲端工作階段的第一則訊息除外 |
1809| 檔案附件 | 不可用 | 影像、PDF |2060| 檔案附件 | 不可用 | 影像、PDF |
1810| 工作階段隔離 | [`--worktree`](/docs/zh-TW/cli-reference) 旗標 | 啟動工作階段時的 **worktree** 選項 |2061| 工作階段隔離 | [`--worktree`](/docs/zh-TW/cli-reference) 旗標 | [在專屬 worktree 中執行工作階段](#run-a-session-in-its-own-worktree) |
1811| 多個工作階段 | 單獨的終端機 | 側邊欄標籤 |2062| 多個工作階段 | 單獨的終端機 | 側邊欄標籤 |
1812| 定期任務 | Cron 工作、CI 管道 | [排程任務](/docs/zh-TW/desktop-scheduled-tasks) |2063| 定期任務 | Cron 工作、CI 管道 | [排程任務](/docs/zh-TW/desktop-scheduled-tasks) |
1813| 電腦使用 | [透過 `/mcp` 在 macOS 上啟用](/docs/zh-TW/computer-use) | [應用程式和螢幕控制](#let-claude-use-your-computer)在 macOS 和 Windows 上 |2064| 電腦使用 | [透過 `/mcp` 在 macOS 上啟用](/docs/zh-TW/computer-use) | [應用程式和螢幕控制](#let-claude-use-your-computer)在 macOS 和 Windows 上 |
1833 疑難排解2084 疑難排解
1834</h2>2085</h2>
1835 2086
1836下面的部分涵蓋桌面應用程式特定的問題。對於出現在聊天中的執行時 API 錯誤，例如 `API Error: 500`、`529 Overloaded`、`429` 或 `Prompt is too long`，請參閱[錯誤參考](/docs/zh-TW/errors)。這些錯誤及其修復在 CLI、Desktop 和網路中是相同的。2087下面的部分涵蓋桌面應用程式特定的問題。對於出現在聊天中的執行時 API 錯誤，例如 `API Error: 500`、`529 Overloaded`、`429` 或 `Prompt is too long`，請參閱[錯誤參考](/docs/zh-TW/errors)。
1837 2088
1838<h3 id="check-your-version">2089<h3 id="check-your-version">
1839 檢查您的版本2090 檢查您的版本
1852 2103
1853若要查看工作階段執行的 Claude Code 版本，請在 **Code** 標籤的本機工作階段中輸入 `/status`，並查看 **Claude Code** 列，其中會顯示如 `2.1.286` 的版本。2104若要查看工作階段執行的 Claude Code 版本，請在 **Code** 標籤的本機工作階段中輸入 `/status`，並查看 **Claude Code** 列，其中會顯示如 `2.1.286` 的版本。
1854 2105
1855若要為本機工作階段取得較新的版本，請在 macOS 上開啟 **Claude → Check for Updates**，或在 Windows 上開啟 **Help → Check for Updates**，然後啟動新的工作階段。2106若要為本機工作階段取得較新的版本，請在 macOS 上開啟 **Claude > Check for Updates…**，或在 Windows 上開啟 **Help > Check for Updates…**，然後啟動新的工作階段。
1856 2107
1857在本機工作階段中，**Code** 標籤會執行其自己的 Claude Code 副本，該副本有自己的版本號。桌面應用程式會下載並更新該副本，因此它可能與您終端機中的 `claude` 命令不同，且更新其中一個不會更新另一個。2108在本機工作階段中，**Code** 標籤會執行其自己的 Claude Code 副本，該副本有自己的版本號。桌面應用程式會下載並更新該副本，因此它可能與您終端機中的 `claude` 命令不同，且更新其中一個不會更新另一個。
1858 2109
2110<h3 id="check-which-layout-you-have">
2111 檢查您使用的版面配置
2112</h3>
2113
2114如果新工作階段的提示詞方塊下方沒有[環境選擇器](#start-a-session)，表示您使用的是較早的版面配置：
2115
2116* **[早於 v2.37337.0 的 Desktop](#check-your-version)**：請更新以取得目前的版面配置。在 macOS 上選擇 **Claude > Check for Updates…**，或在 Windows 上選擇 **Help > Check for Updates…**。
2117* **[第三方提供者](/docs/zh-TW/third-party-integrations)**：您會保留較早的版面配置，因此無需執行任何操作。
2118
2119在較早的版面配置中，請在提示詞方塊上方選擇環境和專案資料夾，並在其下方的列中選擇權限模式和模型。較早的版面配置沒有[工作階段詳細資訊面板](#see-session-details)和[已儲存的本機與 SSH 環境](#create-a-saved-environment)。
2120
1859<h3 id="403-or-authentication-errors-in-the-code-tab">2121<h3 id="403-or-authentication-errors-in-the-code-tab">
1860 Code 標籤中的 403 或驗證錯誤2122 Code 標籤中的 403 或驗證錯誤
1861</h3>2123</h3>
