From 09eea6a580220bc1fb2cd4180a844450225b922e Mon Sep 17 00:00:00 2001 From: Craig Osterhout Date: Wed, 29 Jul 2026 10:23:18 -0700 Subject: [PATCH] sbx: add claude desktop ssh callout Signed-off-by: Craig Osterhout --- .../ai/sandboxes/integrations/claude-desktop.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/content/manuals/ai/sandboxes/integrations/claude-desktop.md b/content/manuals/ai/sandboxes/integrations/claude-desktop.md index 05fa662e19c..e6f232ced0c 100644 --- a/content/manuals/ai/sandboxes/integrations/claude-desktop.md +++ b/content/manuals/ai/sandboxes/integrations/claude-desktop.md @@ -26,6 +26,11 @@ host. ## Connect +> [!WARNING] +> Connecting Claude Desktop to a sandbox over SSH transmits Anthropic +> credentials into the Claude Code process within the sandbox, reducing +> isolation guarantees. + Confirm that you can connect to the sandbox from a terminal: ```console @@ -45,6 +50,15 @@ picker might initially open at `/home/agent`. For more connection options, see the Claude Desktop instructions for [SSH sessions](https://code.claude.com/docs/en/desktop#ssh-sessions). +## Troubleshoot a broken SSH connection after token refresh + +The SSH connection drops when the Anthropic token expires and needs to be +refreshed. To work around this, run the sandbox manually from your host: + +```console +$ sbx run --name +``` + ## Troubleshoot SSH connection timeouts on Windows Claude Desktop requires Git on Windows. If an SSH connection times out and the