llms.txt@16-Mobile-Desktop · git:20260929.7f0bce1 · 2026-09-29 · sha256 2255ddd9aa166ee1
llms.txt@16-Mobile-Desktop git:20260929.7f0bce1F
Immutable. This exact content never changes and is served at /api/v1/blob/2255ddd9aa166ee1.
# Mobile Desktop
All documentation for Mobile Desktop.
---
## access-claude-for-ios-on-your-lock-screen-control-center-and-action-button-7003e1657f.md
# Access Claude for iOS on your Lock Screen, Control Center, and Action button
July 9, 2026
Copy for LLM
The features described in this guide are available on iOS 18 and above.
Quickly access Claude for iOS functionality from your Lock Screen, Control Center, or Action button on iOS. This article will explain how to add the Claude app into these areas.
## Add Claude for iOS to your Lock Screen
1. Tap and hold your Lock Screen to open Customize Wallpaper
2. Tap "Customize."
3. Choose "Lock Screen."
4. Click on an empty area on either of the two bottom circular slots.
5. Scroll to add “Open Claude..”
6. Click “Done” on the top right corner.
You’ll now be able to tap and hold to open Claude for iOS from your **[Lock Screen](https://support.apple.com/guide/iphone/create-a-custom-lock-screen-iph4d0e6c351/ios)**.
## Add Claude for iOS to the Control Center
1. Swipe down from the upper right side of your screen to open the Control Center.
2. Tap & Hold to add a control
3. Tap “Add a Control.”
4. Scroll to add “Open Claude.”
You’ll now be able to access Claude for iOS from your **[Control Center](https://support.apple.com/guide/iphone/use-and-customize-control-center-iph59095ec58/ios)**.
## Use the Action button to open Claude for iOS
1. Open the Settings app.
2. Go into the “Action Button” settings.
3. Swipe until you see "Controls."
4. Click "Choose a Control..."
5. Scroll to “Open Claude.”
6. Click back into Settings.
You’ll now be able to Hold to Open the **[Action button](https://support.apple.com/guide/iphone/use-and-customize-the-action-button-iphe89d61d66/18.0/ios/18.0)** to access Claude for iOS.
---
## accessing-claude-app-on-ios-lock-screen-control-center-and-action-button-6d69f0b111.md
# Access Claude for iOS on your Lock Screen, Control Center, and Action button
July 9, 2026
Copy for LLM
The features described in this guide are available on iOS 18 and above.
Quickly access Claude for iOS functionality from your Lock Screen, Control Center, or Action button on iOS. This article will explain how to add the Claude app into these areas.
## Add Claude for iOS to your Lock Screen
1. Tap and hold your Lock Screen to open Customize Wallpaper
2. Tap "Customize."
3. Choose "Lock Screen."
4. Click on an empty area on either of the two bottom circular slots.
5. Scroll to add “Open Claude..”
6. Click “Done” on the top right corner.
You’ll now be able to tap and hold to open Claude for iOS from your **[Lock Screen](https://support.apple.com/guide/iphone/create-a-custom-lock-screen-iph4d0e6c351/ios)**.
## Add Claude for iOS to the Control Center
1. Swipe down from the upper right side of your screen to open the Control Center.
2. Tap & Hold to add a control
3. Tap “Add a Control.”
4. Scroll to add “Open Claude.”
You’ll now be able to access Claude for iOS from your **[Control Center](https://support.apple.com/guide/iphone/use-and-customize-control-center-iph59095ec58/ios)**.
## Use the Action button to open Claude for iOS
1. Open the Settings app.
2. Go into the “Action Button” settings.
3. Swipe until you see "Controls."
4. Click "Choose a Control..."
5. Scroll to “Open Claude.”
6. Click back into Settings.
You’ll now be able to Hold to Open the **[Action button](https://support.apple.com/guide/iphone/use-and-customize-the-action-button-iphe89d61d66/18.0/ios/18.0)** to access Claude for iOS.
---
## accessing-claude-app-on-ios-lock-screen-control-center-and-action-button.md
4. Accessing Claude app on iOS Lock Screen, Control Center, and Action Button
# Accessing Claude app on iOS Lock Screen, Control Center, and Action Button
The features described in this guide are available on iOS 18 and above.
Quickly access Claude app functionality from your Lock Screen, Control Center, or Action Button on iOS. This article will explain how to add the Claude app into these areas.
## **Add Claude app to your Lock Screen**
- Tap and hold your Lock Screen to open Customize Wallpaper
- Tap Customize
- Choose Lock Screen
- Click on an empty area on either of the two bottom circular slots
- Scroll to add “Open Claude”
- Click “Done” on the top right corner
You’ll now be able to tap and hold to open the Claude app from your [Lock Screen](https://support.apple.com/guide/iphone/create-a-custom-lock-screen-iph4d0e6c351/ios).
## **Add Claude app to Control Center**
- Swipe down from the upper right side of your screen to open the Control Center
- Tap & Hold to add a control
- Tap “Add a Control”
- Scroll to add “Open Claude”
You’ll now be able to access the Claude app from your [Control Center](https://support.apple.com/guide/iphone/use-and-customize-control-center-iph59095ec58/ios).
## **Use the Action Button to Open Claude app**
- Open the Settings app
- Go into the “Action Button” settings
- Swipe until you see "Controls"
- Click "Choose a Control..."
- Scroll to “Open Claude”
- Click back into Settings
You’ll now be able to Hold to Open the [Action Button](https://support.apple.com/guide/iphone/use-and-customize-the-action-button-iphe89d61d66/18.0/ios/18.0) to access the Claude app.
---
## building-desktop-extensions-with-mcpb-c3d6b6874b.md
# Building Desktop Extensions with MCPB
April 15, 2026
Copy for LLM
The MCPB and Desktop Extensions build guide has moved to the Claude developer docs.
[View the MCPB build guide →](https://claude.com/docs/connectors/building/mcpb)
---
## deploy-claude-desktop-for-macos-8a2c7c0d68.md
# Deploy Claude Desktop for macOS
March 16, 2026
Copy for LLM
Administrators on Team or Enterprise plans can deploy Claude Desktop automatically to manage installations and updates centrally. Claude Desktop installs to \`/Applications\` and updates automatically when new versions are released, unless disabled via enterprise policies.
## Available installation formats
- **\`.pkg\`** - Standard macOS installer package (recommended for enterprise)
- **\`.dmg\`** - Drag-and-drop installation
## Cowork requirements
Cowork will be installed automatically when you download and install Claude Desktop for macOS.
## Download
**[Universal (x64 or arm64) Claude PKG](https://claude.ai/api/desktop/darwin/universal/pkg/latest/redirect)**
The Universal build is compatible with both Intel and Apple Silicon machines and supports all Mac hardware.
## Deploy via MDM
Upload the PKG to your MDM solution (Jamf, Kandji, Microsoft Intune) and deploy to target machines.
## Configuration
To configure Claude Desktop settings such as auto-updates, extensions, and MCP servers, see the **[Enterprise Configuration](https://support.claude.com/en/articles/12622667-enterprise-configuration)** article.
## Troubleshooting
### Users cannot update Claude Desktop
Claude Desktop can be installed to either the user's Applications folder or the system Applications folder, which affects update permissions.
- \`~/Applications\` (user folder): Users can update without administrator privileges
- \`/Applications\` (system folder): Users need administrator access and write permissions to \`/Applications\`, \`Claude.app\`, and all contained files
For shared machines, disable auto-updates via enterprise policies and manage updates centrally through your MDM solution.
---
## deploy-claude-desktop-for-windows-570e82f21c.md
# Deploy Claude Desktop for Windows
July 13, 2026
Copy for LLM
Administrators on Team or Enterprise plans can deploy Claude Desktop automatically across their organization to manage installations and updates centrally. We offer MSIX packages for Windows deployments via Microsoft Intune, SCCM, Group Policy, or PowerShell.
## Installation requirements
- For individual installations with full feature support including Claude Cowork, administrator privileges are required. Users will see a Windows UAC prompt during installation. Users without admin access can still install Claude, but Cowork on desktop will not be available. Access the user-friendly installer from **[our download page](https://claude.com/download)**.
- For silent deployment without user interaction, use the MSIX package directly with your enterprise management tool.
## Cowork desktop requirements
Claude Desktop for Windows requires the **[Virtual Machine Platform](https://support.microsoft.com/en-us/windows/enable-virtualization-on-windows-c5578302-6e43-4b4b-a449-8ced115f58e1)** to use Cowork. You can automate installation of this feature via most endpoint management solutions, but you may also run the following command to install it manually:
powershell
Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -All -NoRestart
The feature takes effect after the machine restarts. The `-NoRestart` flag suppresses the automatic restart for silent deployment, so schedule one through your management tool.
## Download
- **[Claude MSIX (x64)](https://claude.ai/api/desktop/win32/x64/msix/latest/redirect)**
- **[Claude MSIX (arm64)](https://claude.ai/api/desktop/win32/arm64/msix/latest/redirect)**
## Installation commands
The Claude MSIX is packaged as a per-user application. `Add-AppxPackage` registers it for the current user only, while `Add-AppxProvisionedPackage` stages it machine-wide so it's available to every user on the device, including standard users without admin rights.
### Install for single user
powershell
Add-AppxPackage -Path "Claude.msix"
For more details, see Microsoft's **[Add-AppxPackage](https://learn.microsoft.com/en-us/powershell/module/appx/add-appxpackage?view=windowsserver2022-ps)** documentation.
### Install for all users (provisions machine-wide)
powershell
Add-AppxProvisionedPackage -Online -PackagePath "Claude.msix" -SkipLicense -Regions "all"
For more details, see Microsoft's **[Add-AppxProvisionedPackage](https://learn.microsoft.com/en-us/powershell/module/dism/add-appxprovisionedpackage?view=windowsserver2022-ps)** documentation.
## Deploy via MDM
**Important:** Because the MSIX is packaged per-user, uploading it to Intune as a line-of-business (LOB) app installs it in user context rather than machine-wide. The install fails for standard users without admin rights. For machine-wide deployment, run `Add-AppxProvisionedPackage` against the package instead—either pre-stage it on target devices before users sign in, or deliver the command through a Win32 app or PowerShell script wrapper. Intune LOB can't run this command on your behalf.
Claude Desktop can be deployed through various enterprise software distribution services. Choose the method that aligns with your organization's existing infrastructure:
- **[Microsoft Intune](https://docs.microsoft.com/en-us/windows/msix/desktop/managing-your-msix-deployment-intune)**
- **[Microsoft Endpoint Configuration Manager (SCCM)](https://learn.microsoft.com/en-us/windows/msix/desktop/managing-your-msix-deployment-mem-adminconsole)**
- **[Group Policy Software Installation](https://learn.microsoft.com/en-us/troubleshoot/windows-server/group-policy/use-group-policy-to-install-software)**
- **[Deployment Image Servicing and Management (DISM.exe)](https://learn.microsoft.com/en-us/windows-hardware/manufacture/desktop/preinstall-apps-using-dism?view=windows-10)**
- **[PowerShell Scripts](https://learn.microsoft.com/en-us/windows/msix/desktop/powershell-msix-cmdlets)**
### Manage auto-updates alongside your MDM
By default, Claude Desktop checks for updates approximately every four hours and applies them automatically—independent of the version your MDM has assigned. To keep the in-app updater and your MDM from conflicting, choose one of these approaches before you deploy:
**Option 1: Your MDM manages versions.** Set the `disableAutoUpdates` policy to `1` and push new MSIX builds through your MDM on your own schedule. See **[Enterprise configuration for Claude Desktop](https://support.claude.com/en/articles/12622667-enterprise-configuration-for-claude-desktop)** for the policy location.
**Option 2: Claude Desktop manages versions.** Leave `disableAutoUpdates` unset. Deploy the MSIX once via a Win32-wrapped `Add-AppxProvisionedPackage` install, then use a custom detection script that checks `Get-AppxPackage -Name Claude` for a version greater than or equal to the one you provisioned. This keeps your MDM reporting **Installed** after the app self-updates.
## Configuration
To configure Claude Desktop settings such as auto-updates, extensions, and MCP servers, see **[Enterprise configuration](https://support.claude.com/en/articles/12622667-enterprise-configuration)**.
------------------------------------------------------------------------
## Troubleshooting
### MSIX package not working with AppLocker?
By default, packaged apps may be restricted by AppLocker policies. Ensure your AppLocker rules allow MSIX packages, or add Claude Desktop to your allowed applications list. Consult your organization's security policies before making changes.
### "The parameter is incorrect" after MDM deployment
This usually means the in-app updater and your MDM have both registered the package, leaving duplicate entries under the `Claude` package family. Pick a single update owner using the guidance in **[Manage auto-updates alongside your MDM](#h_1297fb34f3)** above.
### Intune install fails for standard users, or Cowork won't start on Claude Desktop?
Both symptoms indicate the MSIX was installed in user context rather than provisioned machine-wide:
- **Install fails for standard users:** An Intune LOB deployment of the MSIX runs in user context, so standard users without admin rights can't complete it. Redeploy by running `Add-AppxProvisionedPackage` through a Win32 app, PowerShell script wrapper, or pre-staged package.
- **Cowork unavailable on desktop after install:** A per-user `Add-AppxPackage` install can complete without registering the Cowork virtualization service, the Windows service Cowork depends on. Claude appears installed but Cowork won't start. Redeploy using `Add-AppxProvisionedPackage` so the service registers machine-wide.
### Cowork reports missing HCS services or virtualization errors
If Cowork fails to start with an error like "Missing HCS services: HNS, vmcompute, vfpext," the Virtual Machine Platform service stack isn't registered on the machine, even if Claude installed successfully.
**To diagnose and fix:**
Check whether the feature is enabled and its services exist:
powershell
Get-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform Get-Service vmcompute, hns
If the feature shows as disabled or the services are missing, re-enable it:
powershell
Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -All
Restart the machine using **Restart**, not shut down and power on. With Windows Fast Startup enabled, a shutdown cycle can leave the virtualization services uninitialized.
If VMware or VirtualBox is also installed on the machine, confirm the Windows hypervisor is set to launch at boot. Run `bcdedit` from an elevated prompt and check that `hypervisorlaunchtype` reads `Auto`. If it doesn't, run `bcdedit /set hypervisorlaunchtype auto` and restart.
**Note:** Virtual machines and VDI environments without nested virtualization aren't supported, so Cowork can't run on these hosts. To see exactly which check is failing, go to **Help \> Troubleshooting \> Show Logs** in Claude Desktop and review `supported-features-info.json`.
---
## desktop-application-claude-code-docs-dc0e6ba558.md
# Desktop application
Get more out of Claude Code Desktop: parallel sessions with Git isolation, drag-and-drop pane layout, integrated terminal and file editor, side chats, computer use, Dispatch sessions from your phone, visual diff review, app previews, PR monitoring, connectors, and enterprise configuration.
> ## Documentation Index
>
> Fetch the complete documentation index at: <https://code.claude.com/docs/llms.txt>
>
> Use this file to discover all available pages before exploring further.
The Claude Desktop app has three tabs: **Chat** for conversations, **Cowork** for [Dispatch and longer agentic work](https://claude.com/product/cowork), and **Code** for software development. This page is the reference for the Code tab.
## Download for macOS
Universal build for Intel and Apple Silicon
## Download for Windows
For x64 processors
For Windows ARM64, download the [ARM64 installer](https://claude.ai/api/desktop/win32/arm64/setup/latest/redirect?utm_source=claude_code&utm_medium=docs). The desktop app is not available on Linux; use the [CLI](/docs/en/quickstart) instead. After installing, launch Claude, sign in, and click the **Code** tab. The first time you open it on Windows, you need [Git for Windows](https://git-scm.com/downloads/win) installed; restart the app after installing it. For a walkthrough of your first session, see the [Get started guide](/docs/en/desktop-quickstart). In the Code tab, each conversation is a **session**: it has its own chat history, project folder, and code changes, independent of any other session. The sidebar lists your sessions and lets you run several in parallel. Within a session you can:
- [Review and comment on diffs](#review-changes-with-diff-view), then [watch the resulting PR through CI](#monitor-pull-request-status)
- [Preview your running app](#preview-your-app) in an embedded browser while Claude verifies its own changes
- [Arrange panes](#arrange-your-workspace) for the chat, diff, preview, terminal, and file editor side by side
- Ask a [side question](#ask-a-side-question-without-derailing-the-session) that uses the session’s context without derailing it
- [Connect external tools](#connect-external-tools) like GitHub, Slack, and Linear
- Let Claude [open apps and control your screen](#let-claude-use-your-computer)
- Run on your machine, in the [cloud](#run-long-running-tasks-remotely), or over [SSH](#ssh-sessions)
For [scheduled recurring work](/docs/en/desktop-scheduled-tasks), [keyboard shortcuts](#keyboard-shortcuts), or [sending tasks from your phone](#sessions-from-dispatch), see the linked pages and sections. If you already use the terminal-based CLI, see the [CLI comparison](#coming-from-the-cli) for what carries over.
Start a session
Before you send your first message, configure four things in the prompt area:
- **Environment**: choose where Claude runs. Select **Local** for your machine, **Remote** for Anthropic-hosted cloud sessions, or an [**SSH connection**](#ssh-sessions) for a remote machine you manage. See [environment configuration](#environment-configuration).
- **Project folder**: select the folder or repository Claude works in. For remote sessions, you can add [multiple repositories](#run-long-running-tasks-remotely).
- **Model**: pick a [model](/docs/en/model-config#available-models) from the dropdown next to the send button. You can change this during the session.
- **Permission mode**: choose how much autonomy Claude has from the [mode selector](#choose-a-permission-mode). You can change this during the session.
Type your task and press **Enter** to start. Each session tracks its own context and changes independently.
Work with code
Give Claude the right context, control how much it does on its own, and review what it changed.
Use the prompt box
Type what you want Claude to do and press **Enter** to send. Claude reads your project files, makes changes, and runs commands based on your [permission mode](#choose-a-permission-mode). You can interrupt Claude at any point: click the stop button or type your correction and press **Enter**. Claude stops what it’s doing and adjusts based on your input. The **+** button next to the prompt box gives you access to file attachments, [skills](#use-skills), [connectors](#connect-external-tools), and [plugins](#install-plugins).
Add files and context to prompts
The prompt box supports two ways to bring in external context:
- **@mention files**: type `@` followed by a filename to add a file to the conversation context. Claude can then read and reference that file. @mention is not available in remote sessions.
- **Attach files**: attach images, PDFs, and other files to your prompt using the attachment button, or drag and drop files directly into the prompt. This is useful for sharing screenshots of bugs, design mockups, or reference documents.
Choose a permission mode
Permission modes control how much autonomy Claude has during a session: whether it asks before editing files, running commands, or both. You can switch modes at any time using the mode selector next to the send button. Start with Ask permissions to see exactly what Claude does, then move to Auto accept edits or Plan mode as you get comfortable.
| Mode | Settings key | Behavior |
|------------------------|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Ask permissions** | `default` | Claude asks before editing files or running commands. You see a diff and can accept or reject each change. Recommended for new users. |
| **Auto accept edits** | `acceptEdits` | Claude auto-accepts file edits and common filesystem commands like `mkdir`, `touch`, and `mv`, but still asks before running other terminal commands. Use this when you trust file changes and want faster iteration. |
| **Plan mode** | `plan` | Claude reads files and runs commands to explore, then proposes a plan without editing your source code. Good for complex tasks where you want to review the approach first. |
| **Auto** | `auto` | Claude executes all actions with background safety checks that verify alignment with your request. Reduces permission prompts while maintaining oversight. Enable in your Settings → Claude Code. See [availability requirements](#auto-mode-availability) below. |
| **Bypass permissions** | `bypassPermissions` | Claude runs without any permission prompts, equivalent to the admin-gated bypass option in the CLI. Enable in your Settings → Claude Code under “Allow bypass permissions mode”. Only use this in sandboxed containers or VMs. Enterprise admins can disable this option. |
The `dontAsk` permission mode is available only in the [CLI](/docs/en/permission-modes#allow-only-pre-approved-tools-with-dontask-mode). Auto mode is a research preview available on Max, Team, Enterprise, and API plans. It is not available on Pro plans or third-party providers. On Team, Enterprise, and API plans it requires Claude Sonnet 4.6, Opus 4.6, or Opus 4.7. On Max plans it requires Claude Opus 4.7.
Start complex tasks in Plan mode so Claude maps out an approach before making changes. Once you approve the plan, switch to Auto accept edits or Ask permissions to execute it. See [explore first, then plan, then code](/docs/en/best-practices#explore-first-then-plan-then-code) for more on this workflow.
Remote sessions support Auto accept edits and Plan mode. Ask permissions is not available because remote sessions auto-accept file edits by default, and Bypass permissions is not available because the remote environment is already sandboxed. Enterprise admins can restrict which permission modes are available. See [enterprise configuration](#enterprise-configuration) for details.
Preview your app
Claude can start a dev server and open an embedded browser to verify its changes. This works for frontend web apps as well as backend servers: Claude can test API endpoints, view server logs, and iterate on issues it finds. In most cases, Claude starts the server automatically after editing project files. You can also ask Claude to preview at any time. By default, Claude [auto-verifies](#auto-verify-changes) changes after every edit. The preview pane can also open static HTML files, PDFs, images, and videos from your project. Click an HTML, PDF, image, or video path in the chat to open it in preview. From the preview pane, you can:
- Interact with your running app directly in the embedded browser
- Watch Claude verify its own changes automatically: it takes screenshots, inspects the DOM, clicks elements, fills forms, and fixes issues it finds
- Start or stop servers from the **Preview** dropdown in the session toolbar
- Persist cookies and local storage across server restarts by selecting **Persist sessions** in the dropdown, so you don’t have to re-login during development
- Edit the server configuration or stop all servers at once
Claude creates the initial server configuration based on your project. If your app uses a custom dev command, edit `.claude/launch.json` to match your setup. See [Configure preview servers](#configure-preview-servers) for the full reference. To clear saved session data, toggle **Persist preview sessions** off in Settings → Claude Code. To disable preview entirely, toggle off **Preview** in Settings → Claude Code.
Review changes with diff view
After Claude makes changes to your code, the diff view lets you review modifications file by file before creating a pull request. When Claude changes files, a diff stats indicator appears showing the number of lines added and removed, such as `+12 -1`. Click this indicator to open the diff viewer, which displays a file list on the left and the changes for each file on the right. To comment on specific lines, click any line in the diff to open a comment box. Type your feedback and press **Enter** to add the comment. After adding comments to multiple lines, submit all comments at once:
- **macOS**: press **Cmd+Enter**
- **Windows**: press **Ctrl+Enter**
Claude reads your comments and makes the requested changes, which appear as a new diff you can review.
Review your code
In the diff view, click **Review code** in the top-right toolbar to ask Claude to evaluate the changes before you commit. Claude examines the current diffs and leaves comments directly in the diff view. You can respond to any comment or ask Claude to revise. The review focuses on high-signal issues: compile errors, definite logic errors, security vulnerabilities, and obvious bugs. It does not flag style, formatting, pre-existing issues, or anything a linter would catch.
Monitor pull request status
After you open a pull request, a CI status bar appears in the session. Claude Code uses the GitHub CLI to poll check results and surface failures.
- **Auto-fix**: when enabled, Claude automatically attempts to fix failing CI checks by reading the failure output and iterating.
- **Auto-merge**: when enabled, Claude merges the PR once all checks pass. The merge method is squash. Auto-merge must be [enabled in your GitHub repository settings](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) for this to work.
Use the **Auto-fix** and **Auto-merge** toggles in the CI status bar to enable either option. Claude Code also sends a desktop notification when CI finishes. To archive the session automatically once the PR merges or closes, turn on [auto-archive](#work-in-parallel-with-sessions) in Settings → Claude Code.
PR monitoring requires the [GitHub CLI (`gh`)](https://cli.github.com/) to be installed and authenticated on your machine. If `gh` is not installed, Desktop prompts you to install it the first time you try to create a PR.
Arrange your workspace
The Code tab is built around panes you can arrange in any layout: chat, diff, preview, terminal, file, plan, tasks, and subagent. Drag a pane by its header to reposition it, or drag a pane edge to resize it. Press **Cmd+\\** on macOS or **Ctrl+\\** on Windows to close the focused pane. Open additional panes from the **Views** menu in the session toolbar.
The pane layout, terminal, file editor, and view modes in this section require Claude Desktop v1.2581.0 or later. Open **Claude → Check for Updates** on macOS or **Help → Check for Updates** on Windows to update.
Run commands in the terminal
The integrated terminal lets you run commands alongside your session without switching to another app. Open it from the **Views** menu or press **Ctrl+\`** on macOS or Windows. The terminal opens in your session’s working directory and shares the same environment as Claude, so commands like `npm test` or `git status` see the same files Claude is editing. To open a second terminal tab, click **+** in the terminal pane header or right-click a folder in the chat to choose **Open in terminal**. The terminal is available in local sessions only.
Open and edit files
Click a file path in the chat or diff viewer to open it in the file pane. HTML, PDF, image, and video paths open in the [preview pane](#preview-your-app) instead. Make spot edits and click **Save** to write them back. If the file changed on disk since you opened it, the pane warns you and lets you override or discard. Click **Discard** to revert your edits, or click the path in the pane header to copy the absolute path. The file pane is available in local and SSH sessions. For remote sessions, ask Claude to make the change.
Open files in other apps
Right-click any file path in the chat, diff viewer, or file pane to open a context menu:
- **Attach as context**: add the file to your next prompt
- **Open in**: open the file in an installed editor such as VS Code, Cursor, or Zed
- **Show in Finder** on macOS, **Show in Explorer** on Windows: open the containing folder
- **Copy path**: copy the absolute path to your clipboard
Switch view modes
View modes control how much detail appears in the chat transcript. Switch modes from the **Transcript view** dropdown next to the send button, or press **Ctrl+O** on macOS or Windows to cycle through them.
| Mode | What it shows |
|-------------|----------------------------------------------------------------|
| **Normal** | Tool calls collapsed into summaries, with full text responses |
| **Verbose** | Every tool call, file read, and intermediate step Claude takes |
| **Summary** | Only Claude’s final responses and the changes it made |
Use Verbose when debugging why Claude took a particular action. Use Summary when you’re running multiple sessions and want to scan results quickly.
Keyboard shortcuts
Press **Cmd+/** on macOS or **Ctrl+/** on Windows to see all shortcuts available in the Code tab. On Windows, use **Ctrl** in place of **Cmd** for the shortcuts below. Session cycling, the terminal toggle, and the view-mode toggle use **Ctrl** on every platform.
| Shortcut | Action |
|---------------------------------------|------------------------------|
| `Cmd` `/` | Show keyboard shortcuts |
| `Cmd` `N` | New session |
| `Cmd` `W` | Close session |
| `Ctrl` `Tab` / `Ctrl` `Shift` `Tab` | Next or previous session |
| `Cmd` `Shift` `]` / `Cmd` `Shift` `[` | Next or previous session |
| `Esc` | Stop Claude’s response |
| `Cmd` `Shift` `D` | Toggle diff pane |
| `Cmd` `Shift` `P` | Toggle preview pane |
| `Cmd` `Shift` `S` | Select an element in preview |
| `Ctrl` `` ` `` | Toggle terminal pane |
| `Cmd` `\` | Close focused pane |
| `Cmd` `;` | Open side chat |
| `Ctrl` `O` | Cycle view modes |
| `Cmd` `Shift` `M` | Open permission mode menu |
| `Cmd` `Shift` `I` | Open model menu |
| `Cmd` `Shift` `E` | Open effort menu |
| `1`–`9` | Select item in an open menu |
These shortcuts apply only to the Code tab. The terminal-based [interactive mode shortcuts](/docs/en/interactive-mode#keyboard-shortcuts), such as `Shift+Tab` to cycle modes, do not apply in Desktop.
Check usage
Click the usage ring next to the model picker to see your current context window usage and your plan usage for the period. Context usage is per session; plan usage is shared across all your Claude Code surfaces.
Let Claude use your computer
Computer use lets Claude open your apps, control your screen, and work directly on your machine the way you would. Ask Claude to test a native app in a mobile simulator, interact with a desktop tool that has no CLI, or automate something that only works through a GUI.
Computer use is a research preview on macOS and Windows that requires a Pro or Max plan. It is not available on Team or Enterprise plans. The Claude Desktop app must be running.
Computer use is off by default. [Enable it in Settings](#enable-computer-use) before Claude can control your screen. On macOS, you also need to grant Accessibility and Screen Recording permissions.
Unlike the [sandboxed Bash tool](/docs/en/sandboxing), computer use runs on your actual desktop with access to whatever you approve. Claude checks each action and flags potential prompt injection from on-screen content, but the trust boundary is different. See the [computer use safety guide](https://support.claude.com/en/articles/14128542) for best practices.
When computer use applies
Claude has several ways to interact with an app or service, and computer use is the broadest and slowest. It tries the most precise tool first:
- If you have a [connector](#connect-external-tools) for a service, Claude uses the connector.
- If the task is a shell command, Claude uses Bash.
- If the task is browser work and you have [Claude in Chrome](/docs/en/chrome) set up, Claude uses that.
- If none of those apply, Claude uses computer use.
The [per-app access tiers](#app-permissions) reinforce this: browsers are capped at view-only, and terminals and IDEs at click-only, steering Claude toward the dedicated tool even when computer use is active. Screen control is reserved for things nothing else can reach, like native apps, hardware control panels, mobile simulators, or proprietary tools without an API.
Enable computer use
Computer use is off by default. If you ask Claude to do something that needs it while it’s off, Claude tells you it could do the task if you enable computer use in Settings.
1
Update the desktop app
Make sure you have the latest version of Claude Desktop. Download or update at [claude.com/download](https://claude.com/download), then restart the app.
2
Turn on the toggle
In the desktop app, go to **Settings \> General** (under **Desktop app**). Find the **Computer use** toggle and turn it on. On Windows, the toggle takes effect immediately and setup is complete. On macOS, continue to the next step.If you don’t see the toggle, confirm you’re on macOS or Windows with a Pro or Max plan, then update and restart the app.
3
Grant macOS permissions
On macOS, grant two system permissions before the toggle takes effect:
- **Accessibility**: lets Claude click, type, and scroll
- **Screen Recording**: lets Claude see what’s on your screen
The Settings page shows the current status of each permission. If either is denied, click the badge to open the relevant System Settings pane.
App permissions
The first time Claude needs to use an app, a prompt appears in your session. Click **Allow for this session** or **Deny**. Approvals last for the current session, or 30 minutes in [Dispatch-spawned sessions](#sessions-from-dispatch). The prompt also shows what level of control Claude gets for that app. These tiers are fixed by app category and can’t be changed:
| Tier | What Claude can do | Applies to |
|:-------------|:---------------------------------------------------------|:----------------------------|
| View only | See the app in screenshots | Browsers, trading platforms |
| Click only | Click and scroll, but not type or use keyboard shortcuts | Terminals, IDEs |
| Full control | Click, type, drag, and use keyboard shortcuts | Everything else |
Apps with broad reach, like terminals, Finder or File Explorer, and System Settings or Settings, show an extra warning in the prompt so you know what approving them grants. You can configure two settings in **Settings \> General** (under **Desktop app**):
- **Denied apps**: add apps here to reject them without prompting. Claude may still affect a denied app indirectly through actions in an allowed app, but it can’t interact with the denied app directly.
- **Unhide apps when Claude finishes**: while Claude is working, your other windows are hidden so it interacts with only the approved app. When Claude finishes, hidden windows are restored unless you turn this setting off.
Manage sessions
Each session is an independent conversation with its own context and changes. You can run multiple sessions in parallel, branch off side chats, send work to the cloud, or let Dispatch start sessions for you from your phone.
Work in parallel with sessions
Click **+ New session** in the sidebar, or press **Cmd+N** on macOS or **Ctrl+N** on Windows, to work on multiple tasks in parallel. Press **Ctrl+Tab** and **Ctrl+Shift+Tab** to cycle through sessions in the sidebar. For Git repositories, each session gets its own isolated copy of your project using [Git worktrees](/docs/en/worktrees), so changes in one session don’t affect other sessions until you commit them. To view two sessions at once, hold **Cmd** on macOS or **Ctrl** on Windows and click a session in the sidebar. The session opens in a second pane alongside the one you already have open. While the split is active, clicking another sidebar session replaces whichever pane has focus. Press **Cmd+\\** on macOS or **Ctrl+\\** on Windows to close the focused pane and return to a single session. Worktrees are stored in `<project-root>/.claude/worktrees/` by default. You can change this to a custom directory in Settings → Claude Code under “Worktree location”. You can also set a branch prefix that gets prepended to every worktree branch name, which is useful for keeping Claude-created branches organized. To remove a worktree when you’re done, hover over the session in the sidebar and click the archive icon. To have sessions archive themselves when their pull request merges or closes, turn on **Auto-archive after PR merge or close** in Settings → Claude Code. Auto-archive only applies to local sessions that have finished running. To include gitignored files like `.env` in new worktrees, create a [`.worktreeinclude` file](/docs/en/worktrees#copy-gitignored-files-into-worktrees) in your project root.
Session isolation requires [Git](https://git-scm.com/downloads). Most Macs include Git by default. Run `git --version` in Terminal to check. On Windows, Git is required for the Code tab to work: [download Git for Windows](https://git-scm.com/downloads/win), install it, and restart the app. If you run into Git errors, ask Claude in the [Cowork tab](https://claude.com/product/cowork) to help troubleshoot your setup.
Use the controls at the top of the sidebar to filter sessions by status, project, or environment, and to group sessions by project. To rename a session, click the session title in the toolbar at the top of the active session. To check context usage, see [Check usage](#check-usage). When context fills up, Claude automatically summarizes the conversation and continues working. You can also type `/compact` to trigger summarization earlier and free up context space. See [the context window](/docs/en/how-claude-code-works#the-context-window) for details on how compaction works. The desktop app sends an OS notification when a Code session finishes a task and you aren’t currently viewing that session.
Ask a side question without derailing the session
A side chat lets you ask Claude a question that uses your session’s context but doesn’t add anything back to the main conversation. Use it when you want to understand a piece of code, check an assumption, or explore an idea without steering the session off course. Press **Cmd+;** on macOS or **Ctrl+;** on Windows to open a side chat, or type `/btw` in the prompt box. The side chat can read everything in the main thread up to that point. When you’re done, close the side chat and continue the main session where you left off. Side chats are available in local and SSH sessions.
Watch background tasks
The tasks pane shows the background work running inside the current session: subagents, background shell commands, and workflows. Open it from the **Views** menu or drag it into your layout. Click any entry to see its output in the subagent pane or stop it. To see what other sessions are doing, use the [sidebar](#work-in-parallel-with-sessions).
Run long-running tasks remotely
For large refactors, test suites, migrations, or other long-running tasks, select **Remote** instead of **Local** when starting a session. Remote sessions run on Anthropic’s cloud infrastructure and continue even if you close the app or shut down your computer. Check back anytime to see progress or steer Claude in a different direction. You can also monitor remote sessions from [claude.ai/code](https://claude.ai/code) or the Claude iOS app. Remote sessions also support multiple repositories. After selecting a cloud environment, click the **+** button next to the repo pill to add additional repositories to the session. Each repo gets its own branch selector. This is useful for tasks that span multiple codebases, such as updating a shared library and its consumers. See [Claude Code on the web](/docs/en/claude-code-on-the-web) for more on how remote sessions work.
Continue in another surface
The **Continue in** menu, accessible from the VS Code icon in the bottom right of the session toolbar, lets you move your session to another surface:
- **Claude Code on the Web**: sends your local session to continue running remotely. Desktop pushes your branch, generates a summary of the conversation, and creates a new remote session with the full context. You can then choose to archive the local session or keep it. This requires a clean working tree, and is not available for SSH sessions.
- **Your IDE**: opens your project in a supported IDE at the current working directory.
Sessions from Dispatch
[Dispatch](https://support.claude.com/en/articles/13947068) is a persistent conversation with Claude that lives in the [Cowork](https://claude.com/product/cowork#dispatch-and-computer-use) tab. You message Dispatch a task, and it decides how to handle it. A task can end up as a Code session in two ways: you ask for one directly, such as “open a Claude Code session and fix the login bug”, or Dispatch decides the task is development work and spawns one on its own. Tasks that typically route to Code include fixing bugs, updating dependencies, running tests, or opening pull requests. Research, document editing, and spreadsheet work stay in Cowork. Either way, the Code session appears in the Code tab’s sidebar with a **Dispatch** badge. You get a push notification on your phone when it finishes or needs your approval. If you have [computer use](#let-claude-use-your-computer) enabled, Dispatch-spawned Code sessions can use it too. App approvals in those sessions expire after 30 minutes and re-prompt, rather than lasting the full session like regular Code sessions. For setup, pairing, and Dispatch settings, see the [Dispatch help article](https://support.claude.com/en/articles/13947068). Dispatch requires a Pro or Max plan and is not available on Team or Enterprise plans. Dispatch is one of several ways to work with Claude when you’re away from your terminal. See [Platforms and integrations](/docs/en/platforms#work-when-you-are-away-from-your-terminal) to compare it with Remote Control, Channels, Slack, and scheduled tasks.
Extend Claude Code
Connect external services, add reusable workflows, customize Claude’s behavior, and configure preview servers. To manage connectors, skills, and plugins in one place, click **Customize** in the sidebar.
Connect external tools
For local and [SSH](#ssh-sessions) sessions, click the **+** button next to the prompt box and select **Connectors** to add integrations like Google Calendar, Slack, GitHub, Linear, Notion, and more. You can add connectors before or during a session. The **+** button is not available in remote sessions, but [routines](/docs/en/routines) configure connectors at routine creation time. To manage or disconnect connectors, go to Settings → Connectors in the desktop app, or select **Manage connectors** from the Connectors menu in the prompt box. Once connected, Claude can read your calendar, send messages, create issues, and interact with your tools directly. You can ask Claude what connectors are configured in your session. Connectors are [MCP servers](/docs/en/mcp) with a graphical setup flow. Use them for quick integration with supported services. For integrations not listed in Connectors, add MCP servers manually via [settings files](/docs/en/mcp#installing-mcp-servers). You can also [create custom connectors](../14-Connectors/getting-started-with-custom-connectors-using-remote-mcp.md).
Use skills
[Skills](/docs/en/skills) extend what Claude can do. Claude loads them automatically when relevant, or you can invoke one directly: type `/` in the prompt box or click the **+** button and select **Slash commands** to browse what’s available. This includes [built-in commands](/docs/en/commands), your [custom skills](/docs/en/skills#create-your-first-skill), project skills from your codebase, and skills from any [installed plugins](/docs/en/plugins). Select one and it appears highlighted in the input field. Type your task after it and send as usual.
Install plugins
[Plugins](/docs/en/plugins) are reusable packages that add skills, agents, hooks, MCP servers, and LSP configurations to Claude Code. You can install plugins from the desktop app without using the terminal. For local and [SSH](#ssh-sessions) sessions, click the **+** button next to the prompt box and select **Plugins** to see your installed plugins and their skills. To add a plugin, select **Add plugin** from the submenu to open the plugin browser, which shows available plugins from your configured [marketplaces](/docs/en/plugin-marketplaces) including the official Anthropic marketplace. Select **Manage plugins** to enable, disable, or uninstall plugins. Plugins can be scoped to your user account, a specific project, or local-only. If your organization manages plugins centrally, those plugins are available in desktop sessions the same way they are in the CLI. Plugins are not available for remote sessions. For the full plugin reference including creating your own plugins, see [plugins](/docs/en/plugins).
Configure preview servers
Claude automatically detects your dev server setup and stores the configuration in `.claude/launch.json` at the root of the folder you selected when starting the session. Preview uses this folder as its working directory, so if you selected a parent folder, subfolders with their own dev servers won’t be detected automatically. To work with a subfolder’s server, either start a session in that folder directly or add a configuration manually. To customize how your server starts, for example to use `yarn dev` instead of `npm run dev` or to change the port, edit the file manually or click **Edit configuration** in the Preview dropdown to open it in your code editor. The file supports JSON with comments.
```python
{
"version": "0.0.1",
"configurations": [
{
"name": "my-app",
"runtimeExecutable": "npm",
"runtimeArgs": ["run", "dev"],
"port": 3000
}
]
}
```
You can define multiple configurations to run different servers from the same project, such as a frontend and an API. See the [examples](#examples) below.
Auto-verify changes
When `autoVerify` is enabled, Claude automatically verifies code changes after editing files. It takes screenshots, checks for errors, and confirms changes work before completing its response. Auto-verify is on by default. Disable it per-project by adding `"autoVerify": false` to `.claude/launch.json`, or toggle it from the **Preview** dropdown menu.
```python
{
"version": "0.0.1",
"autoVerify": false,
"configurations": [...]
}
```
When disabled, preview tools are still available and you can ask Claude to verify at any time. Auto-verify makes it automatic after every edit.
Configuration fields
Each entry in the `configurations` array accepts the following fields:
| Field | Type | Description |
|---------------------|------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `name` | string | A unique identifier for this server |
| `runtimeExecutable` | string | The command to run, such as `npm`, `yarn`, or `node` |
| `runtimeArgs` | string\[\] | Arguments passed to `runtimeExecutable`, such as `["run", "dev"]` |
| `port` | number | The port your server listens on. Defaults to 3000 |
| `cwd` | string | Working directory relative to your project root. Defaults to the project root. Use `${workspaceFolder}` to reference the project root explicitly |
| `env` | object | Additional environment variables as key-value pairs, such as `{ "NODE_ENV": "development" }`. Don’t put secrets here since this file is committed to your repo. To pass secrets to your dev server, set them in the [local environment editor](#local-sessions) instead. |
| `autoPort` | boolean | How to handle port conflicts. See below |
| `program` | string | A script to run with `node`. See [when to use `program` vs `runtimeExecutable`](#when-to-use-program-vs-runtimeexecutable) |
| `args` | string\[\] | Arguments passed to `program`. Only used when `program` is set |
##### When to use `program` vs `runtimeExecutable`
Use `runtimeExecutable` with `runtimeArgs` to start a dev server through a package manager. For example, `"runtimeExecutable": "npm"` with `"runtimeArgs": ["run", "dev"]` runs `npm run dev`. Use `program` when you have a standalone script you want to run with `node` directly. For example, `"program": "server.js"` runs `node server.js`. Pass additional flags with `args`.
Port conflicts
The `autoPort` field controls what happens when your preferred port is already in use:
- **`true`**: Claude finds and uses a free port automatically. Suitable for most dev servers.
- **`false`**: Claude fails with an error. Use this when your server must use a specific port, such as for OAuth callbacks or CORS allowlists.
- **Not set (default)**: Claude asks whether the server needs that exact port, then saves your answer.
When Claude picks a different port, it passes the assigned port to your server via the `PORT` environment variable.
Examples
These configurations show common setups for different project types:
- Next.js
- Multiple servers
- Node.js script
This configuration runs a Next.js app using Yarn on port 3000:
```python
{
"version": "0.0.1",
"configurations": [
{
"name": "web",
"runtimeExecutable": "yarn",
"runtimeArgs": ["dev"],
"port": 3000
}
]
}
```
For a monorepo with a frontend and an API server, define multiple configurations. The frontend uses `autoPort: true` so it picks a free port if 3000 is taken, while the API server requires port 8080 exactly:
```python
{
"version": "0.0.1",
"configurations": [
{
"name": "frontend",
"runtimeExecutable": "npm",
"runtimeArgs": ["run", "dev"],
"cwd": "apps/web",
"port": 3000,
"autoPort": true
},
{
"name": "api",
"runtimeExecutable": "npm",
"runtimeArgs": ["run", "start"],
"cwd": "server",
"port": 8080,
"env": { "NODE_ENV": "development" },
"autoPort": false
}
]
}
```
To run a Node.js script directly instead of using a package manager command, use the `program` field:
```python
{
"version": "0.0.1",
"configurations": [
{
"name": "server",
"program": "server.js",
"args": ["--verbose"],
"port": 4000
}
]
}
```
Environment configuration
The environment you pick when [starting a session](#start-a-session) determines where Claude executes and how you connect:
- **Local**: runs on your machine with direct access to your files
- **Remote**: runs on Anthropic’s cloud infrastructure. Sessions continue even if you close the app.
- **SSH**: runs on a remote machine you connect to over SSH, such as your own servers, cloud VMs, or dev containers
Local sessions
The desktop app does not always inherit your full shell environment. On macOS, when you launch the app from the Dock or Finder, it reads your shell profile, such as `~/.zshrc` or `~/.bashrc`, to extract `PATH` and a fixed set of Claude Code variables, but other variables you export there are not picked up. On Windows, the app inherits user and system environment variables but does not read PowerShell profiles. To set environment variables for local sessions and dev servers on any platform, open the environment dropdown in the prompt box, hover over **Local**, and click the gear icon to open the local environment editor. Variables you save here are stored encrypted on your machine and apply to every local session and preview server you start. You can also add variables to the `env` key in your `~/.claude/settings.json` file, though these reach Claude sessions only and not dev servers. See [environment variables](/docs/en/env-vars) for the full list of supported variables. [Extended thinking](/docs/en/model-config#extended-thinking) is enabled by default, which improves performance on complex reasoning tasks but uses additional tokens. To disable thinking entirely, set `MAX_THINKING_TOKENS` to `0` in the local environment editor. On models with [adaptive reasoning](/docs/en/model-config#adjust-effort-level), any other `MAX_THINKING_TOKENS` value is ignored because adaptive reasoning controls thinking depth instead. On Opus 4.6 and Sonnet 4.6, set `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` to `1` to use a fixed thinking budget; Opus 4.7 always uses adaptive reasoning and has no fixed-budget mode.
Remote sessions
Remote sessions continue in the background even if you close the app. Usage counts toward your [subscription plan limits](/docs/en/costs) with no separate compute charges. You can create custom cloud environments with different network access levels and environment variables. Select the environment dropdown when starting a remote session and choose **Add environment**. See [the cloud environment](/docs/en/claude-code-on-the-web#the-cloud-environment) for details on configuring network access and environment variables.
SSH sessions
SSH sessions let you run Claude Code on a remote machine while using the desktop app as your interface. This is useful for working with codebases that live on cloud VMs, dev containers, or servers with specific hardware or dependencies. To add an SSH connection, click the environment dropdown before starting a session and select **+ Add SSH connection**. The dialog asks for:
- **Name**: a friendly label for this connection
- **SSH Host**: `user@hostname` or a host defined in `~/.ssh/config`
- **SSH Port**: defaults to 22 if left empty, or uses the port from your SSH config
- **Identity File**: path to your private key, such as `~/.ssh/id_rsa`. Leave empty to use the default key or your SSH config.
Once added, the connection appears in the environment dropdown. Select it to start a session on that machine. Claude runs on the remote machine with access to its files and tools. The remote machine must run Linux or macOS. Desktop installs Claude Code on the remote machine automatically the first time you connect. Once connected, SSH sessions support permission modes, connectors, plugins, and MCP servers.
Pre-configure SSH connections for your team
Administrators can distribute SSH connections to team members by adding `sshConfigs` to a [managed settings](/docs/en/settings#settings-precedence) file. Connections defined this way appear in each user’s environment dropdown automatically and are shown as managed, so users can select them but cannot edit or delete them in the app. The following example pre-configures a single connection that opens in `~/projects` on the remote host:
```python
{
"sshConfigs": [
{
"id": "shared-dev-vm",
"name": "Shared Dev VM",
"sshHost": "user@dev.example.com",
"sshPort": 22,
"sshIdentityFile": "~/.ssh/id_ed25519",
"startDirectory": "~/projects"
}
]
}
```
Each entry requires `id`, `name`, and `sshHost`. The `sshPort`, `sshIdentityFile`, and `startDirectory` fields are optional. Users can also add `sshConfigs` to their own `~/.claude/settings.json`, which is where connections added through the dialog are stored.
Restrict which SSH hosts users can connect to
Administrators can limit Desktop’s SSH sessions to an approved set of hosts by adding `sshHostAllowlist` to a [managed settings](/docs/en/settings#settings-precedence) file. When set, users can only connect to hosts whose resolved hostname matches one of the patterns. Set it to an empty array to disable SSH sessions entirely. The following example allows connections to any host under `devboxes.example.com` and to a single named bastion host:
```python
{
"sshHostAllowlist": ["*.devboxes.example.com", "bastion.example.com"]
}
```
Patterns are case-insensitive. `*` matches any host, and `*.example.com` matches `example.com` and any subdomain. Anything else is an exact match. The check runs against the hostname after `~/.ssh/config` resolution via `ssh -G`, so `Host` aliases and `ProxyCommand`/`ProxyJump` entries are permitted as long as the resolved `HostName` matches. `sshHostAllowlist` is read from managed settings only; values in user or project settings are ignored. Only the Claude Desktop app honors this setting; the Claude Code CLI and IDE extensions do not read it, and it does not restrict `ssh` commands run through the Bash tool. It governs which hosts the Desktop app connects to, not network egress, so pair it with your organization’s network or zero-trust controls if you need a hard boundary.
Enterprise configuration
Organizations on Team or Enterprise plans can manage desktop app behavior through admin console controls, managed settings files, and device management policies.
Admin console controls
These settings are configured through the [admin settings console](https://claude.ai/admin-settings/claude-code):
- **Code in the desktop**: control whether users in your organization can access Claude Code in the desktop app
- **Code in the web**: enable or disable [web sessions](/docs/en/claude-code-on-the-web) for your organization
- **Remote Control**: enable or disable [Remote Control](/docs/en/remote-control) for your organization
- **Disable Bypass permissions mode**: prevent users in your organization from enabling bypass permissions mode
Managed settings
Managed settings override project and user settings and apply when Desktop spawns CLI sessions. You can set these keys in your organization’s [managed settings](/docs/en/settings#settings-precedence) file or push them remotely through the admin console.
| Key | Description |
|--------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `permissions.disableBypassPermissionsMode` | set to `"disable"` to prevent users from enabling Bypass permissions mode. |
| `disableAutoMode` | set to `"disable"` to prevent users from enabling [Auto](/docs/en/permission-modes#eliminate-prompts-with-auto-mode) mode. Removes Auto from the mode selector. Also accepted under `permissions`. |
| `autoMode` | customize what the auto mode classifier trusts and blocks across your organization. See [Configure auto mode](/docs/en/auto-mode-config). |
| `sshConfigs` | pre-configure [SSH connections](#pre-configure-ssh-connections-for-your-team) that appear in the environment dropdown. Users cannot edit or delete managed connections. |
| `sshHostAllowlist` | restrict [SSH sessions](#restrict-which-ssh-hosts-users-can-connect-to) to hosts whose resolved hostname matches one of these patterns. An empty array disables SSH sessions. Read from managed settings only. |
| `managedMcpServers` | push MCP server configurations to all users in a third-party deployment. Each entry specifies a transport of `"http"`, `"sse"`, or `"stdio"`, connection details, and optionally a `toolPolicy` map that restricts which tools in that server users can invoke. Available in third-party (3P) Desktop deployments only. |
A managed settings file deployed to disk on each machine applies to Desktop sessions. Managed settings pushed remotely through the admin console currently reach CLI and IDE sessions only, so for Desktop deployments either distribute the file via MDM or use the [admin console controls](#admin-console-controls) above. `permissions.disableBypassPermissionsMode` and `disableAutoMode` also work in user and project settings, but placing them in managed settings prevents users from overriding them. `autoMode` is read from user settings, `.claude/settings.local.json`, and managed settings, but not from the checked-in `.claude/settings.json`: a cloned repo cannot inject its own classifier rules. For the complete list of managed-only settings including `allowManagedPermissionRulesOnly` and `allowManagedHooksOnly`, see [managed-only settings](/docs/en/permissions#managed-only-settings).
Device management policies
IT teams can manage the desktop app through MDM on macOS or group policy on Windows. Available policies include enabling or disabling the Claude Code feature, controlling auto-updates, and setting a custom deployment URL.
- **macOS**: configure via `com.anthropic.Claude` preference domain using tools like Jamf or Kandji
- **Windows**: configure via registry at `SOFTWARE\Policies\Claude`
Authentication and SSO
Enterprise organizations can require SSO for all users. See [authentication](/docs/en/authentication) for plan-level details and [Setting up SSO](../21-Account-Support/setting-up-single-sign-on-sso.md) for SAML and OIDC configuration.
Data handling
Claude Code processes your code locally in local sessions or on Anthropic’s cloud infrastructure in remote sessions. Conversations and code context are sent to Anthropic’s API for processing. See [data handling](/docs/en/data-usage) for details on data retention, privacy, and compliance.
Deployment
Desktop can be distributed through enterprise deployment tools:
- **macOS**: distribute via MDM such as Jamf or Kandji using the `.dmg` installer
- **Windows**: deploy via MSIX package or `.exe` installer. See [Deploy Claude Desktop for Windows](https://support.claude.com/en/articles/12622703-deploy-claude-desktop-for-windows) for enterprise deployment options including silent installation
For network configuration such as proxy settings, firewall allowlisting, and LLM gateways, see [network configuration](/docs/en/network-config). For the full enterprise configuration reference, see the [enterprise configuration guide](../13-Enterprise-Admin/enterprise-configuration.md).
Coming from the CLI?
If you already use the Claude Code CLI, Desktop runs the same underlying engine with a graphical interface. You can run both simultaneously on the same machine, even on the same project. Each maintains separate session history, but they share configuration and project memory via CLAUDE.md files. To move a CLI session into Desktop, run `/desktop` in the terminal. Claude saves your session and opens it in the desktop app, then exits the CLI. This command is available on macOS and Windows only.
When to use Desktop vs CLI: use Desktop when you want to manage parallel sessions in one window, arrange panes side by side, or review changes visually. Use the CLI when you need scripting, automation, or prefer a terminal workflow.
CLI flag equivalents
This table shows the desktop app equivalent for common CLI flags. Flags not listed have no desktop equivalent because they are designed for scripting or automation.
| CLI | Desktop equivalent |
|---------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------|
| `--model sonnet` | Model dropdown next to the send button |
| `--resume`, `--continue` | Click a session in the sidebar |
| `--permission-mode` | Mode selector next to the send button |
| `--dangerously-skip-permissions` | Bypass permissions mode. Enable in Settings → Claude Code → “Allow bypass permissions mode”. Enterprise admins can disable this setting. |
| `--add-dir` | Add multiple repos with the **+** button in remote sessions |
| `--allowedTools`, `--disallowedTools` | No per-session equivalent. Permission rules in [settings files](/docs/en/settings) still apply. |
| `--verbose` | [Verbose view mode](#switch-view-modes) in the Transcript view dropdown |
| `--print`, `--output-format` | Not available. Desktop is interactive only. |
| `ANTHROPIC_MODEL` env var | Model dropdown next to the send button |
| `MAX_THINKING_TOKENS` env var | Set in the local environment editor. See [environment configuration](#environment-configuration). |
Shared configuration
Desktop and CLI read the same configuration files, so your setup carries over:
- **[CLAUDE.md](/docs/en/memory)** and `CLAUDE.local.md` files in your project are used by both
- **[MCP servers](/docs/en/mcp)** configured in `~/.claude.json` or `.mcp.json` work in both
- **[Hooks](/docs/en/hooks)** and **[skills](/docs/en/skills)** defined in settings apply to both
- **[Settings](/docs/en/settings)** in `~/.claude.json` and `~/.claude/settings.json` are shared. Permission rules, allowed tools, and other settings in `settings.json` apply to Desktop sessions.
- **Models**: Sonnet, Opus, and Haiku are available in both. In Desktop, select the model from the dropdown next to the send button. You can change the model mid-session from the same dropdown.
**MCP servers: desktop chat app vs Claude Code**: MCP servers configured for the Claude Desktop chat app in `claude_desktop_config.json` are separate from Claude Code and will not appear in the Code tab. To use MCP servers in Claude Code, configure them in `~/.claude.json` or your project’s `.mcp.json` file. See [MCP configuration](/docs/en/mcp#installing-mcp-servers) for details.
Feature comparison
This table compares core capabilities between the CLI and Desktop. For a full list of CLI flags, see the [CLI reference](/docs/en/cli-reference).
| Feature | CLI | Desktop |
|------------------------------------------------------------|---------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Permission modes | All modes including `dontAsk` | Ask permissions, Auto accept edits, Plan mode, Auto, and Bypass permissions via Settings |
| `--dangerously-skip-permissions` | CLI flag | Bypass permissions mode. Enable in Settings → Claude Code → “Allow bypass permissions mode” |
| [Third-party providers](/docs/en/third-party-integrations) | Bedrock, Vertex, Foundry | Anthropic’s API by default. Enterprise deployments can configure Vertex AI and gateway providers. See the [enterprise configuration guide](../13-Enterprise-Admin/enterprise-configuration.md). |
| [MCP servers](/docs/en/mcp) | Configure in settings files | Connectors UI for local and SSH sessions, or settings files |
| [Plugins](/docs/en/plugins) | `/plugin` command | Plugin manager UI |
| @mention files | Text-based | With autocomplete; local and SSH sessions only |
| File attachments | Not available | Images, PDFs |
| Session isolation | [`--worktree`](/docs/en/cli-reference) flag | Automatic worktrees |
| Multiple sessions | Separate terminals | Sidebar tabs |
| Recurring tasks | Cron jobs, CI pipelines | [Scheduled tasks](/docs/en/desktop-scheduled-tasks) |
| Computer use | [Enable via `/mcp`](/docs/en/computer-use) on macOS | [App and screen control](#let-claude-use-your-computer) on macOS and Windows |
| Dispatch integration | Not available | [Dispatch sessions](#sessions-from-dispatch) in the sidebar |
| Scripting and automation | [`--print`](/docs/en/cli-reference), [Agent SDK](/docs/en/headless) | Not available |
What’s not available in Desktop
The following features are only available in the CLI or VS Code extension:
- **Third-party providers**: Desktop connects to Anthropic’s API by default. Enterprise deployments can configure Vertex AI and gateway providers via [managed settings](../13-Enterprise-Admin/enterprise-configuration.md). For Bedrock or Foundry, use the [CLI](/docs/en/quickstart).
- **Linux**: the desktop app is available on macOS and Windows only. On Linux, use the [CLI](/docs/en/quickstart).
- **Inline code suggestions**: Desktop does not provide autocomplete-style suggestions. It works through conversational prompts and explicit code changes.
- **Agent teams**: multi-agent orchestration is available via the [CLI](/docs/en/agent-teams) and [Agent SDK](/docs/en/headless), not in Desktop.
- **Terminal-dialog commands**: built-in commands that open an interactive panel in the terminal, such as `/permissions`, `/config`, `/agents`, and `/doctor`, are not available in the Code tab and reply with `isn't available in this environment`. Edit [settings files](/docs/en/settings) directly to manage permission rules and configuration, or run the command from the standalone CLI.
Troubleshooting
The sections below cover issues specific to the desktop app. For runtime API errors that appear in the chat such as `API Error: 500`, `529 Overloaded`, `429`, or `Prompt is too long`, see the [Error reference](/docs/en/errors). Those errors and their fixes are the same across the CLI, desktop, and web.
Check your version
To see which version of the desktop app you’re running:
- **macOS**: click **Claude** in the menu bar, then **About Claude**
- **Windows**: click **Help**, then **About**
Click the version number to copy it to your clipboard.
403 or authentication errors in the Code tab
If you see `Error 403: Forbidden` or other authentication failures when using the Code tab:
1. Sign out and back in from the app menu. This is the most common fix.
2. Verify you have an active paid subscription: Pro, Max, Team, or Enterprise.
3. If the CLI works but Desktop does not, quit the desktop app completely, not just close the window, then reopen and sign in again.
4. Check your internet connection and proxy settings.
Blank or stuck screen on launch
If the app opens but shows a blank or unresponsive screen:
1. Restart the app.
2. Check for pending updates. The app auto-updates on launch.
3. On Windows, check Event Viewer for crash logs under **Windows Logs → Application**.
”Failed to load session”
If you see `Failed to load session`, the selected folder may no longer exist, a Git repository may require Git LFS that isn’t installed, or file permissions may prevent access. Try selecting a different folder or restarting the app.
Session not finding installed tools
If Claude can’t find tools like `npm`, `node`, or other CLI commands, verify the tools work in your regular terminal, check that your shell profile properly sets up PATH, and restart the desktop app to reload environment variables.
Git and Git LFS errors
On Windows, Git is required for the Code tab to start local sessions. If you see “Git is required,” install [Git for Windows](https://git-scm.com/downloads/win) and restart the app. If you see “Git LFS is required by this repository but is not installed,” install Git LFS from [git-lfs.com](https://git-lfs.com/), run `git lfs install`, and restart the app.
MCP servers not working on Windows
If MCP server toggles don’t respond or servers fail to connect on Windows, check that the server is properly configured in your settings, restart the app, verify the server process is running in Task Manager, and review server logs for connection errors.
App won’t quit
- **macOS**: press Cmd+Q. If the app doesn’t respond, use Force Quit with Cmd+Option+Esc, select Claude, and click Force Quit.
- **Windows**: use Task Manager with Ctrl+Shift+Esc to end the Claude process.
Windows-specific issues
- **PATH not updated after install**: open a new terminal window. PATH updates only apply to new terminal sessions.
- **Concurrent installation error**: if you see an error about another installation in progress but there isn’t one, try running the installer as Administrator.
”Branch doesn’t exist yet” when opening in CLI
Remote sessions can create branches that don’t exist on your local machine. Click the branch name in the session toolbar to copy it, then fetch it locally:
```python
git fetch origin <branch-name>
git checkout <branch-name>
```
Still stuck?
- Search or file a bug on [GitHub Issues](https://github.com/anthropics/claude-code/issues)
- Visit the [Claude support center](https://support.claude.com/)
When filing a bug, include your desktop app version, your operating system, the exact error message, and relevant logs. On macOS, check Console.app. On Windows, check Event Viewer → Windows Logs → Application.
---
## desktop-quickstart.md
# Get started with the desktop app
Install Claude Code on desktop and start your first coding session.
The desktop app gives you Claude Code with a graphical interface: visual diff review, live app preview, GitHub PR monitoring with auto-merge, parallel sessions with Git worktree isolation, scheduled tasks, and the ability to run tasks remotely. No terminal required.
## Downloads
- **macOS**: Universal build for Intel and Apple Silicon
- **Windows**: x64 and ARM64 installers
- Linux is not currently supported.
> Claude Code requires a Pro, Max, Team, or Enterprise subscription.
The desktop app has three tabs:
- **Chat**: General conversation with no file access, similar to claude.ai
- **Cowork**: An autonomous background agent that works on tasks in a cloud VM with its own environment
- **Code**: An interactive coding assistant with direct access to your local files
## Install
1. **Install and sign in**: Download Claude for your platform and run the installer. Launch and sign in with your Anthropic account.
2. **Open the Code tab**: Click the Code tab at the top center. If it prompts you to upgrade, you need a paid plan.
The desktop app includes Claude Code. You don't need to install Node.js or the CLI separately. To use `claude` from the terminal, install the CLI separately.
## Start your first session
1. **Choose an environment and folder**: Select **Local** to run Claude on your machine. Click **Select folder** and choose your project directory. You can also select **Remote** (Anthropic cloud) or **SSH** (remote machine).
2. **Choose a model**: Select from the dropdown next to the send button. You cannot change the model after the session starts.
3. **Tell Claude what to do**:
- `Find a TODO comment and fix it`
- `Add tests for the main function`
- `Create a CLAUDE.md with instructions for this codebase`
4. **Review and accept changes**: By default, Claude proposes changes and waits for your approval before applying them. You'll see diff views showing exactly what will change, with Accept/Reject buttons.
## Now what?
- **Interrupt and steer**: Click the stop button or type your correction at any point
- **Give Claude more context**: Type `@filename` to pull a specific file, attach images and PDFs, or drag and drop files
- **Use skills**: Type `/` or click **+** → **Slash commands** to browse commands and skills
- **Review changes**: Click `+12 -1` indicators to open the diff view. Click **Review code** to have Claude evaluate diffs
- **Adjust permissions**: Ask permissions (default) requires approval before every edit. Auto accept edits auto-accepts file edits. Plan mode lets Claude map out an approach without touching files
- **Add plugins**: Click **+** → **Plugins** to browse and install plugins
- **Preview your app**: Click **Preview** to run your dev server in the desktop
- **Track pull requests**: After opening a PR, Claude monitors CI and can auto-fix failures or merge
- **Schedule tasks**: Set up scheduled tasks for recurring work (daily code review, dependency audit)
- **Scale up**: Open parallel sessions, send work to the cloud, or continue in another surface
## Coming from the CLI?
Desktop runs the same engine as the CLI with a graphical interface. You can run both simultaneously on the same project, and they share configuration (CLAUDE.md files, MCP servers, hooks, skills, and settings).
## See Also
- [Use Claude Code Desktop](desktop.md)
- [Troubleshooting](/en/desktop#troubleshooting)
- [Best practices](../10-Prompting-Guides/best-practices-for-claude-code-claude-code-docs-9686dc1633.md)
- [Common workflows](../02-Claude-Code-CLI/common-workflows-c909406123.md)
---
## desktop-scheduled-tasks.md
# Schedule recurring tasks in Claude Code Desktop
Set up scheduled tasks in Claude Code Desktop to run Claude automatically on a recurring basis for daily code reviews, dependency audits, or morning briefings.
By default, scheduled tasks start a new session automatically at a time and frequency you choose.
## Compare scheduling options
| | Cloud | Desktop | `/loop` |
| :------------------------- | :----------------- | :----------------- | :----------------- |
| Runs on | Anthropic cloud | Your machine | Your machine |
| Requires machine on | No | Yes | Yes |
| Requires open session | No | No | Yes |
| Persistent across restarts | Yes | Yes | No |
| Access to local files | No (fresh clone) | Yes | Yes |
| Minimum interval | 1 hour | 1 minute | 1 minute |
The Schedule page supports two kinds of tasks:
- **Local tasks**: run on your machine with direct access to local files and tools. Desktop app must be open and computer awake.
- **Remote tasks**: run on Anthropic-managed cloud infrastructure. Keep running even when your computer is off.
## Create a scheduled task
Click **Schedule** in the sidebar, click **New task**, and choose **New local task**. Configure:
| Field | Description |
| ----------- | --------------------------------------------------------- |
| Name | Identifier for the task (lowercase kebab-case) |
| Description | Short summary shown in the task list |
| Prompt | Instructions sent to Claude when the task runs |
| Frequency | How often the task runs |
## Frequency options
- **Manual**: no schedule, only runs when you click **Run now**
- **Hourly**: runs every hour with a fixed offset of up to 10 minutes
- **Daily**: shows a time picker, defaults to 9:00 AM local
- **Weekdays**: same as Daily but skips Saturday and Sunday
- **Weekly**: shows a time and day picker
For custom intervals, ask Claude in any Desktop session.
## How scheduled tasks run
Desktop checks the schedule every minute while the app is open and starts a fresh session when a task is due. Each task gets a fixed delay of up to 10 minutes for staggering.
When a task fires:
- Desktop notification appears
- New session under **Scheduled** section in sidebar
- Claude can edit files, run commands, create commits, open PRs
Tasks only run while the desktop app is running and your computer is awake. Enable **Keep computer awake** in Settings to prevent idle-sleep.
## Missed runs
When the app starts or your computer wakes, Desktop checks whether each task missed any runs in the last seven days. If it did, exactly one catch-up run starts for the most recently missed time.
## Permissions for scheduled tasks
Each task has its own permission mode. Allow rules from `~/.claude/settings.json` also apply.
To avoid stalls, click **Run now** after creating a task, watch for permission prompts, and select "always allow" for each one.
## Manage scheduled tasks
From a task's detail page:
- **Run now**: start immediately
- **Toggle repeats**: pause/resume scheduled runs
- **Edit**: change prompt, frequency, folder, or settings
- **Review history**: see past runs
- **Review allowed permissions**: see and revoke tool approvals
- **Delete**: remove the task
Task prompts on disk: `~/.claude/scheduled-tasks/<task-name>/SKILL.md`
## See Also
- [Cloud scheduled tasks](../02-Claude-Code-CLI/web-scheduled-tasks.md)
- [Run prompts on a schedule](../02-Claude-Code-CLI/run-prompts-on-a-schedule-claude-code-docs.md) — session-scoped `/loop`
- [Claude Code GitHub Actions](../02-Claude-Code-CLI/claude-code-github-actions-claude-code-docs-0d633fbd8a.md)
- [Use Claude Code Desktop](desktop.md)
---
## desktop.md
# Use Claude Code Desktop
Get more out of Claude Code Desktop: computer use, Dispatch sessions from your phone, parallel sessions with Git isolation, visual diff review, app previews, PR monitoring, connectors, and enterprise configuration.
The Code tab within the Claude Desktop app lets you use Claude Code through a graphical interface instead of the terminal.
## Key capabilities
- **Visual diff review** with inline comments
- **Live app preview** with dev servers
- **Computer use** to open apps and control your screen on macOS and Windows
- **GitHub PR monitoring** with auto-fix and auto-merge
- **Parallel sessions** with automatic Git worktree isolation
- **Dispatch** integration: send a task from your phone, get a session here
- **Scheduled tasks** that run Claude on a recurring schedule
- **Connectors** for GitHub, Slack, Linear, and more
- Local, SSH, and cloud environments
## Start a session
Configure four things in the prompt area before sending your first message:
1. **Environment**: Local, Remote, or SSH
2. **Folder**: the project directory Claude will work in
3. **Model**: Opus, Sonnet, or Haiku (cannot change after session starts)
4. **Permission mode**: controls what Claude can do without asking
## Work with code
### Add files and context to prompts
- Type `@filename` to pull a specific file into conversation
- Attach images and PDFs using the attachment button
- Drag and drop files into the prompt
### Review changes with diff view
After Claude edits files, a `+12 -1` indicator appears. Click it to open the diff view:
- Review modifications file by file
- Comment on specific lines (Claude reads comments and revises)
- Click **Review code** for Claude to self-evaluate diffs
### Choose a permission mode
| Mode | What it does |
| :--------------- | :---------------------------------------- |
| Ask permissions | Default. Claude asks before every edit |
| Auto accept | Auto-accepts file edits |
| Plan mode | Claude plans without editing |
| Auto mode | Everything runs with safety checks |
| Bypass | No permission prompts (containers only) |
### Preview your app
Click **Preview** dropdown to run your dev server in the desktop. Claude can view the running app, test endpoints, inspect logs, and iterate.
## Let Claude use your computer
Computer use is available on macOS and Windows (Pro and Max plans). Enable in **Settings > General** under Desktop app.
Claude can open apps, click, type, and see your screen. Each app requires per-session approval.
## Monitor pull request status
After opening a PR, Claude monitors CI check results. You can enable:
- **Auto-fix**: Claude automatically fixes CI failures
- **Auto-merge**: Claude merges the PR once all checks pass
## Manage sessions
### Work in parallel with sessions
Open parallel sessions from the sidebar. Each session can use its own Git worktree for isolation.
### Run long-running tasks remotely
Send work to Anthropic's cloud so it continues even if you close the app. Remote sessions work against a fresh clone of your repository.
### Continue in another surface
Transfer a session to the web, CLI, or mobile app to continue working elsewhere.
## Extend Claude Code
### Install plugins
Click **+** → **Plugins** to browse and install plugins that add skills, agents, MCP servers, and more.
### Connect external tools
Use connectors for GitHub, Slack, Linear, and more. Available in **Settings > Connectors**.
### Sessions from Dispatch
Pair the Claude mobile app with Desktop. When you message a task from your phone, Desktop spawns a session to handle it.
## SSH sessions
Connect to remote machines over SSH. Claude Code must be installed on the remote machine.
## Environment configuration
### Enterprise settings
Admins can configure:
- Allowed models and permission modes
- MCP server allowlists
- Network and proxy settings
- Feature flags
## Coming from the CLI
Desktop runs the same engine as the CLI with a graphical interface. They share configuration (CLAUDE.md, MCP servers, hooks, skills, settings).
Key differences:
- Desktop adds diff viewer, app preview, computer use (Windows), Dispatch
- CLI has Agent SDK, third-party providers, headless mode
- Both can run simultaneously on the same project
## Troubleshooting
### 403 or authentication errors
Sign out and sign back in. Check your subscription is active.
### Code tab not appearing
Ensure you have a Pro, Max, Team, or Enterprise subscription.
### Session hangs or stops responding
Try creating a new session. If persistent, restart the desktop app.
## See Also
- [Get started with Desktop](desktop-quickstart.md)
- [Desktop scheduled tasks](desktop-scheduled-tasks.md)
- [Permission modes](../02-Claude-Code-CLI/permission-modes.md)
- [Best practices](../10-Prompting-Guides/best-practices-for-claude-code-claude-code-docs-9686dc1633.md)
---
## enabling-and-using-the-desktop-extension-allowlist-5546681ce4.md
# Enabling and using the desktop extension allowlist
March 16, 2026
Copy for LLM
The desktop extension allowlist is available for Owners and Primary Owners of Team and Enterprise plans.
This article introduces a desktop extension allowlist that Team and Enterprise plan Owners can use to manage their organization’s access to extensions.
## How to enable the allowlist
**Important:** If you’ve previously configured Enterprise policy controls at the user-machine level, these will override the in-app allowlist. Ensure both `isDesktopExtensionDirectoryEnabled` and `isDesktopExtensionEnabled` are not set to "false" so the allowlist can populate the available registry. Refer to our **[desktop enterprise configuration documentation](https://support.claude.com/en/articles/12622667-enterprise-configuration)** for more information.
The desktop extension allowlist is disabled by default, so an organization Owner will need to switch it on manually. Note that **users will be able to access all desktop extensions in the registry until you enable the allowlist.** To prevent this, ensure you activate the allowlist to block all desktop extensions by default, then add only the extensions your team needs access to.
**To turn on the allowlist:**
1. Open Claude Desktop
2. Click your initials or name in the lower left corner
3. Navigate to Organization settings \> Connectors
4. Switch to the "Desktop" tab:
5. Toggle **Allowlist** on:
## What happens after enabling the allowlist?
Once the allowlist is enabled:
- Any existing desktop extension installations will be force-deleted from Claude Desktop clients.
- Users will no longer be able to install new desktop extensions that are not included within the allowlist.
- Users can only download extensions from the sanctioned in-app registry; they can no longer drag or click to install MCPBs.
Note that the allowlist does not guard against individuals tampering with local MCP file contents after installation.
Consider completing the allowlist setup during off-hours to minimize disruption to existing users. If a user's installed extension is deleted while the allowlist is being configured, they will need to manually re-install the extension.
**Important:** The allowlist requires Claude Desktop version 0.13.91 or higher, so users should update the desktop app by clicking “Claude”, then either “Check for updates” or “Restart to update to Claude 0.13.91”:
## Managing allowed extensions
After enabling the allowlist, you can choose which extensions to allow:
1. Navigate to Organization settings \> Connectors and select the “Desktop” tab.
2. Click “Browse extensions” to view the list of available extensions.
3. Select the extension you want to add.
4. Click the “Add to your team” button.
5. The extension will appear in your allowlist.
If you want to remove an extension from the allowlist, click the “...” button and “Remove from allowlist.”
## Uploading custom extensions
You can also upload custom extensions to deploy across your organization via Organization settings \> Connectors \> Desktop.
**Note:** Ensure the name field in the manifest.json does not overlap with any existing MCPBs. All names for unique MCPBs / desktop extensions must be unique.
1. Click “Add custom extension”
2. This will open a filepicker; select the .mcpb file.
3. The extension will appear under **Custom team extensions**.
4. Click "...” then “Add to team” to add it to your allowlist and enable it for your team.
When you allowlist a custom extension, it's scoped to your specific organization and can't be used across other organizations. For more in-depth information about creating custom extensions with MCP Bundles (.mcpb), please refer to our **[desktop extension developer documentation](https://github.com/anthropics/mcpb)**.
## Updating custom extensions
We’ve also introduced the ability to update previously-installed custom extensions to new versions without having to remove and reinstall them.
You can update a new MCPB version by making changes to manifest.json, ensuring the version field for the update candidate is incremented from the current uploaded version, and that you leave the name value unchanged. Changing the name will create a new custom desktop extension rather than uploading a new version. Then navigate to the custom upload pane, select "Upload new version" via the kebab menu, and upload the new file.
---
## get-started-with-the-desktop-app-claude-code-docs-9959b44e94.md
# Get started with the desktop app
Install Claude Code on desktop and start your first coding session
> ## Documentation Index
>
> Fetch the complete documentation index at: <https://code.claude.com/docs/llms.txt>
>
> Use this file to discover all available pages before exploring further.
The desktop app gives you Claude Code with a graphical interface built for running multiple sessions side by side: a sidebar for managing parallel work, a drag-and-drop layout with an integrated terminal and file editor, visual diff review, live app preview, GitHub PR monitoring with auto-merge, and scheduled tasks. No terminal required.
## Download for macOS
Universal build for Intel and Apple Silicon
## Download for Windows
For x64 processors
For Windows ARM64, download the [ARM64 installer](https://claude.ai/api/desktop/win32/arm64/setup/latest/redirect?utm_source=claude_code&utm_medium=docs). The desktop app is not available on Linux; use the [CLI](/docs/en/quickstart) instead.
Claude Code requires a [Pro, Max, Team, or Enterprise subscription](https://claude.com/pricing?utm_source=claude_code&utm_medium=docs&utm_content=desktop_quickstart_pricing).
This page walks through installing the app and starting your first session. If you’re already set up, see [Use Claude Code Desktop](/docs/en/desktop) for the full reference. The desktop app has three tabs:
- **Chat**: General conversation with no file access, similar to claude.ai.
- **Cowork**: An autonomous background agent that works on tasks in a cloud VM with its own environment. It can run independently while you do other work.
- **Code**: An interactive coding assistant with direct access to your local files. You review and approve each change in real time.
Chat and Cowork are covered in the [Claude Desktop support articles](https://support.claude.com/en/collections/16163169-claude-desktop). This page focuses on the **Code** tab.
Install
1
Install and sign in
Download the installer for your platform from the links above and run it. Launch Claude from your Applications folder on macOS or the Start menu on Windows, then sign in with your Anthropic account.
2
Open the Code tab
Click the **Code** tab at the top center. If clicking Code prompts you to upgrade, you need to [subscribe to a paid plan](https://claude.com/pricing?utm_source=claude_code&utm_medium=docs&utm_content=desktop_quickstart_upgrade) first. If it prompts you to sign in online, complete the sign-in and restart the app. If you see a 403 error, see [authentication troubleshooting](/docs/en/desktop#403-or-authentication-errors-in-the-code-tab).
The desktop app includes Claude Code. You don’t need to install Node.js or the CLI separately. To use `claude` from the terminal, install the CLI separately. See [Get started with the CLI](/docs/en/quickstart).
Start your first session
With the Code tab open, choose a project and give Claude something to do.
1
Choose an environment and folder
Select **Local** to run Claude on your machine using your files directly. Click **Select folder** and choose your project directory.
Start with a small project you know well. It’s the fastest way to see what Claude Code can do. On Windows, [Git](https://git-scm.com/downloads/win) must be installed for local sessions to work. Most Macs include Git by default.
You can also select:
- **Remote**: Run sessions on Anthropic’s cloud infrastructure that continue even if you close the app. Remote sessions use the same infrastructure as [Claude Code on the web](/docs/en/claude-code-on-the-web).
- **SSH**: Connect to a remote machine over SSH, such as your own servers, cloud VMs, or dev containers. Desktop installs Claude Code on the remote machine automatically the first time you connect.
2
Choose a model
Select a model from the dropdown next to the send button. See [models](/docs/en/model-config#available-models) for a comparison of Opus, Sonnet, and Haiku. You can change the model later from the same dropdown.
3
Tell Claude what to do
Type what you want Claude to do:
- `Find a TODO comment and fix it`
- `Add tests for the main function`
- `Create a CLAUDE.md with instructions for this codebase`
A [session](/docs/en/desktop#work-in-parallel-with-sessions) is a conversation with Claude about your code. Each session tracks its own context and changes, so you can work on multiple tasks without them interfering with each other.
4
Review and accept changes
By default, the Code tab starts in [Ask permissions mode](/docs/en/desktop#choose-a-permission-mode), where Claude proposes changes and waits for your approval before applying them. You’ll see:
1. A [diff view](/docs/en/desktop#review-changes-with-diff-view) showing exactly what will change in each file
2. Accept/Reject buttons to approve or decline each change
3. Real-time updates as Claude works through your request
If you reject a change, Claude will ask how you’d like to proceed differently. Your files aren’t modified until you accept.
Now what?
You’ve made your first edit. For the full reference on everything Desktop can do, see [Use Claude Code Desktop](/docs/en/desktop). Here are some things to try next. **Interrupt and steer.** You can interrupt Claude at any point. If it’s going down the wrong path, click the stop button or type your correction and press **Enter**. Claude stops what it’s doing and adjusts based on your input. You don’t have to wait for it to finish or start over. **Give Claude more context.** Type `@filename` in the prompt box to pull a specific file into the conversation, attach images and PDFs using the attachment button, or drag and drop files directly into the prompt. The more context Claude has, the better the results. See [Add files and context](/docs/en/desktop#add-files-and-context-to-prompts). **Use skills for repeatable tasks.** Type `/` or click **+** → **Slash commands** to browse [built-in commands](/docs/en/commands), [custom skills](/docs/en/skills), and plugin skills. Skills are reusable prompts you can invoke whenever you need them, like code review checklists or deployment steps. **Review changes before committing.** After Claude edits files, a `+12 -1` indicator appears. Click it to open the [diff view](/docs/en/desktop#review-changes-with-diff-view), review modifications file by file, and comment on specific lines. Claude reads your comments and revises. Click **Review code** to have Claude evaluate the diffs itself and leave inline suggestions. **Adjust how much control you have.** Your [permission mode](/docs/en/desktop#choose-a-permission-mode) controls the balance. Ask permissions (default) requires approval before every edit. Auto accept edits auto-accepts file edits for faster iteration. Plan mode lets Claude map out an approach without touching any files, which is useful before a large refactor. **Add plugins for more capabilities.** Click the **+** button next to the prompt box and select **Plugins** to browse and install [plugins](/docs/en/desktop#install-plugins) that add skills, agents, MCP servers, and more. **Arrange your workspace.** Drag the chat, diff, terminal, file, and preview panes into whatever layout you want. Open the terminal with **Ctrl+\`** to run commands alongside your session, or click a file path to open it in the file pane. See [Arrange your workspace](/docs/en/desktop#arrange-your-workspace). **Preview your app.** Click the **Preview** dropdown to run your dev server directly in the desktop. Claude can view the running app, test endpoints, inspect logs, and iterate on what it sees. See [Preview your app](/docs/en/desktop#preview-your-app). **Track your pull request.** After opening a PR, Claude Code monitors CI check results and can automatically fix failures or merge the PR once all checks pass. See [Monitor pull request status](/docs/en/desktop#monitor-pull-request-status). **Put Claude on a schedule.** Set up [scheduled tasks](/docs/en/desktop-scheduled-tasks) to run Claude automatically on a recurring basis: a daily code review every morning, a weekly dependency audit, or a briefing that pulls from your connected tools. **Scale up when you’re ready.** Open [parallel sessions](/docs/en/desktop#work-in-parallel-with-sessions) from the sidebar to work on multiple tasks at once, each in its own Git worktree, and open the [tasks pane](/docs/en/desktop#watch-background-tasks) to watch the subagents and background commands a session has running. Open a [side chat](/docs/en/desktop#ask-a-side-question-without-derailing-the-session) to ask a question without derailing the main thread. Send [long-running work to the cloud](/docs/en/desktop#run-long-running-tasks-remotely) so it continues even if you close the app, or [continue a session on the web or in your IDE](/docs/en/desktop#continue-in-another-surface) if a task takes longer than expected. [Connect external tools](/docs/en/desktop#extend-claude-code) like GitHub, Slack, and Linear to bring your workflow together.
Coming from the CLI?
Desktop runs the same engine as the CLI with a graphical interface. You can run both simultaneously on the same project, and they share configuration (CLAUDE.md files, MCP servers, hooks, skills, and settings). For a full comparison of features, flag equivalents, and what’s not available in Desktop, see [CLI comparison](/docs/en/desktop#coming-from-the-cli).
What’s next
- [Use Claude Code Desktop](/docs/en/desktop): permission modes, parallel sessions, diff view, connectors, and enterprise configuration
- [Troubleshooting](/docs/en/desktop#troubleshooting): solutions to common errors and setup issues
- [Best practices](/docs/en/best-practices): tips for writing effective prompts and getting the most out of Claude Code
- [Common workflows](/docs/en/common-workflows): tutorials for debugging, refactoring, testing, and more
---
## getting-started-with-local-mcp-servers-on-claude-desktop-d2288e44ed.md
# Getting Started with Local MCP Servers on Claude Desktop
Copy for LLM
The Model Context Protocol (MCP) is an open protocol that enables seamless integration between LLM applications and external data sources and tools. With the introduction of desktop extensions, installing and managing local MCP servers has become significantly easier.
## Desktop Extensions
Desktop extensions provide a streamlined way to install and manage local MCP servers through single-click installable packages. Instead of manually configuring JSON files and managing dependencies, you can now install local MCP servers on your computer as easily as browser extensions.
**Note:** If you’re a developer who wants to list a desktop extension (a local MCP server for Claude Desktop) in the directory, submit it through the **[desktop extension submission form](https://clau.de/desktop-extention-submission)**. To submit a plugin or a remote connector instead, use the **[developer portal](https://claude.ai/directory/manage)**. See **[Submitting your plugin](https://claude.com/docs/plugins/submit)** for what each route accepts.
## Installing desktop extensions from the directory
1. Navigate to Settings \> Extensions on Claude Desktop.
2. Click “Browse extensions” to view our directory and click on any Anthropic-reviewed tools you want to use. Click "Install" on your desired extension.
3. Configure any required settings (like API keys) through the user-friendly interface.
4. The extension will automatically be available in your conversations.
## Installing custom desktop extensions
1. Navigate to Settings \> Extensions on Claude Desktop.
2. Click “Advanced settings” and find the **Extension Developer** section.
3. Click “Install Extension…”
4. Select the .mcpb file and follow the prompts to install.
## Admin Controls for Desktop Extensions
Owners and Primary Owners of Team and Enterprise plans can manage team access to desktop extensions using two controls:
1. Enable or disable public desktop extensions depending on your organization’s security standards.
2. Upload custom desktop extensions and make them available to your team for one-click install.
These controls allow organizations to fully customize their registries by adding only the extensions the team needs to access, and removing any others.
### Enabling/disabling specific extensions on Team and Enterprise plans
Owners and Primary Owners of Team and Enterprise organizations can manage which desktop extensions are enabled for your organization and accessible to other members via Claude Desktop. See [Enabling and using the desktop extension allowlist](https://support.claude.com/en/articles/12592343-enabling-and-using-the-desktop-extension-allowlist)
for specific instructions.
### Create and upload custom extensions for your organization
Custom desktop extensions uploads allow Team and Enterprise plans to leverage organization-specific workflows that aren’t available in the public directory. After creating a custom desktop extension, Owners and Primary Owners can navigate to Settings \> Extensions within Claude Desktop and click “Advanced settings” to access the **Extension Developer** section:
Click “Install Extension…” and select the .mcpb file. Follow the prompts to install and configure your custom desktop extension. For more in-depth information, please refer to our [desktop extension developer documentation](https://github.com/anthropics/mcpb).
## Enterprise Policy Controls
**Note:** Enterprise policy controls at the user-machine level will override any in-app controls (blocklist and allowlist). If you want to use an in-app control, ensure `isDesktopExtensionEnabled` and `isDesktopExtensionDirectoryEnabled` are not set to "false" so the allowlist can populate the available registry.
For controlling desktop extensions through system policies, please refer to our [desktop enterprise configuration documentation](https://support.claude.com/en/articles/12622667-enterprise-configuration).
## Troubleshooting desktop extension installation issues
### Extension won't install
- Ensure you're running the latest version of Claude Desktop.
- Check that the extension file isn't corrupted by re-downloading it.
- Verify you have sufficient disk space for the installation.
### Extension appears installed but tools aren't available
- Restart Claude Desktop to refresh the extension registry.
- Check the extension's configuration settings for missing required fields.
- Verify any API keys or authentication credentials are entered correctly.
### Extension configuration issues
- Navigate to Settings \> Extensions and click on the extension to review its settings.
- Ensure all required configuration fields are completed.
- Check that file paths (if applicable) point to existing directories you have access to.
### Permission or security errors
- On macOS, check System Preferences \> Security & Privacy if you receive security warnings.
- On Windows and Linux, ensure Claude Desktop has necessary permissions to access required directories.
- For enterprise environments, verify that desktop extensions are enabled through your organization's policies.
## Developer FAQ
### How do I check if my MCP servers are properly connected in Claude Desktop?
Click the "+" button on bottom the chat box within Claude Desktop, then select "Connectors." This will show you connected MCP servers and their tools. Alternatively, you can visit Developer settings (under **Desktop app**) to see connection status and look at the logs for any MCP servers.
### How do I convert my existing MCP server to a desktop extension?
1. Add a manifest.json file to your MCP server directory with the required metadata.
2. Package it using the `mcpb pack` command.
3. See the [MCPB documentation](https://github.com/anthropics/mcpb) for detailed instructions.
### What programming languages are supported for desktop extensions?
Desktop extensions support Node.js, Python, and binary MCP servers. Claude Desktop includes a built-in Node.js environment, so Node.js installation isn't required.
### How do I handle sensitive configuration like API keys?
Mark configuration fields as "sensitive": true in your manifest.json. Claude Desktop will automatically encrypt these values using the operating system's secure storage (Keychain on macOS, Credential Manager on Windows, and your distro’s keychain manager on Linux).
### Can I distribute my custom desktop extension privately?
Yes, you can share .mcpb files directly with specific users or teams. For broader distribution, you can submit extensions to the official directory.
### How do I debug issues with my desktop extension?
Enable debug logging in Claude Desktop settings, check the extension logs in the Extensions settings panel, and refer to the MCP debugging guide for protocol-specific troubleshooting.
### What happens when my extension needs updates?
Extensions from the official directory update automatically by default. For privately distributed extensions, users will need to install updated .mcpb files manually.
## Interested in learning more about MCP?
For more in-depth information on building your own MCP clients and servers, we recommend reviewing the following resources:
- [MCP Quickstart Guide](https://modelcontextprotocol.io/docs/getting-started/intro) - A step-by-step tutorial perfect for getting started with basic MCP integration.
- [Model Context Protocol Github](https://github.com/modelcontextprotocol) - Contains the complete technical documentation, code examples, and implementation guides.
- [Guide to debugging MCP integrations](https://modelcontextprotocol.io/docs/tools/debugging) - Troubleshooting tips and solutions for common implementation challenges.
If you need further guidance, visit our guide on [How to Get Support](https://support.claude.com/en/articles/9015913-how-to-get-support) for additional support options.
---
## getting-started-with-local-mcp-servers-on-claude-desktop.md
4. Getting Started with Local MCP Servers on Claude Desktop
# Getting Started with Local MCP Servers on Claude Desktop
The Model Context Protocol (MCP) is an open protocol that enables seamless integration between LLM applications and external data sources and tools. With the introduction of desktop extensions, installing and managing local MCP servers has become significantly easier.
## Desktop Extensions
Desktop extensions provide a streamlined way to install and manage local MCP servers through single-click installable packages. Instead of manually configuring JSON files and managing dependencies, you can now install local MCP servers on your computer as easily as browser extensions.
**Note:** We’re building a directory of desktop extensions – if you’re a developer hoping to add an extension you built to the directory, complete our [desktop extensions interest form](https://docs.google.com/forms/d/14_Dmcig4z8NeRMB_e7TOyrKzuZ88-BLYdLvS6LPhiZU/viewform?edit_requested=true) to share more information with us.
## Installing desktop extensions from the directory
1. Navigate to Settings \> Extensions on Claude Desktop.
2. Click “Browse extensions” to view our directory and click on any Anthropic-reviewed tools you want to use. Click "Install" on your desired extension.
3. Configure any required settings (like API keys) through the user-friendly interface.
4. The extension will automatically be available in your conversations.
## Installing custom desktop extensions
1. Navigate to Settings \> Extensions on Claude Desktop.
2. Click “Advanced settings” and find the **Extension Developer** section.
3. Click “Install Extension…”
4. Select the .mcpb file and follow the prompts to install.
## Admin Controls for Desktop Extensions
Owners and Primary Owners of Team and Enterprise plans can manage team access to desktop extensions using two controls:
1. Enable or disable public desktop extensions depending on your organization’s security standards.
2. Upload custom desktop extensions and make them available to your team for one-click install.
These controls allow organizations to fully customize their registries by adding only the extensions the team needs to access, and removing any others.
### Enabling/disabling specific extensions on Team and Enterprise plans
Owners and Primary Owners of Team and Enterprise organizations can manage which desktop extensions are enabled for your organization and accessible to other members via Claude Desktop. See [Enabling and using the desktop extension allowlist](https://support.claude.com/en/articles/12592343-enabling-and-using-the-desktop-extension-allowlist)
for specific instructions.
### Create and upload custom extensions for your organization
Custom desktop extensions uploads allow Team and Enterprise plans to leverage organization-specific workflows that aren’t available in the public directory. After creating a custom desktop extension, Owners and Primary Owners can navigate to Settings \> Extensions within Claude Desktop and click “Advanced settings” to access the **Extension Developer** section:
Click “Install Extension…” and select the .mcpb file. Follow the prompts to install and configure your custom desktop extension. For more in-depth information, please refer to our [desktop extension developer documentation](https://github.com/anthropics/mcpb).
## Enterprise Policy Controls
**Note:** Enterprise policy controls at the user-machine level will override any in-app controls (blocklist and allowlist). If you want to use an in-app control, ensure `isDesktopExtensionEnabled` and `isDesktopExtensionDirectoryEnabled` are not set to "false" so the allowlist can populate the available registry.
For controlling desktop extensions through system policies, please refer to our [desktop enterprise configuration documentation](../13-Enterprise-Admin/enterprise-configuration.md).
## Troubleshooting desktop extension installation issues
### Extension won't install
- Ensure you're running the latest version of Claude Desktop.
- Check that the extension file isn't corrupted by re-downloading it.
- Verify you have sufficient disk space for the installation.
### Extension appears installed but tools aren't available
- Restart Claude Desktop to refresh the extension registry.
- Check the extension's configuration settings for missing required fields.
- Verify any API keys or authentication credentials are entered correctly.
### Extension configuration issues
- Navigate to Settings \> Extensions and click on the extension to review its settings.
- Ensure all required configuration fields are completed.
- Check that file paths (if applicable) point to existing directories you have access to.
### Permission or security errors
- On macOS, check System Preferences \> Security & Privacy if you receive security warnings.
- On Windows, ensure Claude Desktop has necessary permissions to access required directories.
- For enterprise environments, verify that desktop extensions are enabled through your organization's policies.
## Developer FAQ
### How do I check if my MCP servers are properly connected in Claude Desktop?
Click the "+" button on bottom the chat box within Claude Desktop, then select "Connectors." This will show you connected MCP servers and their tools. Alternatively, you can visit Developer settings (under **Desktop app**) to see connection status and look at the logs for any MCP servers.
### How do I convert my existing MCP server to a desktop extension?
1. Add a manifest.json file to your MCP server directory with the required metadata.
2. Package it using the `mcpb pack` command.
3. See the [MCPB documentation](https://github.com/anthropics/mcpb) for detailed instructions.
### What programming languages are supported for desktop extensions?
Desktop extensions support Node.js, Python, and binary MCP servers. Claude Desktop includes a built-in Node.js environment, so Node.js installation isn't required.
### How do I handle sensitive configuration like API keys?
Mark configuration fields as "sensitive": true in your manifest.json. Claude Desktop will automatically encrypt these values using the operating system's secure storage (Keychain on macOS, Credential Manager on Windows).
### Can I distribute my custom desktop extension privately?
Yes, you can share .mcpb files directly with specific users or teams. For broader distribution, you can submit extensions to the official directory.
### How do I debug issues with my desktop extension?
Enable debug logging in Claude Desktop settings, check the extension logs in the Extensions settings panel, and refer to the MCP debugging guide for protocol-specific troubleshooting.
### What happens when my extension needs updates?
Extensions from the official directory update automatically by default. For privately distributed extensions, users will need to install updated .mcpb files manually.
## Interested in learning more about MCP?
For more in-depth information on building your own MCP clients and servers, we recommend reviewing the following resources:
- [MCP Quickstart Guide](../06-MCP-Tools/Tutorials/what-is-the-model-context-protocol-mcp-model-context-protocol.md) - A step-by-step tutorial perfect for getting started with basic MCP integration.
- [Model Context Protocol Github](https://github.com/modelcontextprotocol) - Contains the complete technical documentation, code examples, and implementation guides.
- [Guide to debugging MCP integrations](https://modelcontextprotocol.io/docs/tools/debugging) - Troubleshooting tips and solutions for common implementation challenges.
If you need further guidance, visit our guide on [How to Get Support](https://support.claude.com/en/articles/9015913-how-to-get-support) for additional support options.
---
## how-can-i-uninstall-claude-for-android.md
4. How can I uninstall Claude for Android?
# How can I uninstall Claude for Android?
To uninstall the Claude app from your Android device, hold down on the app from your screen until you see the menu options. Click on “App Info.” From the next series of options, select “Uninstall.”
Note that if you have an active Claude Pro subscription and would like to uninstall the app, your subscription will not be automatically canceled. To cancel your subscription, follow the cancellation instructions [here](https://support.anthropic.com/en/articles/9612898-how-can-i-cancel-my-claude-pro-subscription-on-claude-for-android).
---
## how-do-i-install-claude-for-android-77afc73614.md
# Install Claude for Android
July 9, 2026
Copy for LLM
## Install the Claude for Android app
You can install the Claude app onto your device by navigating to the Play Store and searching for "Claude by Anthropic," or by navigating directly to our **[Play Store listing](https://play.google.com/store/apps/details?id=com.anthropic.claude)**. Click on “Install” from the app listing to prompt your download.
## Why can’t I find Claude for Android in the Play Store?
If you’re unable to locate Claude for Android in your Play Store, you may be located in an **[unsupported region](https://support.claude.com/en/articles/8461763)**, using an unsupported device, or using an unsupported version of Android.
## What versions of Android are supported?
We currently support Android 8.0 Oreo and above.
## Uninstall the Claude for Android app
To uninstall the Claude app from your Android device, hold down on the app from your screen until you see the menu options. Click on "App Info." From the next series of options, select "Uninstall."
Note that if you have an active paid subscription and would like to uninstall the app, your subscription will not be automatically canceled. To cancel your subscription, follow the instructions here: **[Cancel your Pro or Max subscription on Claude for Android](https://support.claude.com/en/articles/8325617-cancel-your-pro-or-max-subscription#h_916bc20742)**.
---
## how-do-i-install-claude-for-android.md
# How do I install Claude for Android?
You can install the Claude app onto your device by navigating to the Play Store and searching for “Claude by Anthropic”, or by navigating directly to our [Play Store listing](https://play.google.com/store/apps/details?id=com.anthropic.claude). Click on “Install” from the app listing to prompt your download.
---
## how-to-update-claude-for-android-5356ce06b8.md
# How to update Claude for Android
March 16, 2026
Copy for LLM
If you aren’t seeing the latest features on Claude for Android, you may need to [update your mobile app manually by following these instructions from Google](https://support.google.com/googleplay/answer/113412?hl=en):
1. Open the Google Play Store app .
2. At the top right, tap the profile icon.
3. Tap “Manage apps & device.”
4. Under **Updates available**, tap “See details.”
5. Tap “Update” next to Claude for Android.
---
## how-to-update-claude-for-android.md
# How to update Claude for Android
If you aren’t seeing the latest features on Claude for Android, you may need to [update your mobile app manually by following these instructions from Google](https://support.google.com/googleplay/answer/113412?hl=en):
1. Open the Google Play Store app .
2. At the top right, tap the profile icon.
3. Tap “Manage apps & device.”
4. Under **Updates available**, tap “See details.”
5. Tap “Update” next to Claude for Android.
---
## how-to-update-claude-for-ios-3cf48f168c.md
# How to update Claude for iOS
Copy for LLM
If you aren’t seeing the latest features on Claude for iOS, you may need to update your mobile app manually by following these **[instructions from Apple](https://support.apple.com/en-us/102629)**:
1. Open the App Store.
2. Tap the "My Account" button or your photo at the top of the screen.
3. Scroll down to see pending updates.
4. Tap "Update" next to Claude for iOS to update it to the newest version.
---
## install-claude-desktop-b4e9c3e38a.md
# Install Claude Desktop
Copy for LLM
The Claude desktop apps bring Claude's capabilities directly to your computer, allowing for seamless integration with your workflow.
## Availability
Claude Desktop is available on macOS, Windows, and Linux (beta). What you can do depends on your plan:
[TABLE]
## System Requirements
- macOS: macOS 11 (Big Sur) or higher
- Windows: Windows 10 or higher
- Linux: Ubuntu 22.04 LTS+ or Debian 12 (bookworm)+, on x64 or arm64
## Installation steps for mac OS and Windows
1. Visit the **[Claude downloads page](https://claude.ai/download)**.
2. Select the appropriate version for your operating system:
- For Mac users, find **macOS** and click "Download."
- For Windows users, find **Windows** and click "Download."
Once the download is completed:
1. Open the file to complete installation.
2. Launch Claude from your Applications folder (Mac) or Start menu (Windows).
3. Sign in with your account to get started.
## Installation steps for Linux
### Install using apt
On Linux, you can install Claude Desktop from Anthropic’s apt repository rather than as a downloaded .deb file so that updates arrive through your system's normal package updates rather than in-app.
1\. On Ubuntu or Debian, open a terminal and run:
sudo curl -fsSLo /usr/share/keyrings/claude-desktop-archive-keyring.asc https://downloads.claude.ai/claude-desktop/key.asc
echo "deb [signed-by=/usr/share/keyrings/claude-desktop-archive-keyring.asc] https://downloads.claude.ai/claude-desktop/apt/stable stable main" | sudo tee /etc/apt/sources.list.d/claude-desktop.list
sudo apt update && sudo apt install claude-desktop
2. Launch Claude from your applications menu, or run `claude-desktop` from a terminal, and sign in.
**Keeping Claude Desktop up to date on Linux**
The app doesn't update itself. Updates arrive with your system's regular package updates (`sudo apt update && sudo apt upgrade`).
### Install using file download
**Note:** Downloading the .deb will not opt you into regular package updates. We highly recommend that you install using apt, or set up the apt repo using the steps above.
If you can’t install Claude Desktop using apt, you can install it by downloading a .deb file instead:
1. Visit the **[Claude downloads page](https://claude.ai/download)**.
2. Find the .deb for your architecture (x64 or arm64) and click "Download."
3. From the folder you downloaded the .deb file, run: `sudo apt install ~/Downloads/claude-desktop_amd64.deb`
4. Launch Claude from your applications menu (or run `claude-desktop`), then sign in.
### Verify the download on Linux (optional)
Verify the signing key fingerprint before trusting it:
1. Run: `gpg --show-keys /usr/share/keyrings/claude-desktop-archive-keyring.asc`
2. Confirm the output matches: `31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE`
### Current limitations when you use Claude Desktop on Linux
- Computer use isn't available.
- Dictation isn't available.
- Quick Entry, the global hotkey, works on X11. On native Wayland, it relies on your desktop's GlobalShortcuts portal.
------------------------------------------------------------------------
## Desktop extensions
Desktop extensions transform how you connect Claude to your desktop applications and data. Similar to browser extensions, these secure, installable packages let you:
- **Connect Claude to your desktop apps with one click**: Install extensions that integrate with your local files, calendars, emails, and messaging apps.
- **Access a curated directory of extensions**: Browse verified extensions directly within Claude Desktop, including options like filesystem access and iMessage.
- **Enjoy enterprise-ready security**: Extensions use code signing, encrypted storage for sensitive data like API keys, and enterprise policy controls.
To explore desktop extensions, navigate to Settings \> Extensions within the Claude Desktop app after installation.
**Note:** If you’re a developer who wants to list a desktop extension (a local MCP server for Claude Desktop) in the directory, submit it through the **[desktop extension submission form](https://clau.de/desktop-extention-submission)**. To submit a plugin or a remote connector instead, use the **[developer portal](https://claude.ai/directory/manage)**. See **[Submitting your plugin](https://claude.com/docs/plugins/submit)** for what each route accepts.
Read more about desktop extensions in our **[Getting Started with Local MCP Servers on Claude Desktop](https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop)** article.
------------------------------------------------------------------------
## Claude Cowork
Claude Cowork is available for all paid plans (Pro, Max, Team, Enterprise) using the Claude Desktop app on macOS, Windows, and Linux (beta).
Users on paid Claude plans can access Cowork in Claude Desktop. Cowork brings Claude Code's agentic capabilities to a visual interface, allowing you to hand off complex, multi-step tasks without using a terminal.
With Cowork, Claude can:
- Access your local files directly without manual uploads.
- Work on long-running tasks like research synthesis, file organization, and document generation.
- Coordinate parallel workstreams for complex projects.
- Deliver professional outputs like spreadsheets with working formulas and formatted presentations.
Cowork runs code in an isolated virtual machine on your computer. File reads and writes are limited to folders you connect, and network access follows your egress settings.
To learn more, see **[Get started with Cowork](https://support.claude.com/en/articles/13345190-get-started-with-cowork)**.
**Setup requirements for Claude Cowork on Linux**
Cowork on Linux has its own setup requirements. Cowork runs your tasks in a virtual machine on your computer. Before it can start, your machine needs:
- **Hardware virtualization (KVM).** Most computers support this, but it's sometimes turned off in firmware. If Cowork says virtualization isn't available, enable it in your BIOS or UEFI settings and restart.
- **Permission to use virtualization.** Add yourself to the KVM group, then log out and back in: `sudo usermod -aG kvm $USER`
- **QEMU and supporting packages.** Installing Claude with `apt install` pulls these in automatically.
- If you installed the .deb file directly on x64, run `sudo apt install qemu-system-x86 ovmf virtiofsd`
- On arm64, run `qemu-system-arm qemu-efi-aarch64 virtiofsd` instead.
- **About 25 GB of free disk space for the workspace image, and at least 8 GB of RAM.** The workspace uses 4 GB while it's running.
---
## install-claude-for-android-2f597cb90d.md
# Install Claude for Android
July 9, 2026
Copy for LLM
## Install the Claude for Android app
You can install the Claude app onto your device by navigating to the Play Store and searching for "Claude by Anthropic," or by navigating directly to our **[Play Store listing](https://play.google.com/store/apps/details?id=com.anthropic.claude)**. Click on “Install” from the app listing to prompt your download.
## Why can’t I find Claude for Android in the Play Store?
If you’re unable to locate Claude for Android in your Play Store, you may be located in an **[unsupported region](https://support.claude.com/en/articles/8461763)**, using an unsupported device, or using an unsupported version of Android.
## What versions of Android are supported?
We currently support Android 8.0 Oreo and above.
## Uninstall the Claude for Android app
To uninstall the Claude app from your Android device, hold down on the app from your screen until you see the menu options. Click on "App Info." From the next series of options, select "Uninstall."
Note that if you have an active paid subscription and would like to uninstall the app, your subscription will not be automatically canceled. To cancel your subscription, follow the instructions here: **[Cancel your Pro or Max subscription on Claude for Android](https://support.claude.com/en/articles/8325617-cancel-your-pro-or-max-subscription#h_916bc20742)**.
---
## install-claude-for-ios-494d818505.md
# Install Claude for iOS
Copy for LLM
## How do I install the Claude for iOS app?
You can install the Claude app onto your iOS device by navigating to the App Store and searching for “Claude by Anthropic”, or by navigating directly to our [App Store listing](https://apps.apple.com/us/app/claude/id6473753684). Click on “Get” from the app listing to prompt your download.
## Why can’t I find Claude for iOS in the App Store?
If you’re unable to locate Claude for iOS in your App Store, you may be located in an [unsupported region](https://support.claude.com/en/articles/8461763-where-can-i-access-claude), using an unsupported device, or using an unsupported version of iOS.
## What versions of iOS are supported?
We currently support iOS version 18.0 and above, and iPadOS 18.0 and above.
## How do I uninstall the Claude for iOS app?
To uninstall the Claude for iOS from your device, hold down on the app from your home screen until you see the menu options. Click on “Remove App.” From the next series of options, select “Delete App.”
Note that if you have an active paid Claude subscription and would like to uninstall the app, your subscription will not be automatically canceled. To cancel your subscription, follow the instructions here: [How do I cancel my paid Claude subscription?](https://support.claude.com/en/articles/8325617-how-do-i-cancel-my-paid-claude-subscription)
---
## installing-claude-desktop-fab42be3a2.md
# Install Claude Desktop
Copy for LLM
The Claude desktop apps bring Claude's capabilities directly to your computer, allowing for seamless integration with your workflow.
## Availability
Claude Desktop is available on macOS, Windows, and Linux (beta). What you can do depends on your plan:
[TABLE]
## System Requirements
- macOS: macOS 11 (Big Sur) or higher
- Windows: Windows 10 or higher
- Linux: Ubuntu 22.04 LTS+ or Debian 12 (bookworm)+, on x64 or arm64
## Installation steps for mac OS and Windows
1. Visit the **[Claude downloads page](https://claude.ai/download)**.
2. Select the appropriate version for your operating system:
- For Mac users, find **macOS** and click "Download."
- For Windows users, find **Windows** and click "Download."
Once the download is completed:
1. Open the file to complete installation.
2. Launch Claude from your Applications folder (Mac) or Start menu (Windows).
3. Sign in with your account to get started.
## Installation steps for Linux
### Install using apt
On Linux, you can install Claude Desktop from Anthropic’s apt repository rather than as a downloaded .deb file so that updates arrive through your system's normal package updates rather than in-app.
1\. On Ubuntu or Debian, open a terminal and run:
sudo curl -fsSLo /usr/share/keyrings/claude-desktop-archive-keyring.asc https://downloads.claude.ai/claude-desktop/key.asc
echo "deb [signed-by=/usr/share/keyrings/claude-desktop-archive-keyring.asc] https://downloads.claude.ai/claude-desktop/apt/stable stable main" | sudo tee /etc/apt/sources.list.d/claude-desktop.list
sudo apt update && sudo apt install claude-desktop
2. Launch Claude from your applications menu, or run `claude-desktop` from a terminal, and sign in.
**Keeping Claude Desktop up to date on Linux**
The app doesn't update itself. Updates arrive with your system's regular package updates (`sudo apt update && sudo apt upgrade`).
### Install using file download
**Note:** Downloading the .deb will not opt you into regular package updates. We highly recommend that you install using apt, or set up the apt repo using the steps above.
If you can’t install Claude Desktop using apt, you can install it by downloading a .deb file instead:
1. Visit the **[Claude downloads page](https://claude.ai/download)**.
2. Find the .deb for your architecture (x64 or arm64) and click "Download."
3. From the folder you downloaded the .deb file, run: `sudo apt install ~/Downloads/claude-desktop_amd64.deb`
4. Launch Claude from your applications menu (or run `claude-desktop`), then sign in.
### Verify the download on Linux (optional)
Verify the signing key fingerprint before trusting it:
1. Run: `gpg --show-keys /usr/share/keyrings/claude-desktop-archive-keyring.asc`
2. Confirm the output matches: `31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE`
### Current limitations when you use Claude Desktop on Linux
- Computer use isn't available.
- Dictation isn't available.
- Quick Entry, the global hotkey, works on X11. On native Wayland, it relies on your desktop's GlobalShortcuts portal.
------------------------------------------------------------------------
## Desktop extensions
Desktop extensions transform how you connect Claude to your desktop applications and data. Similar to browser extensions, these secure, installable packages let you:
- **Connect Claude to your desktop apps with one click**: Install extensions that integrate with your local files, calendars, emails, and messaging apps.
- **Access a curated directory of extensions**: Browse verified extensions directly within Claude Desktop, including options like filesystem access and iMessage.
- **Enjoy enterprise-ready security**: Extensions use code signing, encrypted storage for sensitive data like API keys, and enterprise policy controls.
To explore desktop extensions, navigate to Settings \> Extensions within the Claude Desktop app after installation.
**Note:** If you’re a developer who wants to list a desktop extension (a local MCP server for Claude Desktop) in the directory, submit it through the **[desktop extension submission form](https://clau.de/desktop-extention-submission)**. To submit a plugin or a remote connector instead, use the **[developer portal](https://claude.ai/directory/manage)**. See **[Submitting your plugin](https://claude.com/docs/plugins/submit)** for what each route accepts.
Read more about desktop extensions in our **[Getting Started with Local MCP Servers on Claude Desktop](https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop)** article.
------------------------------------------------------------------------
## Claude Cowork
Claude Cowork is available for all paid plans (Pro, Max, Team, Enterprise) using the Claude Desktop app on macOS, Windows, and Linux (beta).
Users on paid Claude plans can access Cowork in Claude Desktop. Cowork brings Claude Code's agentic capabilities to a visual interface, allowing you to hand off complex, multi-step tasks without using a terminal.
With Cowork, Claude can:
- Access your local files directly without manual uploads.
- Work on long-running tasks like research synthesis, file organization, and document generation.
- Coordinate parallel workstreams for complex projects.
- Deliver professional outputs like spreadsheets with working formulas and formatted presentations.
Cowork runs code in an isolated virtual machine on your computer. File reads and writes are limited to folders you connect, and network access follows your egress settings.
To learn more, see **[Get started with Cowork](https://support.claude.com/en/articles/13345190-get-started-with-cowork)**.
**Setup requirements for Claude Cowork on Linux**
Cowork on Linux has its own setup requirements. Cowork runs your tasks in a virtual machine on your computer. Before it can start, your machine needs:
- **Hardware virtualization (KVM).** Most computers support this, but it's sometimes turned off in firmware. If Cowork says virtualization isn't available, enable it in your BIOS or UEFI settings and restart.
- **Permission to use virtualization.** Add yourself to the KVM group, then log out and back in: `sudo usermod -aG kvm $USER`
- **QEMU and supporting packages.** Installing Claude with `apt install` pulls these in automatically.
- If you installed the .deb file directly on x64, run `sudo apt install qemu-system-x86 ovmf virtiofsd`
- On arm64, run `qemu-system-arm qemu-efi-aarch64 virtiofsd` instead.
- **About 25 GB of free disk space for the workspace image, and at least 8 GB of RAM.** The workspace uses 4 GB while it's running.
---
## installing-claude-for-ios-116c654403.md
# Install Claude for iOS
Copy for LLM
## How do I install the Claude for iOS app?
You can install the Claude app onto your iOS device by navigating to the App Store and searching for “Claude by Anthropic”, or by navigating directly to our [App Store listing](https://apps.apple.com/us/app/claude/id6473753684). Click on “Get” from the app listing to prompt your download.
## Why can’t I find Claude for iOS in the App Store?
If you’re unable to locate Claude for iOS in your App Store, you may be located in an [unsupported region](https://support.claude.com/en/articles/8461763-where-can-i-access-claude), using an unsupported device, or using an unsupported version of iOS.
## What versions of iOS are supported?
We currently support iOS version 18.0 and above, and iPadOS 18.0 and above.
## How do I uninstall the Claude for iOS app?
To uninstall the Claude for iOS from your device, hold down on the app from your home screen until you see the menu options. Click on “Remove App.” From the next series of options, select “Delete App.”
Note that if you have an active paid Claude subscription and would like to uninstall the app, your subscription will not be automatically canceled. To cancel your subscription, follow the instructions here: [How do I cancel my paid Claude subscription?](https://support.claude.com/en/articles/8325617-how-do-i-cancel-my-paid-claude-subscription)
---
## installing-claude-for-ios.md
# Installing Claude for iOS
## How do I install the Claude for iOS app?
You can install the Claude app onto your iOS device by navigating to the App Store and searching for “Claude by Anthropic”, or by navigating directly to our [App Store listing](https://apps.apple.com/us/app/claude/id6473753684). Click on “Get” from the app listing to prompt your download.
## Why can’t I find Claude for iOS in the App Store?
If you’re unable to locate Claude for iOS in your App Store, you may be located in an [unsupported region](https://support.claude.com/en/articles/8461763-where-can-i-access-claude), using an unsupported device, or using an unsupported version of iOS.
## What versions of iOS are supported?
We currently support iOS version 17.0 and above.
## How do I uninstall the Claude for iOS app?
To uninstall the Claude for iOS from your device, hold down on the app from your home screen until you see the menu options. Click on “Remove App.” From the next series of options, select “Delete App.”
Note that if you have an active paid Claude subscription and would like to uninstall the app, your subscription will not be automatically canceled. To cancel your subscription, follow the instructions here: [How do I cancel my paid Claude subscription?](https://support.claude.com/en/articles/8325617-how-do-i-cancel-my-paid-claude-subscription)
---
## navigating-the-claude-desktop-app-chat-claude-cowork-claude-code-claude-academy-e2af239bcb.md
# Navigating the Claude desktop app
Learn what changes when you use Claude in the desktop app, and what it can do across your computer and tools.
6 minClaude.ai
[Open Claude](https://claude.ai/new)
The [Claude desktop app(opens in new tab)](https://claude.com/download) puts Claude on your computer. That lets Claude open from any app with a shortcut, work in more of your apps and websites, and directly read, edit, or save files in your folders to carry a task further from start to finish.
Working in code? See the [Claude Code desktop docs(opens in new tab)](https://code.claude.com/docs/en/desktop).
In this guide
1. [1. Claude is one shortcut awayYou want Claude without switching windows](#1-claude-is-one-shortcut-away)
2. [2. Claude can work in your files, apps, and websitesThe work is in your files, an app on your computer, or a website](#2-claude-can-work-in-your-files-apps-and-websites)
3. [3. Claude can keep going while you're awayA task takes a while and needs your computer](#3-claude-can-keep-going-while-youre-away)
4. [Get startedSet up Claude on a real piece of your work](#get-started)
*Conversations, projects, memory, skills, uploads, voice, and your connectors (email, calendar, Slack, Drive) work the same on the web, your phone, and the desktop app.*
## 1. Claude is one shortcut away[](#1-claude-is-one-shortcut-away)
In the [Claude desktop app(opens in new tab)](https://claude.com/download), quick entry is a small Claude window that opens on top of whatever app you're in and stays in front as you switch apps. Reach it a few ways:
- **Type:** Double-tap Option on a Mac, or use the shortcut you set in [Settings(opens in new tab)](https://claude.ai/desktop/settings/desktop) on Windows or Linux (beta), then type your question.
- **Speak (Mac):** Press Caps Lock, talk, then press it again (turn it on in Settings).
- **Menu bar or system tray:** Click the Claude icon in the menu bar (Mac) or system tray (Windows). Turn it on or off with the **Menu bar** or **System tray** setting in [Settings(opens in new tab)](https://claude.ai/desktop/settings/desktop).
On a Mac you can also show your screen. Hover over a window to send a screenshot of it, or drag to capture part of the screen (the first time, choose **Turn on screenshots**). To attach a file, drag it onto the app icon or open it with Claude.
Voice, dictation, and uploads work on the web, your phone, and the desktop app (dictation isn't available on Linux yet); the desktop app lets you reach these features in Claude quickly, from whatever app you're in.
Things to ask:
- *What do these numbers mean, and which one should I keep an eye on?*
- *Summarize what's on my screen right now.*
- *Help me word a reply to this message.*
Loading
Good to know
- Screenshots from quick entry and speaking with Caps Lock are Mac-only. On Windows and Linux, a keyboard shortcut brings up Claude.
- The Linux app is in beta.
See [Use quick entry on Mac(opens in new tab)](https://support.claude.com/en/articles/12626668-use-quick-entry-with-claude-desktop-on-mac) and [Claude for Linux (beta)(opens in new tab)](https://code.claude.com/docs/en/desktop-linux).
## 2. Claude can work in your files, apps, and websites[](#2-claude-can-work-in-your-files-apps-and-websites)
On the desktop app, Claude can work directly in the files, apps, and websites where your work already is. Instead of carrying material to Claude and results away, you let Claude handle the whole task in place. You choose what Claude can use, and Claude works only with what you share: folders, apps, websites, or your screen.
### Folders[](#folders)
On the web you might upload or drag in files. On the desktop app, Claude can go directly to your folders to read and edit what it needs and save finished work back to them.
To give access:
1. Under the message box, add a folder.
2. Allow Claude to edit the files in it.
With that permission, Claude reads what it needs from the folder and saves finished work back to it.
Once Claude can see a folder, you can ask Claude to:
- *Pull the numbers from a folder of PDF invoices into one spreadsheet.*
- *Sort a cluttered Downloads folder into clearly named subfolders.*
- *Each month, add the new invoices to that same spreadsheet, building a running record.*
A task like that can later [run on a schedule(opens in new tab)](https://support.claude.com/en/articles/13854387-schedule-recurring-tasks-in-cowork).
### Apps[](#apps)
[Connectors(opens in new tab)](https://claude.ai/directory) are available wherever you use Claude and connect tools like your email, docs, and CRM. In addition to those, the desktop app lets you add extensions like Apple Notes or Messages on a Mac. Add them from [Extensions in the desktop app(opens in new tab)](https://claude.ai/desktop/settings/desktop/extensions). See the [extensions guide(opens in new tab)](https://support.claude.com/en/collections/17879657-desktop-extensions).
Things to ask:
- *Turn the action items from this thread into a new Apple note.*
- *Text Sam that I'm running ten minutes late.*
- *Pull my notes on the Rivera account into a summary I can send.*
### Websites[](#websites)
The built-in browser is a browser panel inside the desktop app, next to your task. Claude can open sites, read pages, click, type, and fill forms in it, and you watch each step as it happens. It has its own tabs and history, separate from your own browser, so your Chrome stays free for you while Claude works in its own window.
1. In Settings, set the built-in browser as your preferred browser.
2. Ask Claude to use a website.
3. The first time Claude acts on that site, you choose to allow it once, allow it always for that site, or deny it.
Things to ask:
- *Find the opening hours and phone number on this restaurant's site.*
- *Fill out this online form using the details in my folder.*
- *Check whether this part is in stock on the supplier's site.*
Loading
A task in Claude, on the web or the desktop app, can also work in your own Chrome through the [Claude in Chrome(opens in new tab)](https://claude.com/chrome) browser extension. The same extension opens Claude in Chrome next to the page you're on.
Some pages carry hidden text meant to mislead an AI, and safety checks reduce that risk without removing it. Start with sites you trust, and handle anything sensitive yourself, like bank accounts or health records. See [Use Claude in Chrome safely(opens in new tab)](https://support.claude.com/en/articles/12902428-using-claude-for-chrome-safely) and [Use the built-in browser(opens in new tab)](https://support.claude.com/en/articles/16607400).
### Your screen, through computer use (beta)[](#your-screen-through-computer-use-beta)
For work that isn't in your files, connected tools, or on the web, computer use lets Claude work in other apps and programs by using your screen, mouse, and keyboard. Claude usually tries a connector first, then the built-in browser, and turns to computer use when neither fits, because clicking through one step at a time is the slowest of the three.
Computer use suits installed software with no connector, like an accounting program, a design tool, or an internal company app, and work that moves between apps, such as taking figures from one program into another.
Once it's turned on in Settings, Claude uses computer use on its own when a task needs it, or when you ask for it directly. While it works, Claude is moving the cursor and typing.
Things to ask:
- *Enter the receipts in this folder into my accounting app.*
- *Copy the figures from this spreadsheet into our internal ordering system.*
- *Resize these images in my photo editor and export them to this folder.*
By default, Claude asks before using an app, and you can stop Claude at any time. Claude can see what's on your screen while it works, so close anything sensitive first. See [Let Claude use your computer(opens in new tab)](https://support.claude.com/en/articles/14128542-let-claude-use-your-computer-in-cowork).
### Record a skill[](#record-a-skill)
[Skills(opens in new tab)](https://support.claude.com/en/articles/12512176-what-are-skills) are saved instructions that let Claude repeat a workflow the way you do it, whenever that work comes up. Some workflows are easier to show than to write down, so you can record one instead.
1. Start it from the plus menu in the message box.
2. Do the task once, saying what you're doing as you go.
3. Choose **Done**, and Claude turns the recording into a skill.
The skill is then available in Claude. While recording, don't type passwords or secrets, or show sensitive information or private conversations.
Things to record:
- *Pull each store's weekly sales from its dashboard into our shared sheet.*
- *Copy new leads from the form into the CRM the way I do it.*
- *File each week's reports into the right folders by client.*
Loading
Good to know
Working in your folders, the built-in browser, computer use, and Record a skill need a paid plan:
- Folders come with every paid plan.
- The built-in browser is on Pro, Max, and Team, and on Enterprise where your admin allows it.
- Computer use is in beta on Mac and Windows, for Pro and Max.
- Record a skill is on Pro, Max, and Team, on Mac.
On Team and Enterprise plans, your admin can limit which extensions are allowed. See [Install Claude Desktop(opens in new tab)](https://support.claude.com/en/articles/10065433-install-claude-desktop).
### All of it together[](#all-of-it-together)
The desktop app lets a single task draw on your local files, your [connectors(opens in new tab)](https://support.claude.com/en/collections/15399129-connectors), and the web together. Uploading and connectors already work everywhere; here they combine with Claude's ability to view, edit, and save files directly on your computer.
Try prompts like:
- *Read my resume in my Downloads folder and my project files in Google Drive, then look through job sites for roles that fit and shortlist the best ones.*
- *Compare the invoices in my Vendors folder against the bills in Gmail, then check each vendor's website for current pricing.*
- *Read the deck in my Pitch folder, check my calendar for the client meeting, and look up their latest news on their website.*
## 3. Claude can keep going while you're away[](#3-claude-can-keep-going-while-youre-away)
Start a big task and step away. It keeps going after you close the window, and you can check on it or answer its questions from the web or the mobile app.
When the task is working in a folder, an app, or the browser on your computer, that computer is part of the task, so keep it on and awake with the desktop app open. **Keep computer awake** in Settings stops it from idle-sleeping while the app is open. The display can still turn off, and closing the laptop lid still puts it to sleep.
Working in code?
If you write software, everything on this page applies to code work too, and the desktop app adds Claude Code, a visual coding workbench. See the [Claude Code desktop guide(opens in new tab)](https://code.claude.com/docs/en/desktop) to get started.
## Get started[](#get-started)
Loading
[Download the desktop app(opens in new tab)](https://claude.com/download) for Mac, Windows, or Linux (beta).
- [1. Claude is one shortcut away](#1-claude-is-one-shortcut-away)
- [2. Claude can work in your files, apps, and websites](#2-claude-can-work-in-your-files-apps-and-websites)
- [3. Claude can keep going while you're away](#3-claude-can-keep-going-while-youre-away)
---
## open-claude-desktop-with-a-link-c74e46c178.md
# Open Claude Desktop with a link
June 30, 2026
Copy for LLM
Claude for macOS, Windows, and Linux respond to the `claude://` URL scheme, much like a browser responds to the `https://` scheme. You can use these links from a website, a script, or another app to open Claude Desktop and jump straight to a chat, a Cowork session, or a Code session.
This article lists the link formats Claude Desktop supports and the parameters each one accepts.
## How deep links work
When your operating system opens a `claude://` URL, it hands the URL to Claude. If the app isn't running, macOS, Windows, and Linux will launch it first. Claude then reads the path and query parameters and navigates to the right place inside the app.
All parameter values must be URL-encoded. Prompt text passed in `q` is truncated to roughly 14,000 characters.
------------------------------------------------------------------------
## Start a new chat
claude://claude.ai/new
claude://claude.ai/new?q=Summarize%20this%20week%27s%20release%20notes
Opens a new chat in Claude Desktop. If you include `q`, the prompt field is prefilled with that text so you can review and send it.
[TABLE]
------------------------------------------------------------------------
## Open an existing chat or project
claude://claude.ai/chat/{conversation-id}
claude://claude.ai/project/{project-id}
Opens a specific chat or project by its ID. The ID is the UUID you see at the end of the chat or project URL in Claude. If the ID is missing or invalid, Claude opens your recent chats or your projects list instead.
------------------------------------------------------------------------
## Start a Claude Code session
claude://code/new
claude://code/new?q=Fix%20the%20failing%20test&folder=%2FUsers%2Fme%2Frepo
Opens Claude Code in Claude Desktop with the composer prefilled. Use this for "Open in Claude Code" buttons in your own tools.
[TABLE]
**Note:** Any folder supplied through a link is treated as untrusted. Claude Desktop always shows a confirmation dialog before adopting it as the working directory, even if you've trusted that folder before.
------------------------------------------------------------------------
## Start a Claude Cowork session
claude://cowork/new
claude://cowork/new?q=Draft%20the%20Q2%20update&folder=%2FUsers%2Fme%2Fdocs&file=%2FUsers%2Fme
%2Fdocs%2Fnotes.md
Opens a new Cowork session with the composer prefilled. Use this for "Open in Claude Cowork" buttons in your own tools.
[TABLE]
**Note:** Any folder supplied through a link is treated as untrusted. Claude Desktop always shows a confirmation dialog before adopting it as the working directory, even if you've trusted that folder before.
------------------------------------------------------------------------
## Test a deep link
### On macOS
Open Terminal and run:
open "claude://claude.ai/new?q=Hello"
### On Windows
Open Command Prompt and run:
start "" "claude://claude.ai/new?q=Hello"
### On Linux
Open a terminal and run:
xdg-open "claude://claude.ai/new?q=Hello"
---
## open-the-claude-mobile-app-with-a-link-4ec5486bee.md
# Open the Claude mobile app with a link
May 6, 2026
Copy for LLM
The Claude mobile apps for iOS and Android respond to the `claude://` URL scheme. Third-party apps, shortcuts, and web pages can use these links to open the Code tab, jump to an existing session, or prefill the new-session composer. All parameter values must be URL-encoded.
These links require Claude Code access on your account. If you don't have access to Claude Code, the links won't work.
## Open the Code tab
`claude://code`
Opens the Code tab on the session list.
## Open an existing Code session
`claude://code/{session-id}`
Opens an existing Claude Code session by ID. If the ID is unknown, you'll land on the session list.
## Open a new Code session
`claude://code/new`
With optional parameters: `claude://code/new?q=Fix%20the%20failing%20test&repo=anthropics%2Fclaude-code&branch=main`
Opens the new-session composer, optionally prefilled. All parameters are optional.
[TABLE]
The **[desktop-only folder and file parameters](https://support.claude.com/en/articles/14729294-open-claude-desktop-with-a-link)** are ignored on mobile.
## Universal links
The same Code routes are also reachable via **[https://claude.ai/code/](https://claude.ai/code/)...** universal links. If the app is installed, the operating system opens it; otherwise the link opens in the browser.
[TABLE]
---
## schedule-recurring-tasks-in-claude-code-desktop-claude-code-docs-fda20a50de.md
# Schedule recurring tasks in Claude Code Desktop
Set up scheduled tasks in Claude Code Desktop to run Claude automatically on a recurring basis for daily code reviews, dependency audits, or morning briefings.
> ## Documentation Index
>
> Fetch the complete documentation index at: <https://code.claude.com/docs/llms.txt>
>
> Use this file to discover all available pages before exploring further.
Scheduled tasks start a new session automatically at a time and frequency you choose. Use them for recurring work like daily code reviews, dependency update checks, or morning briefings that pull from your calendar and inbox. The Desktop app’s **Routines** page lets you create both local scheduled tasks and remote [routines](/docs/en/routines). A local task runs on your machine with direct access to your files and tools, but only fires while the app is open and your computer is awake. A remote routine runs on Anthropic-managed cloud infrastructure even when your computer is off, and can also fire on API calls or GitHub events. This page covers local scheduled tasks; for remote routines and their trigger options, see [Routines](/docs/en/routines).
Compare scheduling options
Claude Code offers three ways to schedule recurring or one-off work:
| | [Cloud](/docs/en/routines) | [Desktop](/docs/en/desktop-scheduled-tasks) | [`/loop`](/docs/en/scheduled-tasks) |
|:---------------------------|:-------------------------------|:--------------------------------------------|:------------------------------------|
| Runs on | Anthropic cloud | Your machine | Your machine |
| Requires machine on | No | Yes | Yes |
| Requires open session | No | No | Yes |
| Persistent across restarts | Yes | Yes | Restored on `--resume` if unexpired |
| Access to local files | No (fresh clone) | Yes | Yes |
| MCP servers | Connectors configured per task | [Config files](/docs/en/mcp) and connectors | Inherits from session |
| Permission prompts | No (runs autonomously) | Configurable per task | Inherits from session |
| Customizable schedule | Via `/schedule` in the CLI | Yes | Yes |
| Minimum interval | 1 hour | 1 minute | 1 minute |
Use **cloud tasks** for work that should run reliably without your machine. Use **Desktop tasks** when you need access to local files and tools. Use **`/loop`** for quick polling during a session.
By default, scheduled tasks run against whatever state your working directory is in, including uncommitted changes. Enable the worktree toggle when creating the task to give each run its own isolated Git worktree, the same way [parallel sessions](/docs/en/desktop#work-in-parallel-with-sessions) work.
Create a scheduled task
Click **Routines** in the sidebar, then click **New routine** and choose **Local**. Configure these fields:
| Field | Description |
|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Name | Identifier for the task. Converted to lowercase kebab-case and used as the folder name on disk. Must be unique across your tasks. |
| Description | Short summary shown in the task list. |
| Instructions | What Claude should do when the task runs. Write this the same way you’d write any message in the prompt box. The instructions input includes pickers for the permission mode and model, and below it you select the working folder and whether to run in an isolated worktree. |
| Schedule | How often the task runs. See [schedule options](#schedule-options) below. |
A folder is required before you can save the task. If you haven’t trusted that folder yet, Desktop prompts you to trust it before saving. You can also create a task by describing what you want in any session. For example, “set up a daily code review that runs every morning at 9am” creates a recurring task, and “remind me at 3pm tomorrow to check the deploy” creates a one-time task that disables itself after it fires.
Schedule options
Pick a preset from the Schedule control:
- **Manual**: no schedule, only runs when you click **Run now**. Useful for saving a prompt you trigger on demand
- **Hourly**: runs every hour
- **Daily**: shows a time picker, defaults to 9:00 AM local time
- **Weekdays**: same as Daily but skips Saturday and Sunday
- **Weekly**: shows a time picker and a day picker
For intervals the picker doesn’t offer, such as every 15 minutes, the first of each month, or a single run at a specific future time, ask Claude in any Desktop session to set the schedule. Use plain language; for example, “schedule a task to run all the tests every 6 hours.”
How scheduled tasks run
Scheduled tasks run on your machine. Desktop checks the schedule every minute while the app is open and starts a fresh session when a task is due, independent of any manual sessions you have open. Each task gets a small delay of a few minutes after the scheduled time to stagger API traffic. The delay is deterministic: the same task always starts at the same offset. When a task fires, you get a desktop notification and a new session appears under a **Scheduled** section in the sidebar. Open it to see what Claude did, review changes, or respond to permission prompts. The session works like any other: Claude can edit files, run commands, create commits, and open pull requests. Tasks only run while the desktop app is running and your computer is awake. If your computer sleeps through a scheduled time, the run is skipped. To prevent idle-sleep, enable **Keep computer awake** in Settings under **Desktop app → General**. Closing the laptop lid still puts it to sleep. For tasks that need to run even when your computer is off, or that should trigger on an API call or GitHub event, create a remote [routine](/docs/en/routines) instead.
Missed runs
When the app starts or your computer wakes, Desktop checks whether each task missed any runs in the last seven days. If it did, Desktop starts exactly one catch-up run for the most recently missed time and discards anything older. A daily task that missed six days runs once on wake. Desktop shows a notification when a catch-up run starts. Keep this in mind when writing prompts. A task scheduled for 9am might run at 11pm if your computer was asleep all day. If timing matters, add guardrails to the prompt itself, for example: “Only review today’s commits. If it’s after 5pm, skip the review and just post a summary of what was missed.”
Permissions for scheduled tasks
Each task has its own permission mode, which you set when creating or editing the task. Allow rules from `~/.claude/settings.json` also apply to scheduled task sessions. If a task runs in Ask mode and needs to run a tool it doesn’t have permission for, the run stalls until you approve it. The session stays open in the sidebar so you can answer later. To avoid stalls, click **Run now** after creating a task, watch for permission prompts, and select “always allow” for each one. Future runs of that task auto-approve the same tools without prompting. You can review and revoke these approvals from the task’s detail page.
Manage scheduled tasks
Click a task in the **Routines** list to open its detail page. From here you can:
- **Run now**: start the task immediately without waiting for the next scheduled time
- **Status**: toggle between Active and Paused to pause or resume scheduled runs without deleting the task
- **Edit**: change the instructions, schedule, folder, or other settings
- **Review history**: see every past run, including skipped runs. Hover a skipped entry to see why: your computer was asleep, the previous run was still in progress, or other scheduled tasks were already running. Click **Show more** to load older entries.
- **Review allowed permissions**: see and revoke saved tool approvals for this task from the **Always allowed** panel
- **Delete**: remove the task and archive all sessions it created. An **Also delete files on disk** checkbox appears in the confirmation dialog; check it to also remove the task’s `SKILL.md` file and associated data from `~/.claude/scheduled-tasks/`.
You can also list, create, edit, and pause tasks by asking Claude in any Desktop session. For example, “pause my dependency-audit task” or “show me my scheduled tasks.” To delete a task, use the **Delete** button on its detail page. A scheduled task can also modify its own schedule or prompt from within a running session using the `update_scheduled_task` MCP tool. This lets a task reschedule itself based on what it finds, for example, rescheduling a code review to run earlier when it detects a release branch has been created. To edit a task’s prompt on disk, open `~/.claude/scheduled-tasks/<task-name>/SKILL.md` (or under [`CLAUDE_CONFIG_DIR`](/docs/en/env-vars) if set). The file uses YAML frontmatter for `name` and `description`, with the prompt as the body. Changes take effect on the next run. Schedule, folder, model, and enabled state are not in this file: change them through the Edit form or ask Claude.
Related resources
- [Routines](/docs/en/routines): run tasks on Anthropic-managed infrastructure on a schedule, via API call, or in response to GitHub events, even when your computer is off
- [Run prompts on a schedule](/docs/en/scheduled-tasks): session-scoped scheduling with `/loop` in the CLI
- [Claude Code GitHub Actions](/docs/en/github-actions): run Claude on a schedule in CI instead of on your machine
- [Use Claude Code Desktop](/docs/en/desktop): the full Desktop app guide
---
## use-claude-app-intents-shortcuts-and-widgets-on-ios-6d93475073.md
# Use Claude app intents, shortcuts, and widgets on iOS
July 9, 2026
Copy for LLM
The features described in this guide are available on iOS 18 and above.
Claude for iOS supports multiple powerful features: the Claude widget, the "Analyze Photo with Claude" control, the "Ask Claude" App Intent, and the ability to use this intent within iOS Shortcuts. This guide will explain these features and show you how to make the most of them.
## Ask Claude intent
The "Ask Claude" intent is a standalone feature that lets you interact with Claude directly from:
- Spotlight search
- Siri
- The Share menu
- Any app that supports iOS intents
You can use this intent on its own to quickly ask Claude questions or give it tasks without opening the Claude app. For example, you can:
- Select text and use the Share menu to send it directly to Claude
- Ask Siri to "Ask Claude” and it will prompt you for a message
- Type "Ask Claude" in Spotlight search to quickly send a query
## Use Ask Claude with shortcuts
While the "Ask Claude" intent is powerful on its own, you can also use it as a building block within the Shortcuts app to create more complex workflows. Shortcuts allow you to:
- Chain multiple "Ask Claude" actions together
- Combine Claude's capabilities with other apps and actions
- Create automated workflows
- Process Claude's responses in various ways
## Create your first Claude shortcut
There are many customizable workflows you can set up within the Shortcuts app. Let's look at an example of a brief but useful shortcut that helps you summarize text:
1. Open the Shortcuts app on your iOS device
2. Tap the "+" button to create a new shortcut
3. Add the "Share" action and select your preferred input type
4. Add the "Ask Claude" action
5. In the "Ask Claude" action, create a prompt like: "Please summarize the following text: \[Shortcut Input\]"
6. Name your shortcut (e.g., "Summarize with Claude")
7. Optional: Add the shortcut to your Share Sheet for easy access
Now you can select text anywhere in iOS, tap the Share button, and choose your "Summarize with Claude" shortcut to get an instant summary.
When using "Ask Claude" intent and in shortcuts, the default model you see when opening the Claude app will be used.
More information on setting up shortcuts on your iOS device can be found [here](https://support.apple.com/guide/shortcuts/welcome/ios).
**Note:** When using the "Ask Claude" intent, messages to Claude will count towards your overall usage limit.
## Add the Claude Widget
The Claude widget provides quick access to chat and voice features directly from your Home Screen or Today View. The widget includes buttons for:
- Starting a new chat
- Instantly opening the app in dictation mode
- Taking a photo to share with Claude
### Add the Claude widget to your Home Screen
1. From the Home Screen, touch and hold a widget or an empty area until the apps jiggle
2. Tap Edit in the upper-left corner
3. Tap Add Widget
4. Search for and select Claude
5. Tap Add Widget
6. Tap Done
### Add the Claude widget to your Today View
Swipe right from the Home Screen or Lock Screen, then follow the same steps as adding to the Home Screen.
### Use the widget
- Tap the chat button to start a new conversation with Claude.
- Tap the microphone button to instantly open the app in dictation mode, allowing you to start speaking to Claude right away.
- Tap the camera button to take a photo and share it with Claude for analysis.
**Note:** Like the "Ask Claude" intent, interactions started through the widget will count toward your usage limit.
## The Analyze Photo with Claude control
The "Analyze Photo with Claude" control lets you quickly send images to Claude for analysis directly from Control Center or your Lock Screen.
### Add to Control Center
1. Open Control Center (swipe down from the top-right corner on iPhones with Face ID, or swipe up from the bottom on iPhones with a Home button)
2. Tap the Add button (plus sign) at the top left of Control Center to begin editing
3. Tap "Add a Control" at the bottom of the screen to open the controls gallery
4. Find and tap "Analyze Photo with Claude" to add it to Control Center
5. You can rearrange its position by dragging it to your preferred location
6. When finished, close Control Center by swiping up from the bottom center of the screen
Once added, you can quickly access it from Control Center by swiping down from the top-right corner of the screen.
More information on using and setting up controls via Control Center can be found [here](https://support.apple.com/guide/iphone/use-and-customize-control-center-iph59095ec58/ios).
### Add to your lock screen
1. On your Lock Screen, touch and hold until the customization screen appears
2. Tap "Customize"
3. Select the lock screen you want to modify
4. Remove one of the controls at the bottom of the screen using the Remove button (minus sign), then tap the Add button (plus sign) to open the controls gallery
5. From the available controls menu, scroll or search for "Analyze Photo with Claude"
6. Tap to select it
7. Tap "Done" to save your changes
You can now quickly access the "Analyze Photo with Claude" control without needing to unlock your device or open the Claude app first.
---
## use-claude-code-desktop-claude-code-docs-dc0e6ba558.md
# Use Claude Code Desktop
Get more out of Claude Code Desktop: parallel sessions with Git isolation, drag-and-drop pane layout, integrated terminal and file editor, side chats, computer use, Dispatch sessions from your phone, visual diff review, app previews, PR monitoring, connectors, and enterprise configuration.
The Claude Desktop app has three tabs: **Chat** for conversations, **Cowork** for [Dispatch and longer agentic work](https://claude.com/product/cowork), and **Code** for software development. This page is the reference for the Code tab.
## Download for macOS
Universal build for Intel and Apple Silicon
## Download for Windows
For x64 processors
For Windows ARM64, download the [ARM64 installer](https://claude.ai/api/desktop/win32/arm64/setup/latest/redirect?utm_source=claude_code&utm_medium=docs). Linux is not supported. After installing, launch Claude, sign in, and click the **Code** tab. The first time you open it on Windows, you need [Git for Windows](https://git-scm.com/downloads/win) installed; restart the app after installing it. For a walkthrough of your first session, see the [Get started guide](/docs/en/desktop-quickstart). In the Code tab, each conversation is a **session**: it has its own chat history, project folder, and code changes, independent of any other session. The sidebar lists your sessions and lets you run several in parallel. Within a session you can:
- [Review and comment on diffs](#review-changes-with-diff-view), then [watch the resulting PR through CI](#monitor-pull-request-status)
- [Preview your running app](#preview-your-app) in an embedded browser while Claude verifies its own changes
- [Arrange panes](#arrange-your-workspace) for the chat, diff, preview, terminal, and file editor side by side
- Ask a [side question](#ask-a-side-question-without-derailing-the-session) that uses the session’s context without derailing it
- [Connect external tools](#connect-external-tools) like GitHub, Slack, and Linear
- Let Claude [open apps and control your screen](#let-claude-use-your-computer)
- Run on your machine, in the [cloud](#run-long-running-tasks-remotely), or over [SSH](#ssh-sessions)
For [scheduled recurring work](/docs/en/desktop-scheduled-tasks), [keyboard shortcuts](#keyboard-shortcuts), or [sending tasks from your phone](#sessions-from-dispatch), see the linked pages and sections. If you already use the terminal-based CLI, see the [CLI comparison](#coming-from-the-cli) for what carries over.
Start a session
Before you send your first message, configure four things in the prompt area:
- **Environment**: choose where Claude runs. Select **Local** for your machine, **Remote** for Anthropic-hosted cloud sessions, or an [**SSH connection**](#ssh-sessions) for a remote machine you manage. See [environment configuration](#environment-configuration).
- **Project folder**: select the folder or repository Claude works in. For remote sessions, you can add [multiple repositories](#run-long-running-tasks-remotely).
- **Model**: pick a [model](/docs/en/model-config#available-models) from the dropdown next to the send button. You can change this during the session.
- **Permission mode**: choose how much autonomy Claude has from the [mode selector](#choose-a-permission-mode). You can change this during the session.
Type your task and press **Enter** to start. Each session tracks its own context and changes independently.
Work with code
Give Claude the right context, control how much it does on its own, and review what it changed.
Use the prompt box
Type what you want Claude to do and press **Enter** to send. Claude reads your project files, makes changes, and runs commands based on your [permission mode](#choose-a-permission-mode). You can interrupt Claude at any point: click the stop button or type your correction and press **Enter**. Claude stops what it’s doing and adjusts based on your input. The **+** button next to the prompt box gives you access to file attachments, [skills](#use-skills), [connectors](#connect-external-tools), and [plugins](#install-plugins).
Add files and context to prompts
The prompt box supports two ways to bring in external context:
- **@mention files**: type `@` followed by a filename to add a file to the conversation context. Claude can then read and reference that file. @mention is not available in remote sessions.
- **Attach files**: attach images, PDFs, and other files to your prompt using the attachment button, or drag and drop files directly into the prompt. This is useful for sharing screenshots of bugs, design mockups, or reference documents.
Choose a permission mode
Permission modes control how much autonomy Claude has during a session: whether it asks before editing files, running commands, or both. You can switch modes at any time using the mode selector next to the send button. Start with Ask permissions to see exactly what Claude does, then move to Auto accept edits or Plan mode as you get comfortable.
| Mode | Settings key | Behavior |
|----|----|----|
| **Ask permissions** | `default` | Claude asks before editing files or running commands. You see a diff and can accept or reject each change. Recommended for new users. |
| **Auto accept edits** | `acceptEdits` | Claude auto-accepts file edits and common filesystem commands like `mkdir`, `touch`, and `mv`, but still asks before running other terminal commands. Use this when you trust file changes and want faster iteration. |
| **Plan mode** | `plan` | Claude reads files and runs commands to explore, then proposes a plan without editing your source code. Good for complex tasks where you want to review the approach first. |
| **Auto** | `auto` | Claude executes all actions with background safety checks that verify alignment with your request. Reduces permission prompts while maintaining oversight. Enable in your Settings → Claude Code. See [availability requirements](#auto-mode-availability) below. |
| **Bypass permissions** | `bypassPermissions` | Claude runs without any permission prompts, equivalent to the admin-gated bypass option in the CLI. Enable in your Settings → Claude Code under “Allow bypass permissions mode”. Only use this in sandboxed containers or VMs. Enterprise admins can disable this option. |
The `dontAsk` permission mode is available only in the [CLI](/docs/en/permission-modes#allow-only-pre-approved-tools-with-dontask-mode). Auto mode is a research preview available on Max, Team, Enterprise, and API plans. It is not available on Pro plans or third-party providers. On Team, Enterprise, and API plans it requires Claude Sonnet 4.6, Opus 4.6, or Opus 4.7. On Max plans it requires Claude Opus 4.7.
Start complex tasks in Plan mode so Claude maps out an approach before making changes. Once you approve the plan, switch to Auto accept edits or Ask permissions to execute it. See [explore first, then plan, then code](/docs/en/best-practices#explore-first-then-plan-then-code) for more on this workflow.
Remote sessions support Auto accept edits and Plan mode. Ask permissions is not available because remote sessions auto-accept file edits by default, and Bypass permissions is not available because the remote environment is already sandboxed. Enterprise admins can restrict which permission modes are available. See [enterprise configuration](#enterprise-configuration) for details.
Preview your app
Claude can start a dev server and open an embedded browser to verify its changes. This works for frontend web apps as well as backend servers: Claude can test API endpoints, view server logs, and iterate on issues it finds. In most cases, Claude starts the server automatically after editing project files. You can also ask Claude to preview at any time. By default, Claude [auto-verifies](#auto-verify-changes) changes after every edit. The preview pane can also open static HTML files, PDFs, images, and videos from your project. Click an HTML, PDF, image, or video path in the chat to open it in preview. From the preview pane, you can:
- Interact with your running app directly in the embedded browser
- Watch Claude verify its own changes automatically: it takes screenshots, inspects the DOM, clicks elements, fills forms, and fixes issues it finds
- Start or stop servers from the **Preview** dropdown in the session toolbar
- Persist cookies and local storage across server restarts by selecting **Persist sessions** in the dropdown, so you don’t have to re-login during development
- Edit the server configuration or stop all servers at once
Claude creates the initial server configuration based on your project. If your app uses a custom dev command, edit `.claude/launch.json` to match your setup. See [Configure preview servers](#configure-preview-servers) for the full reference. To clear saved session data, toggle **Persist preview sessions** off in Settings → Claude Code. To disable preview entirely, toggle off **Preview** in Settings → Claude Code.
Review changes with diff view
After Claude makes changes to your code, the diff view lets you review modifications file by file before creating a pull request. When Claude changes files, a diff stats indicator appears showing the number of lines added and removed, such as `+12 -1`. Click this indicator to open the diff viewer, which displays a file list on the left and the changes for each file on the right. To comment on specific lines, click any line in the diff to open a comment box. Type your feedback and press **Enter** to add the comment. After adding comments to multiple lines, submit all comments at once:
- **macOS**: press **Cmd+Enter**
- **Windows**: press **Ctrl+Enter**
Claude reads your comments and makes the requested changes, which appear as a new diff you can review.
Review your code
In the diff view, click **Review code** in the top-right toolbar to ask Claude to evaluate the changes before you commit. Claude examines the current diffs and leaves comments directly in the diff view. You can respond to any comment or ask Claude to revise. The review focuses on high-signal issues: compile errors, definite logic errors, security vulnerabilities, and obvious bugs. It does not flag style, formatting, pre-existing issues, or anything a linter would catch.
Monitor pull request status
After you open a pull request, a CI status bar appears in the session. Claude Code uses the GitHub CLI to poll check results and surface failures.
- **Auto-fix**: when enabled, Claude automatically attempts to fix failing CI checks by reading the failure output and iterating.
- **Auto-merge**: when enabled, Claude merges the PR once all checks pass. The merge method is squash. Auto-merge must be [enabled in your GitHub repository settings](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) for this to work.
Use the **Auto-fix** and **Auto-merge** toggles in the CI status bar to enable either option. Claude Code also sends a desktop notification when CI finishes. To archive the session automatically once the PR merges or closes, turn on [auto-archive](#work-in-parallel-with-sessions) in Settings → Claude Code.
PR monitoring requires the [GitHub CLI (`gh`)](https://cli.github.com/) to be installed and authenticated on your machine. If `gh` is not installed, Desktop prompts you to install it the first time you try to create a PR.
Arrange your workspace
The Code tab is built around panes you can arrange in any layout: chat, diff, preview, terminal, file, plan, tasks, and subagent. Drag a pane by its header to reposition it, or drag a pane edge to resize it. Press **Cmd+\\** on macOS or **Ctrl+\\** on Windows to close the focused pane. Open additional panes from the **Views** menu in the session toolbar.
The pane layout, terminal, file editor, and view modes in this section require Claude Desktop v1.2581.0 or later. Open **Claude → Check for Updates** on macOS or **Help → Check for Updates** on Windows to update.
Run commands in the terminal
The integrated terminal lets you run commands alongside your session without switching to another app. Open it from the **Views** menu or press **Ctrl+\`** on macOS or Windows. The terminal opens in your session’s working directory and shares the same environment as Claude, so commands like `npm test` or `git status` see the same files Claude is editing. The terminal is available in local sessions only.
Open and edit files
Click a file path in the chat or diff viewer to open it in the file pane. HTML, PDF, image, and video paths open in the [preview pane](#preview-your-app) instead. Make spot edits and click **Save** to write them back. If the file changed on disk since you opened it, the pane warns you and lets you override or discard. Click **Discard** to revert your edits, or click the path in the pane header to copy the absolute path. The file pane is available in local and SSH sessions. For remote sessions, ask Claude to make the change.
Open files in other apps
Right-click any file path in the chat, diff viewer, or file pane to open a context menu:
- **Attach as context**: add the file to your next prompt
- **Open in**: open the file in an installed editor such as VS Code, Cursor, or Zed
- **Show in Finder** on macOS, **Show in Explorer** on Windows: open the containing folder
- **Copy path**: copy the absolute path to your clipboard
Switch view modes
View modes control how much detail appears in the chat transcript. Switch modes from the **Transcript view** dropdown next to the send button, or press **Ctrl+O** on macOS or Windows to cycle through them.
| Mode | What it shows |
|----|----|
| **Normal** | Tool calls collapsed into summaries, with full text responses |
| **Verbose** | Every tool call, file read, and intermediate step Claude takes |
| **Summary** | Only Claude’s final responses and the changes it made |
Use Verbose when debugging why Claude took a particular action. Use Summary when you’re running multiple sessions and want to scan results quickly.
Keyboard shortcuts
Press **Cmd+/** on macOS or **Ctrl+/** on Windows to see all shortcuts available in the Code tab. On Windows, use **Ctrl** in place of **Cmd** for the shortcuts below. Session cycling, the terminal toggle, and the view-mode toggle use **Ctrl** on every platform.
| Shortcut | Action |
|---------------------------------------|------------------------------|
| `Cmd` `/` | Show keyboard shortcuts |
| `Cmd` `N` | New session |
| `Cmd` `W` | Close session |
| `Ctrl` `Tab` / `Ctrl` `Shift` `Tab` | Next or previous session |
| `Cmd` `Shift` `]` / `Cmd` `Shift` `[` | Next or previous session |
| `Esc` | Stop Claude’s response |
| `Cmd` `Shift` `D` | Toggle diff pane |
| `Cmd` `Shift` `P` | Toggle preview pane |
| `Cmd` `Shift` `S` | Select an element in preview |
| `Ctrl` `` ` `` | Toggle terminal pane |
| `Cmd` `\` | Close focused pane |
| `Cmd` `;` | Open side chat |
| `Ctrl` `O` | Cycle view modes |
| `Cmd` `Shift` `M` | Open permission mode menu |
| `Cmd` `Shift` `I` | Open model menu |
| `Cmd` `Shift` `E` | Open effort menu |
| `1`–`9` | Select item in an open menu |
These shortcuts apply only to the Code tab. The terminal-based [interactive mode shortcuts](/docs/en/interactive-mode#keyboard-shortcuts), such as `Shift+Tab` to cycle modes, do not apply in Desktop.
Check usage
Click the usage ring next to the model picker to see your current context window usage and your plan usage for the period. Context usage is per session; plan usage is shared across all your Claude Code surfaces.
Let Claude use your computer
Computer use lets Claude open your apps, control your screen, and work directly on your machine the way you would. Ask Claude to test a native app in a mobile simulator, interact with a desktop tool that has no CLI, or automate something that only works through a GUI.
Computer use is a research preview on macOS and Windows that requires a Pro or Max plan. It is not available on Team or Enterprise plans. The Claude Desktop app must be running.
Computer use is off by default. [Enable it in Settings](#enable-computer-use) before Claude can control your screen. On macOS, you also need to grant Accessibility and Screen Recording permissions.
Unlike the [sandboxed Bash tool](/docs/en/sandboxing), computer use runs on your actual desktop with access to whatever you approve. Claude checks each action and flags potential prompt injection from on-screen content, but the trust boundary is different. See the [computer use safety guide](https://support.claude.com/en/articles/14128542) for best practices.
When computer use applies
Claude has several ways to interact with an app or service, and computer use is the broadest and slowest. It tries the most precise tool first:
- If you have a [connector](#connect-external-tools) for a service, Claude uses the connector.
- If the task is a shell command, Claude uses Bash.
- If the task is browser work and you have [Claude in Chrome](/docs/en/chrome) set up, Claude uses that.
- If none of those apply, Claude uses computer use.
The [per-app access tiers](#app-permissions) reinforce this: browsers are capped at view-only, and terminals and IDEs at click-only, steering Claude toward the dedicated tool even when computer use is active. Screen control is reserved for things nothing else can reach, like native apps, hardware control panels, mobile simulators, or proprietary tools without an API.
Enable computer use
Computer use is off by default. If you ask Claude to do something that needs it while it’s off, Claude tells you it could do the task if you enable computer use in Settings.
1
Update the desktop app
Make sure you have the latest version of Claude Desktop. Download or update at [claude.com/download](https://claude.com/download), then restart the app.
2
Turn on the toggle
In the desktop app, go to **Settings \> General** (under **Desktop app**). Find the **Computer use** toggle and turn it on. On Windows, the toggle takes effect immediately and setup is complete. On macOS, continue to the next step.If you don’t see the toggle, confirm you’re on macOS or Windows with a Pro or Max plan, then update and restart the app.
3
Grant macOS permissions
On macOS, grant two system permissions before the toggle takes effect:
- **Accessibility**: lets Claude click, type, and scroll
- **Screen Recording**: lets Claude see what’s on your screen
The Settings page shows the current status of each permission. If either is denied, click the badge to open the relevant System Settings pane.
App permissions
The first time Claude needs to use an app, a prompt appears in your session. Click **Allow for this session** or **Deny**. Approvals last for the current session, or 30 minutes in [Dispatch-spawned sessions](#sessions-from-dispatch). The prompt also shows what level of control Claude gets for that app. These tiers are fixed by app category and can’t be changed:
| Tier | What Claude can do | Applies to |
|:---|:---|:---|
| View only | See the app in screenshots | Browsers, trading platforms |
| Click only | Click and scroll, but not type or use keyboard shortcuts | Terminals, IDEs |
| Full control | Click, type, drag, and use keyboard shortcuts | Everything else |
Apps with broad reach, like terminals, Finder or File Explorer, and System Settings or Settings, show an extra warning in the prompt so you know what approving them grants. You can configure two settings in **Settings \> General** (under **Desktop app**):
- **Denied apps**: add apps here to reject them without prompting. Claude may still affect a denied app indirectly through actions in an allowed app, but it can’t interact with the denied app directly.
- **Unhide apps when Claude finishes**: while Claude is working, your other windows are hidden so it interacts with only the approved app. When Claude finishes, hidden windows are restored unless you turn this setting off.
Manage sessions
Each session is an independent conversation with its own context and changes. You can run multiple sessions in parallel, branch off side chats, send work to the cloud, or let Dispatch start sessions for you from your phone.
Work in parallel with sessions
Click **+ New session** in the sidebar, or press **Cmd+N** on macOS or **Ctrl+N** on Windows, to work on multiple tasks in parallel. Press **Ctrl+Tab** and **Ctrl+Shift+Tab** to cycle through sessions in the sidebar. For Git repositories, each session gets its own isolated copy of your project using [Git worktrees](/docs/en/common-workflows#run-parallel-claude-code-sessions-with-git-worktrees), so changes in one session don’t affect other sessions until you commit them. Worktrees are stored in `<project-root>/.claude/worktrees/` by default. You can change this to a custom directory in Settings → Claude Code under “Worktree location”. You can also set a branch prefix that gets prepended to every worktree branch name, which is useful for keeping Claude-created branches organized. To remove a worktree when you’re done, hover over the session in the sidebar and click the archive icon. To have sessions archive themselves when their pull request merges or closes, turn on **Auto-archive after PR merge or close** in Settings → Claude Code. Auto-archive only applies to local sessions that have finished running. To include gitignored files like `.env` in new worktrees, create a [`.worktreeinclude` file](/docs/en/common-workflows#copy-gitignored-files-to-worktrees) in your project root.
Session isolation requires [Git](https://git-scm.com/downloads). Most Macs include Git by default. Run `git --version` in Terminal to check. On Windows, Git is required for the Code tab to work: [download Git for Windows](https://git-scm.com/downloads/win), install it, and restart the app. If you run into Git errors, ask Claude in the [Cowork tab](https://claude.com/product/cowork) to help troubleshoot your setup.
Use the controls at the top of the sidebar to filter sessions by status, project, or environment, and to group sessions by project. To rename a session, click the session title in the toolbar at the top of the active session. To check context usage, see [Check usage](#check-usage). When context fills up, Claude automatically summarizes the conversation and continues working. You can also type `/compact` to trigger summarization earlier and free up context space. See [the context window](/docs/en/how-claude-code-works#the-context-window) for details on how compaction works.
Ask a side question without derailing the session
A side chat lets you ask Claude a question that uses your session’s context but doesn’t add anything back to the main conversation. Use it when you want to understand a piece of code, check an assumption, or explore an idea without steering the session off course. Press **Cmd+;** on macOS or **Ctrl+;** on Windows to open a side chat, or type `/btw` in the prompt box. The side chat can read everything in the main thread up to that point. When you’re done, close the side chat and continue the main session where you left off. Side chats are available in local and SSH sessions.
Watch background tasks
The tasks pane shows the background work running inside the current session: subagents, background shell commands, and workflows. Open it from the **Views** menu or drag it into your layout. Click any entry to see its output in the subagent pane or stop it. To see what other sessions are doing, use the [sidebar](#work-in-parallel-with-sessions).
Run long-running tasks remotely
For large refactors, test suites, migrations, or other long-running tasks, select **Remote** instead of **Local** when starting a session. Remote sessions run on Anthropic’s cloud infrastructure and continue even if you close the app or shut down your computer. Check back anytime to see progress or steer Claude in a different direction. You can also monitor remote sessions from [claude.ai/code](https://claude.ai/code) or the Claude iOS app. Remote sessions also support multiple repositories. After selecting a cloud environment, click the **+** button next to the repo pill to add additional repositories to the session. Each repo gets its own branch selector. This is useful for tasks that span multiple codebases, such as updating a shared library and its consumers. See [Claude Code on the web](/docs/en/claude-code-on-the-web) for more on how remote sessions work.
Continue in another surface
The **Continue in** menu, accessible from the VS Code icon in the bottom right of the session toolbar, lets you move your session to another surface:
- **Claude Code on the Web**: sends your local session to continue running remotely. Desktop pushes your branch, generates a summary of the conversation, and creates a new remote session with the full context. You can then choose to archive the local session or keep it. This requires a clean working tree, and is not available for SSH sessions.
- **Your IDE**: opens your project in a supported IDE at the current working directory.
Sessions from Dispatch
[Dispatch](https://support.claude.com/en/articles/13947068) is a persistent conversation with Claude that lives in the [Cowork](https://claude.com/product/cowork#dispatch-and-computer-use) tab. You message Dispatch a task, and it decides how to handle it. A task can end up as a Code session in two ways: you ask for one directly, such as “open a Claude Code session and fix the login bug”, or Dispatch decides the task is development work and spawns one on its own. Tasks that typically route to Code include fixing bugs, updating dependencies, running tests, or opening pull requests. Research, document editing, and spreadsheet work stay in Cowork. Either way, the Code session appears in the Code tab’s sidebar with a **Dispatch** badge. You get a push notification on your phone when it finishes or needs your approval. If you have [computer use](#let-claude-use-your-computer) enabled, Dispatch-spawned Code sessions can use it too. App approvals in those sessions expire after 30 minutes and re-prompt, rather than lasting the full session like regular Code sessions. For setup, pairing, and Dispatch settings, see the [Dispatch help article](https://support.claude.com/en/articles/13947068). Dispatch requires a Pro or Max plan and is not available on Team or Enterprise plans. Dispatch is one of several ways to work with Claude when you’re away from your terminal. See [Platforms and integrations](/docs/en/platforms#work-when-you-are-away-from-your-terminal) to compare it with Remote Control, Channels, Slack, and scheduled tasks.
Extend Claude Code
Connect external services, add reusable workflows, customize Claude’s behavior, and configure preview servers. To manage connectors, skills, and plugins in one place, click **Customize** in the sidebar.
Connect external tools
For local and [SSH](#ssh-sessions) sessions, click the **+** button next to the prompt box and select **Connectors** to add integrations like Google Calendar, Slack, GitHub, Linear, Notion, and more. You can add connectors before or during a session. The **+** button is not available in remote sessions, but [routines](/docs/en/routines) configure connectors at routine creation time. To manage or disconnect connectors, go to Settings → Connectors in the desktop app, or select **Manage connectors** from the Connectors menu in the prompt box. Once connected, Claude can read your calendar, send messages, create issues, and interact with your tools directly. You can ask Claude what connectors are configured in your session. Connectors are [MCP servers](/docs/en/mcp) with a graphical setup flow. Use them for quick integration with supported services. For integrations not listed in Connectors, add MCP servers manually via [settings files](/docs/en/mcp#installing-mcp-servers). You can also [create custom connectors](../14-Connectors/getting-started-with-custom-connectors-using-remote-mcp.md).
Use skills
[Skills](/docs/en/skills) extend what Claude can do. Claude loads them automatically when relevant, or you can invoke one directly: type `/` in the prompt box or click the **+** button and select **Slash commands** to browse what’s available. This includes [built-in commands](/docs/en/commands), your [custom skills](/docs/en/skills#create-your-first-skill), project skills from your codebase, and skills from any [installed plugins](/docs/en/plugins). Select one and it appears highlighted in the input field. Type your task after it and send as usual.
Install plugins
[Plugins](/docs/en/plugins) are reusable packages that add skills, agents, hooks, MCP servers, and LSP configurations to Claude Code. You can install plugins from the desktop app without using the terminal. For local and [SSH](#ssh-sessions) sessions, click the **+** button next to the prompt box and select **Plugins** to see your installed plugins and their skills. To add a plugin, select **Add plugin** from the submenu to open the plugin browser, which shows available plugins from your configured [marketplaces](/docs/en/plugin-marketplaces) including the official Anthropic marketplace. Select **Manage plugins** to enable, disable, or uninstall plugins. Plugins can be scoped to your user account, a specific project, or local-only. If your organization manages plugins centrally, those plugins are available in desktop sessions the same way they are in the CLI. Plugins are not available for remote sessions. For the full plugin reference including creating your own plugins, see [plugins](/docs/en/plugins).
Configure preview servers
Claude automatically detects your dev server setup and stores the configuration in `.claude/launch.json` at the root of the folder you selected when starting the session. Preview uses this folder as its working directory, so if you selected a parent folder, subfolders with their own dev servers won’t be detected automatically. To work with a subfolder’s server, either start a session in that folder directly or add a configuration manually. To customize how your server starts, for example to use `yarn dev` instead of `npm run dev` or to change the port, edit the file manually or click **Edit configuration** in the Preview dropdown to open it in your code editor. The file supports JSON with comments.
```python
{
"version": "0.0.1",
"configurations": [
{
"name": "my-app",
"runtimeExecutable": "npm",
"runtimeArgs": ["run", "dev"],
"port": 3000
}
]
}
```
You can define multiple configurations to run different servers from the same project, such as a frontend and an API. See the [examples](#examples) below.
Auto-verify changes
When `autoVerify` is enabled, Claude automatically verifies code changes after editing files. It takes screenshots, checks for errors, and confirms changes work before completing its response. Auto-verify is on by default. Disable it per-project by adding `"autoVerify": false` to `.claude/launch.json`, or toggle it from the **Preview** dropdown menu.
```python
{
"version": "0.0.1",
"autoVerify": false,
"configurations": [...]
}
```
When disabled, preview tools are still available and you can ask Claude to verify at any time. Auto-verify makes it automatic after every edit.
Configuration fields
Each entry in the `configurations` array accepts the following fields:
| Field | Type | Description |
|----|----|----|
| `name` | string | A unique identifier for this server |
| `runtimeExecutable` | string | The command to run, such as `npm`, `yarn`, or `node` |
| `runtimeArgs` | string\[\] | Arguments passed to `runtimeExecutable`, such as `["run", "dev"]` |
| `port` | number | The port your server listens on. Defaults to 3000 |
| `cwd` | string | Working directory relative to your project root. Defaults to the project root. Use `${workspaceFolder}` to reference the project root explicitly |
| `env` | object | Additional environment variables as key-value pairs, such as `{ "NODE_ENV": "development" }`. Don’t put secrets here since this file is committed to your repo. To pass secrets to your dev server, set them in the [local environment editor](#local-sessions) instead. |
| `autoPort` | boolean | How to handle port conflicts. See below |
| `program` | string | A script to run with `node`. See [when to use `program` vs `runtimeExecutable`](#when-to-use-program-vs-runtimeexecutable) |
| `args` | string\[\] | Arguments passed to `program`. Only used when `program` is set |
##### When to use `program` vs `runtimeExecutable`
Use `runtimeExecutable` with `runtimeArgs` to start a dev server through a package manager. For example, `"runtimeExecutable": "npm"` with `"runtimeArgs": ["run", "dev"]` runs `npm run dev`. Use `program` when you have a standalone script you want to run with `node` directly. For example, `"program": "server.js"` runs `node server.js`. Pass additional flags with `args`.
Port conflicts
The `autoPort` field controls what happens when your preferred port is already in use:
- **`true`**: Claude finds and uses a free port automatically. Suitable for most dev servers.
- **`false`**: Claude fails with an error. Use this when your server must use a specific port, such as for OAuth callbacks or CORS allowlists.
- **Not set (default)**: Claude asks whether the server needs that exact port, then saves your answer.
When Claude picks a different port, it passes the assigned port to your server via the `PORT` environment variable.
Examples
These configurations show common setups for different project types:
- Next.js
- Multiple servers
- Node.js script
This configuration runs a Next.js app using Yarn on port 3000:
```python
{
"version": "0.0.1",
"configurations": [
{
"name": "web",
"runtimeExecutable": "yarn",
"runtimeArgs": ["dev"],
"port": 3000
}
]
}
```
For a monorepo with a frontend and an API server, define multiple configurations. The frontend uses `autoPort: true` so it picks a free port if 3000 is taken, while the API server requires port 8080 exactly:
```python
{
"version": "0.0.1",
"configurations": [
{
"name": "frontend",
"runtimeExecutable": "npm",
"runtimeArgs": ["run", "dev"],
"cwd": "apps/web",
"port": 3000,
"autoPort": true
},
{
"name": "api",
"runtimeExecutable": "npm",
"runtimeArgs": ["run", "start"],
"cwd": "server",
"port": 8080,
"env": { "NODE_ENV": "development" },
"autoPort": false
}
]
}
```
To run a Node.js script directly instead of using a package manager command, use the `program` field:
```python
{
"version": "0.0.1",
"configurations": [
{
"name": "server",
"program": "server.js",
"args": ["--verbose"],
"port": 4000
}
]
}
```
Environment configuration
The environment you pick when [starting a session](#start-a-session) determines where Claude executes and how you connect:
- **Local**: runs on your machine with direct access to your files
- **Remote**: runs on Anthropic’s cloud infrastructure. Sessions continue even if you close the app.
- **SSH**: runs on a remote machine you connect to over SSH, such as your own servers, cloud VMs, or dev containers
Local sessions
The desktop app does not always inherit your full shell environment. On macOS, when you launch the app from the Dock or Finder, it reads your shell profile, such as `~/.zshrc` or `~/.bashrc`, to extract `PATH` and a fixed set of Claude Code variables, but other variables you export there are not picked up. On Windows, the app inherits user and system environment variables but does not read PowerShell profiles. To set environment variables for local sessions and dev servers on any platform, open the environment dropdown in the prompt box, hover over **Local**, and click the gear icon to open the local environment editor. Variables you save here are stored encrypted on your machine and apply to every local session and preview server you start. You can also add variables to the `env` key in your `~/.claude/settings.json` file, though these reach Claude sessions only and not dev servers. See [environment variables](/docs/en/env-vars) for the full list of supported variables. [Extended thinking](/docs/en/common-workflows#use-extended-thinking-thinking-mode) is enabled by default, which improves performance on complex reasoning tasks but uses additional tokens. To disable thinking entirely, set `MAX_THINKING_TOKENS` to `0` in the local environment editor. On models with [adaptive reasoning](/docs/en/model-config#adjust-effort-level), any other `MAX_THINKING_TOKENS` value is ignored because adaptive reasoning controls thinking depth instead. On Opus 4.6 and Sonnet 4.6, set `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` to `1` to use a fixed thinking budget; Opus 4.7 always uses adaptive reasoning and has no fixed-budget mode.
Remote sessions
Remote sessions continue in the background even if you close the app. Usage counts toward your [subscription plan limits](/docs/en/costs) with no separate compute charges. You can create custom cloud environments with different network access levels and environment variables. Select the environment dropdown when starting a remote session and choose **Add environment**. See [the cloud environment](/docs/en/claude-code-on-the-web#the-cloud-environment) for details on configuring network access and environment variables.
SSH sessions
SSH sessions let you run Claude Code on a remote machine while using the desktop app as your interface. This is useful for working with codebases that live on cloud VMs, dev containers, or servers with specific hardware or dependencies. To add an SSH connection, click the environment dropdown before starting a session and select **+ Add SSH connection**. The dialog asks for:
- **Name**: a friendly label for this connection
- **SSH Host**: `user@hostname` or a host defined in `~/.ssh/config`
- **SSH Port**: defaults to 22 if left empty, or uses the port from your SSH config
- **Identity File**: path to your private key, such as `~/.ssh/id_rsa`. Leave empty to use the default key or your SSH config.
Once added, the connection appears in the environment dropdown. Select it to start a session on that machine. Claude runs on the remote machine with access to its files and tools. The remote machine must run Linux or macOS. Desktop installs Claude Code on the remote machine automatically the first time you connect. Once connected, SSH sessions support permission modes, connectors, plugins, and MCP servers.
Pre-configure SSH connections for your team
Administrators can distribute SSH connections to team members by adding `sshConfigs` to a [managed settings](/docs/en/settings#settings-precedence) file. Connections defined this way appear in each user’s environment dropdown automatically and are shown as managed, so users can select them but cannot edit or delete them in the app. The following example pre-configures a single connection that opens in `~/projects` on the remote host:
```python
{
"sshConfigs": [
{
"id": "shared-dev-vm",
"name": "Shared Dev VM",
"sshHost": "user@dev.example.com",
"sshPort": 22,
"sshIdentityFile": "~/.ssh/id_ed25519",
"startDirectory": "~/projects"
}
]
}
```
Each entry requires `id`, `name`, and `sshHost`. The `sshPort`, `sshIdentityFile`, and `startDirectory` fields are optional. Users can also add `sshConfigs` to their own `~/.claude/settings.json`, which is where connections added through the dialog are stored.
Enterprise configuration
Organizations on Team or Enterprise plans can manage desktop app behavior through admin console controls, managed settings files, and device management policies.
Admin console controls
These settings are configured through the [admin settings console](https://claude.ai/admin-settings/claude-code):
- **Code in the desktop**: control whether users in your organization can access Claude Code in the desktop app
- **Code in the web**: enable or disable [web sessions](/docs/en/claude-code-on-the-web) for your organization
- **Remote Control**: enable or disable [Remote Control](/docs/en/remote-control) for your organization
- **Disable Bypass permissions mode**: prevent users in your organization from enabling bypass permissions mode
Managed settings
Managed settings override project and user settings and apply when Desktop spawns CLI sessions. You can set these keys in your organization’s [managed settings](/docs/en/settings#settings-precedence) file or push them remotely through the admin console.
| Key | Description |
|----|----|
| `permissions.disableBypassPermissionsMode` | set to `"disable"` to prevent users from enabling Bypass permissions mode. |
| `disableAutoMode` | set to `"disable"` to prevent users from enabling [Auto](/docs/en/permission-modes#eliminate-prompts-with-auto-mode) mode. Removes Auto from the mode selector. Also accepted under `permissions`. |
| `autoMode` | customize what the auto mode classifier trusts and blocks across your organization. See [Configure auto mode](/docs/en/auto-mode-config). |
| `sshConfigs` | pre-configure [SSH connections](#pre-configure-ssh-connections-for-your-team) that appear in the environment dropdown. Users cannot edit or delete managed connections. |
A managed settings file deployed to disk on each machine applies to Desktop sessions. Managed settings pushed remotely through the admin console currently reach CLI and IDE sessions only, so for Desktop deployments either distribute the file via MDM or use the [admin console controls](#admin-console-controls) above. `permissions.disableBypassPermissionsMode` and `disableAutoMode` also work in user and project settings, but placing them in managed settings prevents users from overriding them. `autoMode` is read from user settings, `.claude/settings.local.json`, and managed settings, but not from the checked-in `.claude/settings.json`: a cloned repo cannot inject its own classifier rules. For the complete list of managed-only settings including `allowManagedPermissionRulesOnly` and `allowManagedHooksOnly`, see [managed-only settings](/docs/en/permissions#managed-only-settings).
Device management policies
IT teams can manage the desktop app through MDM on macOS or group policy on Windows. Available policies include enabling or disabling the Claude Code feature, controlling auto-updates, and setting a custom deployment URL.
- **macOS**: configure via `com.anthropic.Claude` preference domain using tools like Jamf or Kandji
- **Windows**: configure via registry at `SOFTWARE\Policies\Claude`
Authentication and SSO
Enterprise organizations can require SSO for all users. See [authentication](/docs/en/authentication) for plan-level details and [Setting up SSO](../21-Account-Support/setting-up-single-sign-on-sso.md) for SAML and OIDC configuration.
Data handling
Claude Code processes your code locally in local sessions or on Anthropic’s cloud infrastructure in remote sessions. Conversations and code context are sent to Anthropic’s API for processing. See [data handling](/docs/en/data-usage) for details on data retention, privacy, and compliance.
Deployment
Desktop can be distributed through enterprise deployment tools:
- **macOS**: distribute via MDM such as Jamf or Kandji using the `.dmg` installer
- **Windows**: deploy via MSIX package or `.exe` installer. See [Deploy Claude Desktop for Windows](https://support.claude.com/en/articles/12622703-deploy-claude-desktop-for-windows) for enterprise deployment options including silent installation
For network configuration such as proxy settings, firewall allowlisting, and LLM gateways, see [network configuration](/docs/en/network-config). For the full enterprise configuration reference, see the [enterprise configuration guide](../13-Enterprise-Admin/enterprise-configuration.md).
Coming from the CLI?
If you already use the Claude Code CLI, Desktop runs the same underlying engine with a graphical interface. You can run both simultaneously on the same machine, even on the same project. Each maintains separate session history, but they share configuration and project memory via CLAUDE.md files. To move a CLI session into Desktop, run `/desktop` in the terminal. Claude saves your session and opens it in the desktop app, then exits the CLI. This command is available on macOS and Windows only.
When to use Desktop vs CLI: use Desktop when you want to manage parallel sessions in one window, arrange panes side by side, or review changes visually. Use the CLI when you need scripting, automation, or prefer a terminal workflow.
CLI flag equivalents
This table shows the desktop app equivalent for common CLI flags. Flags not listed have no desktop equivalent because they are designed for scripting or automation.
| CLI | Desktop equivalent |
|----|----|
| `--model sonnet` | Model dropdown next to the send button |
| `--resume`, `--continue` | Click a session in the sidebar |
| `--permission-mode` | Mode selector next to the send button |
| `--dangerously-skip-permissions` | Bypass permissions mode. Enable in Settings → Claude Code → “Allow bypass permissions mode”. Enterprise admins can disable this setting. |
| `--add-dir` | Add multiple repos with the **+** button in remote sessions |
| `--allowedTools`, `--disallowedTools` | No per-session equivalent. Permission rules in [settings files](/docs/en/settings) still apply. |
| `--verbose` | [Verbose view mode](#switch-view-modes) in the Transcript view dropdown |
| `--print`, `--output-format` | Not available. Desktop is interactive only. |
| `ANTHROPIC_MODEL` env var | Model dropdown next to the send button |
| `MAX_THINKING_TOKENS` env var | Set in the local environment editor. See [environment configuration](#environment-configuration). |
Shared configuration
Desktop and CLI read the same configuration files, so your setup carries over:
- **[CLAUDE.md](/docs/en/memory)** and `CLAUDE.local.md` files in your project are used by both
- **[MCP servers](/docs/en/mcp)** configured in `~/.claude.json` or `.mcp.json` work in both
- **[Hooks](/docs/en/hooks)** and **[skills](/docs/en/skills)** defined in settings apply to both
- **[Settings](/docs/en/settings)** in `~/.claude.json` and `~/.claude/settings.json` are shared. Permission rules, allowed tools, and other settings in `settings.json` apply to Desktop sessions.
- **Models**: Sonnet, Opus, and Haiku are available in both. In Desktop, select the model from the dropdown next to the send button. You can change the model mid-session from the same dropdown.
**MCP servers: desktop chat app vs Claude Code**: MCP servers configured for the Claude Desktop chat app in `claude_desktop_config.json` are separate from Claude Code and will not appear in the Code tab. To use MCP servers in Claude Code, configure them in `~/.claude.json` or your project’s `.mcp.json` file. See [MCP configuration](/docs/en/mcp#installing-mcp-servers) for details.
Feature comparison
This table compares core capabilities between the CLI and Desktop. For a full list of CLI flags, see the [CLI reference](/docs/en/cli-reference).
| Feature | CLI | Desktop |
|----|----|----|
| Permission modes | All modes including `dontAsk` | Ask permissions, Auto accept edits, Plan mode, Auto, and Bypass permissions via Settings |
| `--dangerously-skip-permissions` | CLI flag | Bypass permissions mode. Enable in Settings → Claude Code → “Allow bypass permissions mode” |
| [Third-party providers](/docs/en/third-party-integrations) | Bedrock, Vertex, Foundry | Anthropic’s API by default. Enterprise deployments can configure Vertex AI and gateway providers. See the [enterprise configuration guide](../13-Enterprise-Admin/enterprise-configuration.md). |
| [MCP servers](/docs/en/mcp) | Configure in settings files | Connectors UI for local and SSH sessions, or settings files |
| [Plugins](/docs/en/plugins) | `/plugin` command | Plugin manager UI |
| @mention files | Text-based | With autocomplete; local and SSH sessions only |
| File attachments | Not available | Images, PDFs |
| Session isolation | [`--worktree`](/docs/en/cli-reference) flag | Automatic worktrees |
| Multiple sessions | Separate terminals | Sidebar tabs |
| Recurring tasks | Cron jobs, CI pipelines | [Scheduled tasks](/docs/en/desktop-scheduled-tasks) |
| Computer use | [Enable via `/mcp`](/docs/en/computer-use) on macOS | [App and screen control](#let-claude-use-your-computer) on macOS and Windows |
| Dispatch integration | Not available | [Dispatch sessions](#sessions-from-dispatch) in the sidebar |
| Scripting and automation | [`--print`](/docs/en/cli-reference), [Agent SDK](/docs/en/headless) | Not available |
What’s not available in Desktop
The following features are only available in the CLI or VS Code extension:
- **Third-party providers**: Desktop connects to Anthropic’s API by default. Enterprise deployments can configure Vertex AI and gateway providers via [managed settings](../13-Enterprise-Admin/enterprise-configuration.md). For Bedrock or Foundry, use the [CLI](/docs/en/quickstart).
- **Linux**: the desktop app is available on macOS and Windows only.
- **Inline code suggestions**: Desktop does not provide autocomplete-style suggestions. It works through conversational prompts and explicit code changes.
- **Agent teams**: multi-agent orchestration is available via the [CLI](/docs/en/agent-teams) and [Agent SDK](/docs/en/headless), not in Desktop.
Troubleshooting
The sections below cover issues specific to the desktop app. For runtime API errors that appear in the chat such as `API Error: 500`, `529 Overloaded`, `429`, or `Prompt is too long`, see the [Error reference](/docs/en/errors). Those errors and their fixes are the same across the CLI, desktop, and web.
Check your version
To see which version of the desktop app you’re running:
- **macOS**: click **Claude** in the menu bar, then **About Claude**
- **Windows**: click **Help**, then **About**
Click the version number to copy it to your clipboard.
403 or authentication errors in the Code tab
If you see `Error 403: Forbidden` or other authentication failures when using the Code tab:
1. Sign out and back in from the app menu. This is the most common fix.
2. Verify you have an active paid subscription: Pro, Max, Team, or Enterprise.
3. If the CLI works but Desktop does not, quit the desktop app completely, not just close the window, then reopen and sign in again.
4. Check your internet connection and proxy settings.
Blank or stuck screen on launch
If the app opens but shows a blank or unresponsive screen:
1. Restart the app.
2. Check for pending updates. The app auto-updates on launch.
3. On Windows, check Event Viewer for crash logs under **Windows Logs → Application**.
”Failed to load session”
If you see `Failed to load session`, the selected folder may no longer exist, a Git repository may require Git LFS that isn’t installed, or file permissions may prevent access. Try selecting a different folder or restarting the app.
Session not finding installed tools
If Claude can’t find tools like `npm`, `node`, or other CLI commands, verify the tools work in your regular terminal, check that your shell profile properly sets up PATH, and restart the desktop app to reload environment variables.
Git and Git LFS errors
On Windows, Git is required for the Code tab to start local sessions. If you see “Git is required,” install [Git for Windows](https://git-scm.com/downloads/win) and restart the app. If you see “Git LFS is required by this repository but is not installed,” install Git LFS from [git-lfs.com](https://git-lfs.com/), run `git lfs install`, and restart the app.
MCP servers not working on Windows
If MCP server toggles don’t respond or servers fail to connect on Windows, check that the server is properly configured in your settings, restart the app, verify the server process is running in Task Manager, and review server logs for connection errors.
App won’t quit
- **macOS**: press Cmd+Q. If the app doesn’t respond, use Force Quit with Cmd+Option+Esc, select Claude, and click Force Quit.
- **Windows**: use Task Manager with Ctrl+Shift+Esc to end the Claude process.
Windows-specific issues
- **PATH not updated after install**: open a new terminal window. PATH updates only apply to new terminal sessions.
- **Concurrent installation error**: if you see an error about another installation in progress but there isn’t one, try running the installer as Administrator.
”Branch doesn’t exist yet” when opening in CLI
Remote sessions can create branches that don’t exist on your local machine. Click the branch name in the session toolbar to copy it, then fetch it locally:
```python
git fetch origin <branch-name>
git checkout <branch-name>
```
Still stuck?
- Search or file a bug on [GitHub Issues](https://github.com/anthropics/claude-code/issues)
- Visit the [Claude support center](https://support.claude.com/)
When filing a bug, include your desktop app version, your operating system, the exact error message, and relevant logs. On macOS, check Console.app. On Windows, check Event Viewer → Windows Logs → Application.
---
## use-claude-cowork-on-web-desktop-and-mobile-4a801ac42a.md
# Use Claude Cowork on web, desktop, and mobile
Copy for LLM
**Note:** Claude Cowork is now just Claude. Ask for what you need, and Claude decides whether that's a quick answer or a task. This is rolling out gradually to Pro and Max plans, with more plans to follow. If you're on a Pro or Max plan and your message box no longer shows "Chat" and "Cowork" options, you have the new experience, and some steps in this article may look different. Learn more in **[Claude Cowork and chat are one Claude](https://support.claude.com/en/articles/16761823)**, or read our **[blog post](https://claude.com/blog/cowork-is-now-claude)**.
Claude Cowork is available on desktop, web, mobile, and in the Claude in Chrome side panel. Your sessions and files live with your Claude account and go where you go, on any device. This article explains how to start a Cowork session and what's available on each surface.
Claude Cowork is in beta on web and mobile for Pro, Max, and Team plans, and on Enterprise plans where an admin has enabled it. Cowork is also available in the Claude in Chrome side panel on Max and Team plans, on Pro plans as it rolls out, and on Enterprise plans where an admin has enabled it. See **[Claude in Chrome admin controls](https://support.claude.com/en/articles/13065128-claude-in-chrome-admin-controls#h_bdb63199e1)** for enablement steps.
------------------------------------------------------------------------
## Start a Cowork session
On desktop, web, and mobile, chat and Cowork share one home, so you start both from the same place. Find the message box, select "Cowork" in the bottom left corner, then describe your task. To go back to a regular conversation, select "Chat."
If you have the new Claude experience, there's no "Cowork" option to select. Describe your task in any conversation, and Claude takes it from there.
The Chrome side panel works differently. Opening the side panel starts a Cowork session directly, with no selector to switch between chat and Cowork.
- **Web:** Go to **[claude.ai](https://claude.ai)** and find the “Home” tab.
- **Mobile:** Open the latest version of Claude for iOS or Claude for Android. If you don't see the Cowork option in the message box, update the app.
- **Desktop:** Open the latest version of the Claude Desktop app. If you don't see the Cowork option in the message box, update the app. Desktop is the full Cowork experience, where Claude can also use your local files and browser.
- **Chrome:** Click the Claude icon in your Chrome toolbar to open the side panel. The side panel starts a Cowork session, so there's no need to select "Cowork" first.
------------------------------------------------------------------------
## How Cowork in the cloud works
When using Cowork in the cloud, Claude's work runs on Anthropic's servers instead of your computer, and your sessions and files are saved to your Claude account. This changes what Cowork can do:
- Work continues in the background. Close your laptop and Claude keeps going.
- Scheduled tasks run with no device online.
- The same sessions and files are available on desktop, web, and mobile.
- Sessions run in the cloud on every surface.
For details on how cloud and local sessions are isolated and what each can access, see **[Claude Cowork architecture overview](https://support.claude.com/en/articles/14479288)**. For safety guidance, see **[Use Claude Cowork safely](https://support.claude.com/en/articles/13364135)**.
------------------------------------------------------------------------
## What's available on each surface
Cowork in the cloud is in beta, and some features aren’t available yet. Here's what you can use on each surface today:
[TABLE]
A few notes on the table:
- \*Local file access, local connectors, browser use, and computer use from web and mobile work through the Claude Desktop app. A cloud session can read and write files in folders you've connected on your computer only while the desktop app is open on that computer and the session was started on desktop. If the app is closed, the session keeps running but can't reach your local files.
- Projects are available on every surface. From a project you can start a chat or a Cowork session, and Claude uses the project's knowledge as context. Projects tied to a local folder support Cowork sessions on desktop only, and Cowork won't change a project's contents, so add anything you want to keep to the project yourself. For more information, see **[Organize your tasks with projects in Claude Cowork](https://support.claude.com/en/articles/14116274)** and **[Use live artifacts in Claude Cowork](https://support.claude.com/en/articles/14729249)**.
- Artifacts created on or after August 19, 2026 are available on the desktop app and web. Live artifacts created before that date are available on the desktop app only. For more information, see **[Use artifacts in Claude Cowork](https://support.claude.com/en/articles/14729249)**.
- Local connectors and plugins that include local MCP servers work through the desktop app only.
- Scheduled tasks run in the cloud, so they no longer need your computer to be awake. For more information, see **[Schedule recurring tasks in Claude Cowork](https://support.claude.com/en/articles/13854387)**.
- Computer use is in beta for Pro and Max plans. For more information, see **[Let Claude use your computer in Cowork](https://support.claude.com/en/articles/14128542)**.
## What requires the desktop app
Some capabilities reach things on your computer, so they need the Claude Desktop app open on your machine, even when your session runs in the cloud:
- **Local file access.** Claude reads and writes files in folders you've connected on your computer. A session in the cloud reaches these files only while the desktop app is open, only for folders you've connected, and with the permissions you've already set.
- **Local connectors.** This includes plugins using those connectors.
- **Browser use.** On desktop, Claude uses a browser built into the Claude Desktop app by default (rolling out gradually this week), or your own Chrome browser through Claude in Chrome if that's your preferred browser. When the desktop app is online, the built-in browser is also available in Cowork on web or mobile. A session started on desktop can be steered from web or mobile while the desktop app stays open. In the Chrome side panel, Claude can read the tab you're on without the desktop app. Claude driving a browser as part of a task still needs the desktop app open. Learn more in **[Use the built-in browser in Claude Cowork](https://support.claude.com/en/articles/16607400)**.
- **Computer use.** Claude clicks, types, and navigates your screen directly.
## Move between surfaces
When using Cowork in the cloud, sessions follow your account, so you can switch surfaces mid-task:
1. Start a task on any surface.
2. Open the same session from another surface to check progress, answer Claude's questions, or redirect the work.
3. Pick up the finished output wherever you are.
For example, start a task in the Chrome side panel while you're looking at a dashboard, then pick it up on desktop to work with the downloaded files.
When Claude finishes a task or needs your input, you'll get a notification on your phone. To get started, see **[Get started with Claude Cowork](https://support.claude.com/en/articles/13345190)**.
---
## use-claude-with-android-apps-1d0faa1a99.md
# Use Claude with Android apps
August 25, 2026
Copy for LLM
Claude can now connect with your Android device's system apps to help you take action directly from your conversations. When you chat with Claude, it can draft messages, emails, calendar events, set alarms and timers, find locations, and more—all through your everyday apps without copy-paste.
This feature is supported on all Claude plans and works with your device's native and third-party apps, including messaging, email, calendar, alarms, timers, location services, maps, and Health Connect (in beta on Pro and Max plans only).
## What can Claude do with Android apps?
Claude can help you:
- **Draft and send messages** through your default messaging app or third-party apps (e.g. WhatsApp, Slack, Messenger).
- **Compose emails** that open directly in your Android device's email app with content pre-filled.
- **Access your location** to provide contextual suggestions for nearby places and services.
- **Display locations on maps** and help you navigate to restaurants, stores, and other destinations.
- **Read and manage your calendar** to check availability, create events, and schedule meetings.
- **Set alarms** directly through your Clock app.
- **Set timers** directly for cooking, workouts, or any activity.
- **Read and analyze your health data** through Health Connect to help you understand fitness patterns, track progress toward goals, and visualize trends with native charts.
### Limitations
- **Location:** Members of Team or Enterprise plans can’t access the location tool at this time.
- **Calendar:** Ability to edit events depends on your ownership of the event.
- **Reminders:** These are exclusively available on Claude for iOS, so Claude can’t create and manage reminders on Android.
- **Contacts:** Claude does not have direct access to your contacts.
- **Health:** Available on Pro and Max plans only. Requires Android 14 or later and Health Connect. Currently limited to users in the US. Claude can read health data but cannot write or modify entries in Health Connect.
------------------------------------------------------------------------
## How Claude helps you take action
When Claude determines that using one of these features would be helpful, it will automatically offer to help. You'll see a card or prompt within your conversation that lets you review and take action with Claude’s help.
### Send texts and emails with Messages and Mail
1. Ask Claude to help draft a message or email (for example: "Draft an email to my supervisor about the project update").
2. Claude will prepare the content and show you a preview.
3. Tap the message card to open your messaging or email app.
4. Review the pre-filled content and make any changes if needed.
5. Send the message as you normally would.
**Example:** "Draft a message to my study group about canceling tonight's session."
### Use location for contextual suggestions
1. Ask Claude for location-based recommendations (for example: "What restaurants are near me?").
2. Claude will request access to your location if not already granted.
3. Based on your location, Claude provides relevant suggestions.
4. You can view locations on a map and get navigation directions.
**Example:** "Find nearby parks for jogging."
### Display locations with Maps
1. When Claude suggests locations, they can be displayed on an interactive map.
2. Tap on any location to see more details.
3. Select a location to open it in Google Maps for navigation.
4. Get turn-by-turn directions directly from the map.
**Example:** "Show me hardware stores within five miles on a map."
### Manage your calendar
1. Ask Claude to check your schedule or create events.
2. Claude will request calendar access if not already granted.
3. For checking availability: Claude reads your calendar and identifies free slots.
4. For creating events: Claude prepares event details and adds them to your calendar.
5. You can edit or delete events as needed.
**Examples:**
- "What meetings do I have tomorrow?"
- "Schedule a team lunch for next Thursday at noon."
- "Create a recurring workout session every Tuesday and Thursday at 6 AM."
### Set alarms and timers using Clock apps
1. Ask Claude to set an alarm or timer.
2. Claude will automatically create the alarm or start the timer.
3. Your device's Clock app will handle the alarm or timer.
4. You'll receive notifications as normal when the alarm goes off or timer ends.
**Examples:**
- "Set an alarm for 7 AM tomorrow."
- "Start a 20-minute timer for my workout."
------------------------------------------------------------------------
## Access and analyze your health data
**Note:** Health features are available in beta on Pro and Max plans only, require Android 14 or later, and are limited to users in the US.
Claude can read your health and fitness data from Health Connect to help you understand patterns, track progress, and make informed decisions about your wellbeing. When you ask Claude about your health data, it can display insights using native charts that feel integrated with Android.
**Important:** We are not a medical device and cannot provide medical guidance. Always consult a licensed professional.
### What is Health Connect?
Health Connect is Android's centralized platform for health and fitness data. It aggregates information from various fitness apps and wearables (like Fitbit, Samsung Health, and Google Fit) into a single, secure location. Claude accesses your health data through Health Connect, which means it can see data from any app you've connected to Health Connect.
If you haven't set up Health Connect yet, you can find it in your device settings or download it from the Google Play Store.
### What health data can Claude access?
With your permission, Claude can read the following types of data from Health Connect:
- **Activity metrics:** Steps, distance, floors climbed, active calories, and exercise duration
- **Workouts:** Type (running, cycling, strength training, etc.), duration, distance, heart rate data, and calories burned
- **Vitals:** Heart rate, resting heart rate, heart rate variability (HRV), blood pressure, respiratory rate, and blood oxygen
- **Body measurements:** Weight, height, body mass index, and body fat percentage
- **Sleep:** Total sleep time, sleep stages, and time in bed
- **Nutrition:** Calories consumed, macronutrients, hydration, and micronutrients (if tracked)
**Note:** By default, Claude doesn't save health information to memory. If you turn on **Include sensitive topics in memory**, Claude may remember health-related context from your conversations. Learn more about **[sensitive topics in memory](https://support.claude.com/en/articles/11817273-use-claude-s-chat-search-and-memory-to-build-on-previous-context#h_6fe1d0e66f)**.
### How to use health features
1. Ask Claude a question about your health or fitness data (for example: "How active have I been this week?" or "Show me my sleep trends").
2. Claude will request access to your health data through Health Connect if not already granted.
3. Review the permission prompt and select the data types you want to share.
4. Claude analyzes your data and provides insights, often with visual charts to help you understand trends.
### Example prompts
- "Help me understand my workout patterns over the past month."
- "I've been sleeping poorly—can you analyze my sleep data and look for patterns?"
- "Show me how my daily step count compares week over week."
- "What's my average resting heart rate, and how has it changed recently?"
- "Create a summary of my fitness activity for the past 30 days."
### Understanding health visualizations
Claude displays health insights using native Android charts that appear directly in your conversation. These charts can show:
- **Bar charts** for comparing activity across days or weeks
- **Line charts** for tracking trends over time (pace, heart rate, weight)
- **Progress indicators** for goals and milestones
Tap on chart elements to see more details about specific data points.
## Usage guidelines for optimal results
Be specific about what type of action you want Claude to take and include all relevant details like recipients, dates, times, and durations in your request. For alarms, specify AM/PM and any recurring days you need. For timers, mention what the timer is for to help with labeling. Always review content in the destination app before sending or saving.
------------------------------------------------------------------------
## What data can Claude access?
Claude only accesses the data necessary for each specific request:
- **Location:** Current location only when relevant to your request.
- **Calendar:** Event details to check availability and create/modify events.
- **Messages/Email:** Claude does not read existing messages or emails, only creates new content.
- **Alarms and timers:** Created directly without accessing personal data.
- **Health:** Activity, workout, vital signs, body measurements, sleep, and nutrition data from Health Connect — only when you ask a question that requires this information and have granted permission.
Claude's connection to your Android apps works through your device's standard sharing system and intent system—the same secure methods used by all Android apps.
## Do I need to grant permissions to Claude for Android?
Permission requirements vary by feature:
- **Messages and Email:** No permissions required (uses Android's sharing system).
- **Calendar Events:** Claude needs your permission to read your calendar and view events, but can write to your calendar or draft calendar events using just the system UI (no permissions required).
- **Location and Maps:** Permission required when Claude needs to access your location.
- **Alarms and Timers:** Uses your device's standard alarm and timer functions.
- **Health Connect:** Permission required. Claude will request access to specific health data categories when needed.
For features requiring permissions (like location or calendar access), Claude will request permission contextually with clear explanations of why the access is needed. You’ll be prompted to approve the action with three options: Allow once, Always allow, or Don't allow.
These permissions can be managed at any time in your device settings by going to Settings \> Apps \> Claude \> Permissions. Click into each permission listed under **Allowed** and **Not allowed** to make changes. You can toggle between “Allow only while using the app” or “Ask every time” to change Claude’s access, or remove permissions by choosing “Don’t allow.” Claude will only request permissions if needed for specific features, and you can always choose to decline while still using other capabilities.
Health Connect permissions are managed separately from other app permissions. When Claude requests health access, you'll see the Health Connect permissions screen where you can choose exactly which data types to share. You can modify these permissions at any time by going to Settings \> Apps \> Health Connect \> App permissions \> Claude.
------------------------------------------------------------------------
## Troubleshooting
### Claude isn't offering to use my apps
- Make sure you're using the latest version of Claude for Android. For instructions, see **[How to update Claude for Android](https://support.claude.com/en/articles/11825394-how-to-update-claude-for-android)**.
- Try being more specific about wanting to send a message, create an event, or set a timer (see examples above).
- Restart Claude for Android and try again.
### Permission prompts don't appear
- Check that the app for which Claude needs permissions is installed and set up on your phone.
- Navigate to Settings \> Apps \> Claude to verify that Claude for Android has the required permissions.
- Ensure your Android OS is up to date.
### Sharing options don't appear for messages or emails
- Check that you have messaging and email apps installed and set up.
- Try clearing the Claude for Android cache in your device settings:
- Navigate to your app settings and select "Claude" from the list.
- Select "Storage & cache."
- Tap "Clear cache."
### Calendar events aren't opening correctly
- Verify you have a calendar app installed.
- Check that your preferred calendar app is set as the default for calendar events.
- Make sure the calendar app you’re trying to use is up to date.
### Alarms or timers aren't being created
- Ensure your device's Clock app is enabled and up to date.
- Check that "Do Not Disturb" settings aren't preventing alarms.
### Content appears different than expected
- Your Android mobile apps may format content slightly differently than Claude.
- You can always edit the content in the destination app before sending or saving.
- Some features may vary depending on your specific Android version and device manufacturer.
### Health data isn't appearing or seems incomplete
- Verify that you have a Pro or Max plan and are located in the US.
- Ensure you're running Android 14 or later.
- Check that Health Connect is installed and that your fitness apps are connected to it.
- Verify that you've granted Claude access to the relevant health data types in Settings \> Apps \> Health Connect \> App permissions \> Claude.
- If you recently started using Health Connect, there may not be enough historical data for trend analysis.
- Some data types require a compatible wearable device (like a Fitbit or Samsung Galaxy Watch).
- Health Connect isn’t supported when using work profiles on Android devices.
**Need more help?** If you're experiencing issues with these features, try restarting Claude for Android or **[updating the app to the latest version from the Google Play Store](https://support.claude.com/en/articles/11825394-how-to-update-claude-for-android)**.
---
## use-claude-with-ios-apps-e63f1651a1.md
# Use Claude with iOS apps
August 25, 2026
Copy for LLM
Claude can now connect with your iOS device's system apps to help you take action directly from your conversations. When you chat with Claude, it can draft messages, emails, or calendar events, find locations, manage reminders, and analyze your health and fitness data — all seamlessly integrated with your mobile apps.
This feature is supported on all Claude plans and works with iOS system apps (Messages, Mail, Calendar, Maps, Reminders, and Location Services), as well as compatible third-party apps. Health features are currently in beta, require a Pro or Max plan, and are available in the US only.
## What can Claude do with iOS apps?
Claude can help you:
- **Draft and send messages** through the Messages app or any messaging platform like WhatsApp, Slack, or Messenger.
- **Compose emails** that open directly in the Mail app or any other email platform like Gmail or Outlook with the subject and content pre-filled.
- **Access your location** to provide contextual suggestions for nearby places and services.
- **Display locations on maps** and help you navigate to restaurants, stores, and other destinations.
- **Read and manage your calendar** to check availability, create events, and schedule meetings.
- **Create and manage reminders** to help you stay organized with tasks and lists.
- **Read and analyze your health data** to help you understand fitness patterns, track progress toward goals, and visualize trends with native charts (Pro and Max plans only).
### Limitations
- **Location:** Members of Team or Enterprise plans can’t access the location tool at this time.
- **Calendar:** Ability to edit events depends on your ownership of the event.
- **Reminders:** Claude cannot create or edit reminder lists themselves, only items within existing lists.
- **Contacts:** Claude does not have direct access to your contacts.
- **Health:** Available in beta on Pro and Max plans only. Currently limited to users in the US. Claude can read health data but cannot write or modify entries in Apple Health.
------------------------------------------------------------------------
## How Claude helps you take action
When Claude determines that using one of these features would be helpful, it will automatically suggest it. You'll see a card or prompt within your conversation that lets you review and take action with Claude’s help.
### Send texts and emails with Messages and Mail
1. Ask Claude to help draft a message or email (for example: "Help me write a text to my team about tomorrow's meeting").
2. Claude will prepare the message and show you a preview.
3. Tap the message card to open your Messages app or Mail app.
1. Third-party apps (WhatsApp, Messenger, Signal) are also supported.
4. Review the pre-filled content and make any changes if needed.
5. Send the message as you normally would.
**Example:** "Draft an email to my manager explaining that I'll be late to the morning meeting due to a doctor's appointment."
### Use location for contextual suggestions
1. Ask Claude for location-based recommendations (for example: "What's nearby for dinner?").
2. Claude will request access to your location if not already granted.
3. Based on your location, Claude provides relevant suggestions.
4. You can view locations on a map and get navigation directions.
**Example:** "Find good restaurants near me that are open now."
### Display locations with Maps
1. When Claude suggests locations, they can be displayed on an interactive map.
2. Tap on any location to see more details.
3. Select a location to open it in Apple Maps for navigation.
4. Get turn-by-turn directions directly from the map.
**Example:** "Show me coffee shops within walking distance on a map."
### Manage your calendar
1. Ask Claude to check your schedule or create events.
2. Claude will request calendar access if not already granted.
3. For checking availability: Claude reads your calendar and identifies free slots.
4. For creating events: Claude prepares event details and adds them to your calendar.
5. You can edit or delete events as needed.
**Examples:**
- "When am I free this week for a 30-minute meeting?"
- "Schedule a dentist appointment for next Friday at 10 AM."
- "Add a weekly team standup every Monday at 9 AM."
### Create and manage reminders
1. Ask Claude to create reminders or add items to lists.
2. Claude will request Reminders access if not already granted.
3. Claude can add items to existing lists or create new reminders.
4. Set due dates, priorities, and notes for reminders.
5. Manage recurring reminders for regular tasks.
**Examples:**
- "Add milk and eggs to my grocery list."
- "Remind me to call the dentist tomorrow at 2 PM."
- "Create a packing list for my trip next week."
Note that when Claude uses tools to take these actions, their use is preserved in the conversation history in the same way as any tool.
------------------------------------------------------------------------
## Access and analyze your health data
**Note:** Health features are available in beta on Pro and Max plans only, and currently limited to users in the US.
Claude can read your health and fitness data from Apple Health to help you understand patterns, track progress, and make informed decisions about your wellbeing. When you ask Claude about your health data, it can display insights using native charts that feel integrated with iOS.
**Important:** We are not a medical device and cannot provide medical guidance. Always consult a licensed professional.
### What health data can Claude access?
With your permission, Claude can read the following types of data from Apple Health:
- **Activity metrics:** Steps, distance, flights climbed, active calories, exercise minutes, move and stand hours.
- **Workouts:** Type (running, cycling, strength, yoga, etc.), duration, distance, heart rate data, and calories burned.
- **Vitals:** Heart rate, resting heart rate, heart rate variability (HRV), blood pressure, respiratory rate, and blood oxygen.
- **Body measurements:** Weight, height, body mass index, and body fat percentage.
- **Sleep:** Total sleep time, sleep stages, time in bed, and sleep efficiency.
- **Nutrition:** Calories consumed, macronutrients, water intake, and micronutrients (if tracked).
**Note:** By default, Claude doesn't save health information to memory. If you turn on **Include sensitive topics in memory**, Claude may remember health-related context from your conversations. Learn more about **[sensitive topics in memory](https://support.claude.com/en/articles/11817273-use-claude-s-chat-search-and-memory-to-build-on-previous-context#h_6fe1d0e66f)**.
### How to use health features
1. Ask Claude a question about your health or fitness data (for example: "How have my runs been trending this month?" or "Show me my sleep patterns over the past two weeks").
2. Claude will request access to your health data if not already granted.
3. Review the permission prompt and select your preferred option.
4. Claude analyzes your data and provides insights, often with visual charts to help you understand trends.
### Example prompts
- "Help me create a training plan for my upcoming half-marathon based on my recent running data."
- "Why have I been feeling tired lately? Can you look at my sleep and activity data?"
- "Show me how my resting heart rate has changed over the past three months."
- "Compare my workout consistency this month versus last month."
- "What patterns do you see in my step count throughout the week?"
### Understanding health visualizations
Claude displays health insights using native iOS charts that appear directly in your conversation. These charts can show:
- **Bar charts** for comparing activity across days or weeks.
- **Line charts** for tracking trends over time (pace, heart rate, weight)
- **Progress indicators** for goals and milestones
Tap on chart elements to see more details about specific data points.
## Usage guidelines for optimal results
To get the best results, be specific about what you want, include relevant details like dates, times, and locations in your requests, and review content before sending or saving. Claude understands natural language, so you can make requests conversationally.
------------------------------------------------------------------------
## What data can Claude access?
Claude only accesses the data necessary for each specific request:
- **Location:** Current location only when relevant to your request.
- **Calendar:** Event details to check availability and create/modify events.
- **Messages/Email:** Claude does not read existing messages or emails, only creates new content.
- **Reminders:** Existing lists and items to add/manage tasks.
- **Health:** Activity, workout, vital signs, body measurements, sleep, and nutrition data — only when you ask a question that requires this information and have granted permission.
Claude's connection to your iOS apps works through your device's built-in sharing and permission systems—the same secure methods you use with any iPhone app.
## Do I need to grant permission to Claude for iOS?
Permission requirements vary by feature:
- **Messages and Email:** No permissions required (uses your device’s built-in sharing system).
- **Calendar Events:** Permission required for reading calendar; writing can use system UI without permission.
- **Location and Maps:** Permission required when Claude needs to access your location.
- **Reminders:** Prompted when Claude needs to access reminder lists.
- **Health:** Permission required. Claude will request access to specific health data categories when needed.
For features requiring permissions (like location or calendar access), Claude will request permission contextually with clear explanations of why the access is needed. You’ll be prompted to approve the action with three options: Allow once, Always allow, or Don't allow.
These permissions can be managed at any time in your device settings by going to Settings \> Claude. You'll see all available permissions like Location, Calendar, and Reminders and can tap on each permission to adjust access levels. You can toggle between "While Using App” and “Ask next time” to change Claude’s access, or remove permissions by choosing “Never.”
Health permissions work differently from other app permissions. When Claude requests health access, you'll see the standard iOS Health permissions screen where you can choose exactly which data types to share. You can modify these permissions at any time by going to Settings \> Health \> Data Access & Devices \> Claude.
Claude will only request permissions if needed for specific features, and you can always choose to decline while still using other capabilities.
------------------------------------------------------------------------
## Troubleshooting
### Claude isn't offering to use my apps
- Make sure you're using the latest version of the Claude iOS app. For instructions, see **[How to update Claude for iOS](https://support.claude.com/en/articles/11825384-).**
- Try being more specific in your request (refer to the examples listed above).
- Restart Claude for iOS and try again.
### Permission prompts don't appear
- Check that the app for which Claude needs permissions is installed and set up on your phone.
- Verify iOS system permissions by navigating to Settings \> Privacy & Security.
- Ensure Claude for iOS has the necessary permissions enabled.
### Features aren't working as expected
- Your iOS mobile apps may format content slightly differently than Claude.
- You can always edit the content in the destination app before sending or saving.
- Some features may vary based on your iOS version.
### Calendar events aren't opening correctly
- Verify you have a calendar app installed.
- Check that your preferred calendar app is set as the default for calendar events.
- Make sure the calendar app you’re trying to use is up to date.
### Health data isn't appearing or seems incomplete
- Verify that you have a Pro or Max plan and are located in the US.
- Check that you've granted Claude access to the relevant health data types in Settings \> Health \> Data Access & Devices \> Claude.
- Ensure your health data is being recorded. Some data types require an Apple Watch or compatible device.
- If you recently started tracking a metric, there may not be enough historical data for trend analysis.
- Try asking about a specific data type to confirm which categories Claude can access.
**Need more help?** If you're experiencing issues with these features, try restarting Claude for iOS or **[updating to the latest version from the App Store](https://support.claude.com/en/articles/11825384-)**.
---
## use-dictation-on-claude-mobile-9ab4d7a3d8.md
# Use dictation on Claude Mobile
July 23, 2026
Copy for LLM
Dictation is available to all Claude users (Free, Pro, Max, Team, and Enterprise plans). Support for languages other than English is in beta.
Dictation allows you to speak your prompts instead of typing them when using Claude for iOS or Android.
**Note:** Dictation is different from voice mode. Dictation turns your speech into text so you can send a written prompt, and Claude replies in text. Voice mode is a full spoken conversation—you talk to Claude and Claude talks back, and it can use your connected tools. Learn more about **[voice mode](https://support.claude.com/en/articles/11101966-use-voice-mode)**.
## Get started with dictation
1. Open Claude for iOS or Android.
2. Start a new chat with Claude.
3. Tap the microphone icon on the right side of the chat input field.
- If this is your first time using dictation, you'll need to select your preferred language. You can change this later in Settings.
4. Dictate your prompt.
5. Tap the arrow icon to send your prompt.
- To cancel without sending, tap the "X" icon.
Your prompt will automatically appear as text in the chat window. Claude will respond to your prompt in text format.
## Supported languages
Dictation is currently available in these languages:
- English
- French
- German
- Hindi
- Italian
- Japanese
- Korean
- Portuguese
- Russian
- Spanish
- Turkish
- Ukrainian
## Change your language settings
To change your speech input language:
1. Tap your initials in the upper right corner.
2. Select “Speech Input Language.”
3. Choose your preferred language from the dropdown.
## Data privacy
After converting your speech input to text, we will delete your audio recording. We will not retain a copy of your speech input or use it for training our generative models.
Learn more about our privacy practices by visiting our **[Privacy Policy](https://www.anthropic.com/legal/privacy)** and **[Privacy Center](https://privacy.anthropic.com/en/)**.
---
## use-quick-entry-with-claude-desktop-on-mac-9e4d19fd68.md
# Use quick entry with Claude Desktop on Mac
March 16, 2026
Copy for LLM
Quick entry is a redesigned experience for Claude Desktop on Mac that lets you access Claude instantly from anywhere on your computer. With quick entry, you can start chats, capture screenshots, share application windows, and use voice dictation to interact with Claude without navigating away from your current task.
Quick entry is available to all Claude users (free, Pro, Max, Team, and Enterprise plans) using Claude Desktop on macOS.
## Key features
Quick entry includes three main capabilities:
- **Instant access**: Double-tap the Option key to open Claude from any app.
- **Visual context**: Capture screenshots or click application windows to share what you're working on.
- **Voice input**: Press Caps Lock to dictate your message to Claude with real-time transcription.
## System requirements
To use quick entry, you need:
- macOS 12 or later for quick entry features
- macOS 14 or later for voice dictation
- Claude Desktop installed and running (can be in the background)
## Setting up quick entry
When you first open the updated version of Claude Desktop, you'll see a prompt to enable quick entry shortcuts.
### Enable the chat shortcut
1. Check the box for **Turn on shortcut** in the quick entry prompt.
2. Click "Continue."
3. Double-tap the Option key to test the shortcut.
4. Moving forward, manage this in Settings \> General (under **Desktop app**).
Once enabled, double-tapping Option will open a text box where you can type your message and start a new chat. You can also click "New chat" to see your five most recent conversations.
### Enable the voice shortcut (optional)
The voice dictation shortcut is disabled by default because it takes over your Caps Lock key.
To enable voice dictation:
1. Check the box for **Turn on shortcut** in the voice dictation prompt.
2. Click "Continue."
3. Press Caps Lock once to start dictating.
4. Press Caps Lock again when you're finished speaking.
5. Click the arrow to send your transcribed message to Claude.
6. Moving forward, manage this in Settings \> General (under **Desktop app**).
## Using quick entry
### Start a quick conversation
1. Double-tap the Option key from any application.
2. Type your message in the text box that appears.
3. Click the arrow icon or press Enter to send your message to Claude.
### Capture a screenshot
1. Open quick entry by double-tapping the Option key.
2. A "Drag to take a screenshot" prompt will appear by your cursor.
3. Click and drag to select the area of your screen you want to screenshot.
4. The screenshot will be attached to your message to Claude.
### Share an application window
1. Open quick entry by double-tapping the Option key.
2. Click an application window to attach its contents to your message.
3. Add any additional context or questions.
4. Send your message to Claude.
### Use voice dictation
1. Press Caps Lock to start dictating (if enabled).
2. Speak your message—you'll see your words transcribed in real-time.
3. Press Caps Lock again to stop dictating.
4. Review your transcribed message.
5. Click the arrow to send it to Claude.
## Customizing shortcuts
You can customize quick entry shortcuts in your Claude Desktop settings.
1. Open Claude Desktop.
2. Go to Settings \> General (under **Desktop app**).
3. Choose from the following next to **Quick access shortcut**:
- Double-tap Option (default)
- Option + Space
- Custom keyboard shortcut
4. Click the dropdown next to **Voice shortcut** to:
- Enable Caps Lock for voice input
- Set a custom keyboard shortcut
- Disable the shortcut entirely
## Permissions
Quick entry requires certain macOS permissions to function:
- **Screen recording**: Required to capture screenshots and share application windows.
- **Accessibility**: Required for quick entry functionality.
- **Speech recognition**: Required for voice dictation (macOS 14+ only).
You can review or change these permissions in System Settings \> Privacy & Security.
## Common use cases
Quick entry is designed for moments when you need Claude's help without breaking your flow:
- **Code review**: Share error messages or application windows directly with Claude for debugging assistance.
- **Quick answers**: Get instant assistance from Claude without switching away from your current task.
- **Research and writing**: Capture screenshots while browsing and ask contextual questions.
- **Brainstorming**: Use voice dictation for hands-free ideation while thinking or moving around.
## FAQ
### Do I need to keep Claude Desktop open to use quick entry?
Yes. Claude Desktop needs to be running on your Mac, but it can run in the background. You don't need to have the Claude window visible.
### Can I use quick entry on Windows?
No. Quick entry is currently only available for macOS users. Windows users can still access Claude Desktop, but without the quick entry features.
### Is my voice recorded when I use dictation?
Voice dictation transcribes your speech to text in real-time. The transcribed text is sent to Claude as part of your message, just like any other text input.
### Can I disable quick entry after enabling it?
Yes. You can disable quick entry shortcuts at any time in Settings \> General \> Desktop App. You can turn off the quick access shortcut, voice shortcut, or both.
### What if the shortcuts conflict with other apps?
You can customize the quick access shortcut to use Option + Space or create a custom keyboard shortcut that doesn't conflict with your other applications. The voice shortcut can only use Caps Lock or be disabled.
---
## use-the-claude-widget-on-android-3f91f6a413.md
# Use the Claude widget on Android
July 9, 2026
Copy for LLM
The Claude Android widget is available on Android 8.0 Oreo and above.
The Claude Android widget provides quick and convenient access to core features directly from your home screen, allowing you to start new chats, capture images, and use voice dictation with a single tap.
## Add the Claude widget
The Claude widget puts Claude's key features right on your home screen. To add it:
1. Touch and hold an empty area on your home screen
2. Tap "Widgets"
3. Find and tap "Claude"
4. Drag the widget to your desired location
5. Release to place it
6. Optional: Drag the edges of the widget to resize it
## Widget features
The widget offers three quick-access buttons:
- A primary chat button (with Claude's spark icon) to start a new conversation
- A camera button for capturing and sharing images with Claude
- A microphone button for voice dictation
## Use the widget
### Start a chat
Tap the main chat button (with the spark icon) to instantly start a new conversation with Claude.
### Take photos
Tap the camera button to start a new chat and immediately open your camera. You can capture an image and share it with Claude for analysis.
### Voice dictation
Tap the microphone button to start a new chat and begin voice dictation. The first time you use this feature, you'll see a brief explanation about how automatic recording works. You may also need to grant voice permissions if you haven't already done so.
**Note:** All interactions started through the widget will count toward your usage limit.
---
## using-claude-app-intents-shortcuts-and-widgets-on-ios-0865e1e5bc.md
# Use Claude app intents, shortcuts, and widgets on iOS
July 9, 2026
Copy for LLM
The features described in this guide are available on iOS 18 and above.
Claude for iOS supports multiple powerful features: the Claude widget, the "Analyze Photo with Claude" control, the "Ask Claude" App Intent, and the ability to use this intent within iOS Shortcuts. This guide will explain these features and show you how to make the most of them.
## Ask Claude intent
The "Ask Claude" intent is a standalone feature that lets you interact with Claude directly from:
- Spotlight search
- Siri
- The Share menu
- Any app that supports iOS intents
You can use this intent on its own to quickly ask Claude questions or give it tasks without opening the Claude app. For example, you can:
- Select text and use the Share menu to send it directly to Claude
- Ask Siri to "Ask Claude” and it will prompt you for a message
- Type "Ask Claude" in Spotlight search to quickly send a query
## Use Ask Claude with shortcuts
While the "Ask Claude" intent is powerful on its own, you can also use it as a building block within the Shortcuts app to create more complex workflows. Shortcuts allow you to:
- Chain multiple "Ask Claude" actions together
- Combine Claude's capabilities with other apps and actions
- Create automated workflows
- Process Claude's responses in various ways
## Create your first Claude shortcut
There are many customizable workflows you can set up within the Shortcuts app. Let's look at an example of a brief but useful shortcut that helps you summarize text:
1. Open the Shortcuts app on your iOS device
2. Tap the "+" button to create a new shortcut
3. Add the "Share" action and select your preferred input type
4. Add the "Ask Claude" action
5. In the "Ask Claude" action, create a prompt like: "Please summarize the following text: \[Shortcut Input\]"
6. Name your shortcut (e.g., "Summarize with Claude")
7. Optional: Add the shortcut to your Share Sheet for easy access
Now you can select text anywhere in iOS, tap the Share button, and choose your "Summarize with Claude" shortcut to get an instant summary.
When using "Ask Claude" intent and in shortcuts, the default model you see when opening the Claude app will be used.
More information on setting up shortcuts on your iOS device can be found [here](https://support.apple.com/guide/shortcuts/welcome/ios).
**Note:** When using the "Ask Claude" intent, messages to Claude will count towards your overall usage limit.
## Add the Claude Widget
The Claude widget provides quick access to chat and voice features directly from your Home Screen or Today View. The widget includes buttons for:
- Starting a new chat
- Instantly opening the app in dictation mode
- Taking a photo to share with Claude
### Add the Claude widget to your Home Screen
1. From the Home Screen, touch and hold a widget or an empty area until the apps jiggle
2. Tap Edit in the upper-left corner
3. Tap Add Widget
4. Search for and select Claude
5. Tap Add Widget
6. Tap Done
### Add the Claude widget to your Today View
Swipe right from the Home Screen or Lock Screen, then follow the same steps as adding to the Home Screen.
### Use the widget
- Tap the chat button to start a new conversation with Claude.
- Tap the microphone button to instantly open the app in dictation mode, allowing you to start speaking to Claude right away.
- Tap the camera button to take a photo and share it with Claude for analysis.
**Note:** Like the "Ask Claude" intent, interactions started through the widget will count toward your usage limit.
## The Analyze Photo with Claude control
The "Analyze Photo with Claude" control lets you quickly send images to Claude for analysis directly from Control Center or your Lock Screen.
### Add to Control Center
1. Open Control Center (swipe down from the top-right corner on iPhones with Face ID, or swipe up from the bottom on iPhones with a Home button)
2. Tap the Add button (plus sign) at the top left of Control Center to begin editing
3. Tap "Add a Control" at the bottom of the screen to open the controls gallery
4. Find and tap "Analyze Photo with Claude" to add it to Control Center
5. You can rearrange its position by dragging it to your preferred location
6. When finished, close Control Center by swiping up from the bottom center of the screen
Once added, you can quickly access it from Control Center by swiping down from the top-right corner of the screen.
More information on using and setting up controls via Control Center can be found [here](https://support.apple.com/guide/iphone/use-and-customize-control-center-iph59095ec58/ios).
### Add to your lock screen
1. On your Lock Screen, touch and hold until the customization screen appears
2. Tap "Customize"
3. Select the lock screen you want to modify
4. Remove one of the controls at the bottom of the screen using the Remove button (minus sign), then tap the Add button (plus sign) to open the controls gallery
5. From the available controls menu, scroll or search for "Analyze Photo with Claude"
6. Tap to select it
7. Tap "Done" to save your changes
You can now quickly access the "Analyze Photo with Claude" control without needing to unlock your device or open the Claude app first.
---
## using-claude-app-intents-shortcuts-and-widgets-on-ios.md
4. Using Claude App Intents, Shortcuts, and Widgets on iOS
# Using Claude App Intents, Shortcuts, and Widgets on iOS
The features described in this guide are available on iOS 18 and above.
Claude for iOS supports multiple powerful features: the Claude widget, the "Analyze Photo with Claude" control, the "Ask Claude" App Intent, and the ability to use this intent within iOS Shortcuts. This guide will explain these features and show you how to make the most of them.
## Ask Claude Intent
The "Ask Claude" intent is a standalone feature that lets you interact with Claude directly from:
- Spotlight search
- Siri
- The Share menu
- Any app that supports iOS intents
You can use this intent on its own to quickly ask Claude questions or give it tasks without opening the Claude app. For example, you can:
- Select text and use the Share menu to send it directly to Claude
- Ask Siri to "Ask Claude” and it will prompt you for a message
- Type "Ask Claude" in Spotlight search to quickly send a query
## Using Ask Claude With Shortcuts
While the "Ask Claude" intent is powerful on its own, you can also use it as a building block within the Shortcuts app to create more complex workflows. Shortcuts allow you to:
- Chain multiple "Ask Claude" actions together
- Combine Claude's capabilities with other apps and actions
- Create automated workflows
- Process Claude's responses in various ways
## Creating Your First Claude Shortcut
There are many customizable workflows you can set up within the Shortcuts app. Let's look at an example of a brief but useful shortcut that helps you summarize text:
1. Open the Shortcuts app on your iOS device
2. Tap the "+" button to create a new shortcut
3. Add the "Share" action and select your preferred input type
4. Add the "Ask Claude" action
5. In the "Ask Claude" action, create a prompt like: "Please summarize the following text: \[Shortcut Input\]"
6. Name your shortcut (e.g., "Summarize with Claude")
7. Optional: Add the shortcut to your Share Sheet for easy access
Now you can select text anywhere in iOS, tap the Share button, and choose your "Summarize with Claude" shortcut to get an instant summary.
When using "Ask Claude" intent and in shortcuts, the default model you see when opening the Claude app will be used.
More information on setting up shortcuts on your iOS device can be found [here](https://support.apple.com/guide/shortcuts/welcome/ios).
**Note:** When using the "Ask Claude" intent, messages to Claude will count towards your overall usage limit.
## Adding the Claude Widget
The Claude widget provides quick access to chat and voice features directly from your Home Screen or Today View. The widget includes buttons for:
- Starting a new chat
- Instantly opening the app in dictation mode
- Taking a photo to share with Claude
### Add the Claude widget to your Home Screen
1. From the Home Screen, touch and hold a widget or an empty area until the apps jiggle
2. Tap Edit in the upper-left corner
3. Tap Add Widget
4. Search for and select Claude
5. Tap Add Widget
6. Tap Done
### To add the Claude widget to your Today View
Swipe right from the Home Screen or Lock Screen, then follow the same steps as adding to the Home Screen.
### Using the Widget
- Tap the chat button to start a new conversation with Claude.
- Tap the microphone button to instantly open the app in dictation mode, allowing you to start speaking to Claude right away.
- Tap the camera button to take a photo and share it with Claude for analysis.
**Note:** Like the "Ask Claude" intent, interactions started through the widget will count toward your usage limit.
## The Analyze Photo with Claude Control
The "Analyze Photo with Claude" control lets you quickly send images to Claude for analysis directly from Control Center or your Lock Screen.
### Adding to Control Center
1. Open Control Center (swipe down from the top-right corner on iPhones with Face ID, or swipe up from the bottom on iPhones with a Home button)
2. Tap the Add button (plus sign) at the top left of Control Center to begin editing
3. Tap "Add a Control" at the bottom of the screen to open the controls gallery
4. Find and tap "Analyze Photo with Claude" to add it to Control Center
5. You can rearrange its position by dragging it to your preferred location
6. When finished, close Control Center by swiping up from the bottom center of the screen
Once added, you can quickly access it from Control Center by swiping down from the top-right corner of the screen.
More information on using and setting up controls via Control Center can be found [here](https://support.apple.com/guide/iphone/use-and-customize-control-center-iph59095ec58/ios).
### Adding to Your Lock Screen
1. On your Lock Screen, touch and hold until the customization screen appears
2. Tap "Customize"
3. Select the lock screen you want to modify
4. Remove one of the controls at the bottom of the screen using the Remove button (minus sign), then tap the Add button (plus sign) to open the controls gallery
5. From the available controls menu, scroll or search for "Analyze Photo with Claude"
6. Tap to select it
7. Tap "Done" to save your changes
You can now quickly access the "Analyze Photo with Claude" control without needing to unlock your device or open the Claude app first.
---
## using-claude-with-android-apps-d6ed10f7b1.md
# Use Claude with Android apps
August 25, 2026
Copy for LLM
Claude can now connect with your Android device's system apps to help you take action directly from your conversations. When you chat with Claude, it can draft messages, emails, calendar events, set alarms and timers, find locations, and more—all through your everyday apps without copy-paste.
This feature is supported on all Claude plans and works with your device's native and third-party apps, including messaging, email, calendar, alarms, timers, location services, maps, and Health Connect (in beta on Pro and Max plans only).
## What can Claude do with Android apps?
Claude can help you:
- **Draft and send messages** through your default messaging app or third-party apps (e.g. WhatsApp, Slack, Messenger).
- **Compose emails** that open directly in your Android device's email app with content pre-filled.
- **Access your location** to provide contextual suggestions for nearby places and services.
- **Display locations on maps** and help you navigate to restaurants, stores, and other destinations.
- **Read and manage your calendar** to check availability, create events, and schedule meetings.
- **Set alarms** directly through your Clock app.
- **Set timers** directly for cooking, workouts, or any activity.
- **Read and analyze your health data** through Health Connect to help you understand fitness patterns, track progress toward goals, and visualize trends with native charts.
### Limitations
- **Location:** Members of Team or Enterprise plans can’t access the location tool at this time.
- **Calendar:** Ability to edit events depends on your ownership of the event.
- **Reminders:** These are exclusively available on Claude for iOS, so Claude can’t create and manage reminders on Android.
- **Contacts:** Claude does not have direct access to your contacts.
- **Health:** Available on Pro and Max plans only. Requires Android 14 or later and Health Connect. Currently limited to users in the US. Claude can read health data but cannot write or modify entries in Health Connect.
------------------------------------------------------------------------
## How Claude helps you take action
When Claude determines that using one of these features would be helpful, it will automatically offer to help. You'll see a card or prompt within your conversation that lets you review and take action with Claude’s help.
### Send texts and emails with Messages and Mail
1. Ask Claude to help draft a message or email (for example: "Draft an email to my supervisor about the project update").
2. Claude will prepare the content and show you a preview.
3. Tap the message card to open your messaging or email app.
4. Review the pre-filled content and make any changes if needed.
5. Send the message as you normally would.
**Example:** "Draft a message to my study group about canceling tonight's session."
### Use location for contextual suggestions
1. Ask Claude for location-based recommendations (for example: "What restaurants are near me?").
2. Claude will request access to your location if not already granted.
3. Based on your location, Claude provides relevant suggestions.
4. You can view locations on a map and get navigation directions.
**Example:** "Find nearby parks for jogging."
### Display locations with Maps
1. When Claude suggests locations, they can be displayed on an interactive map.
2. Tap on any location to see more details.
3. Select a location to open it in Google Maps for navigation.
4. Get turn-by-turn directions directly from the map.
**Example:** "Show me hardware stores within five miles on a map."
### Manage your calendar
1. Ask Claude to check your schedule or create events.
2. Claude will request calendar access if not already granted.
3. For checking availability: Claude reads your calendar and identifies free slots.
4. For creating events: Claude prepares event details and adds them to your calendar.
5. You can edit or delete events as needed.
**Examples:**
- "What meetings do I have tomorrow?"
- "Schedule a team lunch for next Thursday at noon."
- "Create a recurring workout session every Tuesday and Thursday at 6 AM."
### Set alarms and timers using Clock apps
1. Ask Claude to set an alarm or timer.
2. Claude will automatically create the alarm or start the timer.
3. Your device's Clock app will handle the alarm or timer.
4. You'll receive notifications as normal when the alarm goes off or timer ends.
**Examples:**
- "Set an alarm for 7 AM tomorrow."
- "Start a 20-minute timer for my workout."
------------------------------------------------------------------------
## Access and analyze your health data
**Note:** Health features are available in beta on Pro and Max plans only, require Android 14 or later, and are limited to users in the US.
Claude can read your health and fitness data from Health Connect to help you understand patterns, track progress, and make informed decisions about your wellbeing. When you ask Claude about your health data, it can display insights using native charts that feel integrated with Android.
**Important:** We are not a medical device and cannot provide medical guidance. Always consult a licensed professional.
### What is Health Connect?
Health Connect is Android's centralized platform for health and fitness data. It aggregates information from various fitness apps and wearables (like Fitbit, Samsung Health, and Google Fit) into a single, secure location. Claude accesses your health data through Health Connect, which means it can see data from any app you've connected to Health Connect.
If you haven't set up Health Connect yet, you can find it in your device settings or download it from the Google Play Store.
### What health data can Claude access?
With your permission, Claude can read the following types of data from Health Connect:
- **Activity metrics:** Steps, distance, floors climbed, active calories, and exercise duration
- **Workouts:** Type (running, cycling, strength training, etc.), duration, distance, heart rate data, and calories burned
- **Vitals:** Heart rate, resting heart rate, heart rate variability (HRV), blood pressure, respiratory rate, and blood oxygen
- **Body measurements:** Weight, height, body mass index, and body fat percentage
- **Sleep:** Total sleep time, sleep stages, and time in bed
- **Nutrition:** Calories consumed, macronutrients, hydration, and micronutrients (if tracked)
**Note:** By default, Claude doesn't save health information to memory. If you turn on **Include sensitive topics in memory**, Claude may remember health-related context from your conversations. Learn more about **[sensitive topics in memory](https://support.claude.com/en/articles/11817273-use-claude-s-chat-search-and-memory-to-build-on-previous-context#h_6fe1d0e66f)**.
### How to use health features
1. Ask Claude a question about your health or fitness data (for example: "How active have I been this week?" or "Show me my sleep trends").
2. Claude will request access to your health data through Health Connect if not already granted.
3. Review the permission prompt and select the data types you want to share.
4. Claude analyzes your data and provides insights, often with visual charts to help you understand trends.
### Example prompts
- "Help me understand my workout patterns over the past month."
- "I've been sleeping poorly—can you analyze my sleep data and look for patterns?"
- "Show me how my daily step count compares week over week."
- "What's my average resting heart rate, and how has it changed recently?"
- "Create a summary of my fitness activity for the past 30 days."
### Understanding health visualizations
Claude displays health insights using native Android charts that appear directly in your conversation. These charts can show:
- **Bar charts** for comparing activity across days or weeks
- **Line charts** for tracking trends over time (pace, heart rate, weight)
- **Progress indicators** for goals and milestones
Tap on chart elements to see more details about specific data points.
## Usage guidelines for optimal results
Be specific about what type of action you want Claude to take and include all relevant details like recipients, dates, times, and durations in your request. For alarms, specify AM/PM and any recurring days you need. For timers, mention what the timer is for to help with labeling. Always review content in the destination app before sending or saving.
------------------------------------------------------------------------
## What data can Claude access?
Claude only accesses the data necessary for each specific request:
- **Location:** Current location only when relevant to your request.
- **Calendar:** Event details to check availability and create/modify events.
- **Messages/Email:** Claude does not read existing messages or emails, only creates new content.
- **Alarms and timers:** Created directly without accessing personal data.
- **Health:** Activity, workout, vital signs, body measurements, sleep, and nutrition data from Health Connect — only when you ask a question that requires this information and have granted permission.
Claude's connection to your Android apps works through your device's standard sharing system and intent system—the same secure methods used by all Android apps.
## Do I need to grant permissions to Claude for Android?
Permission requirements vary by feature:
- **Messages and Email:** No permissions required (uses Android's sharing system).
- **Calendar Events:** Claude needs your permission to read your calendar and view events, but can write to your calendar or draft calendar events using just the system UI (no permissions required).
- **Location and Maps:** Permission required when Claude needs to access your location.
- **Alarms and Timers:** Uses your device's standard alarm and timer functions.
- **Health Connect:** Permission required. Claude will request access to specific health data categories when needed.
For features requiring permissions (like location or calendar access), Claude will request permission contextually with clear explanations of why the access is needed. You’ll be prompted to approve the action with three options: Allow once, Always allow, or Don't allow.
These permissions can be managed at any time in your device settings by going to Settings \> Apps \> Claude \> Permissions. Click into each permission listed under **Allowed** and **Not allowed** to make changes. You can toggle between “Allow only while using the app” or “Ask every time” to change Claude’s access, or remove permissions by choosing “Don’t allow.” Claude will only request permissions if needed for specific features, and you can always choose to decline while still using other capabilities.
Health Connect permissions are managed separately from other app permissions. When Claude requests health access, you'll see the Health Connect permissions screen where you can choose exactly which data types to share. You can modify these permissions at any time by going to Settings \> Apps \> Health Connect \> App permissions \> Claude.
------------------------------------------------------------------------
## Troubleshooting
### Claude isn't offering to use my apps
- Make sure you're using the latest version of Claude for Android. For instructions, see **[How to update Claude for Android](https://support.claude.com/en/articles/11825394-how-to-update-claude-for-android)**.
- Try being more specific about wanting to send a message, create an event, or set a timer (see examples above).
- Restart Claude for Android and try again.
### Permission prompts don't appear
- Check that the app for which Claude needs permissions is installed and set up on your phone.
- Navigate to Settings \> Apps \> Claude to verify that Claude for Android has the required permissions.
- Ensure your Android OS is up to date.
### Sharing options don't appear for messages or emails
- Check that you have messaging and email apps installed and set up.
- Try clearing the Claude for Android cache in your device settings:
- Navigate to your app settings and select "Claude" from the list.
- Select "Storage & cache."
- Tap "Clear cache."
### Calendar events aren't opening correctly
- Verify you have a calendar app installed.
- Check that your preferred calendar app is set as the default for calendar events.
- Make sure the calendar app you’re trying to use is up to date.
### Alarms or timers aren't being created
- Ensure your device's Clock app is enabled and up to date.
- Check that "Do Not Disturb" settings aren't preventing alarms.
### Content appears different than expected
- Your Android mobile apps may format content slightly differently than Claude.
- You can always edit the content in the destination app before sending or saving.
- Some features may vary depending on your specific Android version and device manufacturer.
### Health data isn't appearing or seems incomplete
- Verify that you have a Pro or Max plan and are located in the US.
- Ensure you're running Android 14 or later.
- Check that Health Connect is installed and that your fitness apps are connected to it.
- Verify that you've granted Claude access to the relevant health data types in Settings \> Apps \> Health Connect \> App permissions \> Claude.
- If you recently started using Health Connect, there may not be enough historical data for trend analysis.
- Some data types require a compatible wearable device (like a Fitbit or Samsung Galaxy Watch).
- Health Connect isn’t supported when using work profiles on Android devices.
**Need more help?** If you're experiencing issues with these features, try restarting Claude for Android or **[updating the app to the latest version from the Google Play Store](https://support.claude.com/en/articles/11825394-how-to-update-claude-for-android)**.
---
## using-claude-with-ios-apps-727c021910.md
# Use Claude with iOS apps
August 25, 2026
Copy for LLM
Claude can now connect with your iOS device's system apps to help you take action directly from your conversations. When you chat with Claude, it can draft messages, emails, or calendar events, find locations, manage reminders, and analyze your health and fitness data — all seamlessly integrated with your mobile apps.
This feature is supported on all Claude plans and works with iOS system apps (Messages, Mail, Calendar, Maps, Reminders, and Location Services), as well as compatible third-party apps. Health features are currently in beta, require a Pro or Max plan, and are available in the US only.
## What can Claude do with iOS apps?
Claude can help you:
- **Draft and send messages** through the Messages app or any messaging platform like WhatsApp, Slack, or Messenger.
- **Compose emails** that open directly in the Mail app or any other email platform like Gmail or Outlook with the subject and content pre-filled.
- **Access your location** to provide contextual suggestions for nearby places and services.
- **Display locations on maps** and help you navigate to restaurants, stores, and other destinations.
- **Read and manage your calendar** to check availability, create events, and schedule meetings.
- **Create and manage reminders** to help you stay organized with tasks and lists.
- **Read and analyze your health data** to help you understand fitness patterns, track progress toward goals, and visualize trends with native charts (Pro and Max plans only).
### Limitations
- **Location:** Members of Team or Enterprise plans can’t access the location tool at this time.
- **Calendar:** Ability to edit events depends on your ownership of the event.
- **Reminders:** Claude cannot create or edit reminder lists themselves, only items within existing lists.
- **Contacts:** Claude does not have direct access to your contacts.
- **Health:** Available in beta on Pro and Max plans only. Currently limited to users in the US. Claude can read health data but cannot write or modify entries in Apple Health.
------------------------------------------------------------------------
## How Claude helps you take action
When Claude determines that using one of these features would be helpful, it will automatically suggest it. You'll see a card or prompt within your conversation that lets you review and take action with Claude’s help.
### Send texts and emails with Messages and Mail
1. Ask Claude to help draft a message or email (for example: "Help me write a text to my team about tomorrow's meeting").
2. Claude will prepare the message and show you a preview.
3. Tap the message card to open your Messages app or Mail app.
1. Third-party apps (WhatsApp, Messenger, Signal) are also supported.
4. Review the pre-filled content and make any changes if needed.
5. Send the message as you normally would.
**Example:** "Draft an email to my manager explaining that I'll be late to the morning meeting due to a doctor's appointment."
### Use location for contextual suggestions
1. Ask Claude for location-based recommendations (for example: "What's nearby for dinner?").
2. Claude will request access to your location if not already granted.
3. Based on your location, Claude provides relevant suggestions.
4. You can view locations on a map and get navigation directions.
**Example:** "Find good restaurants near me that are open now."
### Display locations with Maps
1. When Claude suggests locations, they can be displayed on an interactive map.
2. Tap on any location to see more details.
3. Select a location to open it in Apple Maps for navigation.
4. Get turn-by-turn directions directly from the map.
**Example:** "Show me coffee shops within walking distance on a map."
### Manage your calendar
1. Ask Claude to check your schedule or create events.
2. Claude will request calendar access if not already granted.
3. For checking availability: Claude reads your calendar and identifies free slots.
4. For creating events: Claude prepares event details and adds them to your calendar.
5. You can edit or delete events as needed.
**Examples:**
- "When am I free this week for a 30-minute meeting?"
- "Schedule a dentist appointment for next Friday at 10 AM."
- "Add a weekly team standup every Monday at 9 AM."
### Create and manage reminders
1. Ask Claude to create reminders or add items to lists.
2. Claude will request Reminders access if not already granted.
3. Claude can add items to existing lists or create new reminders.
4. Set due dates, priorities, and notes for reminders.
5. Manage recurring reminders for regular tasks.
**Examples:**
- "Add milk and eggs to my grocery list."
- "Remind me to call the dentist tomorrow at 2 PM."
- "Create a packing list for my trip next week."
Note that when Claude uses tools to take these actions, their use is preserved in the conversation history in the same way as any tool.
------------------------------------------------------------------------
## Access and analyze your health data
**Note:** Health features are available in beta on Pro and Max plans only, and currently limited to users in the US.
Claude can read your health and fitness data from Apple Health to help you understand patterns, track progress, and make informed decisions about your wellbeing. When you ask Claude about your health data, it can display insights using native charts that feel integrated with iOS.
**Important:** We are not a medical device and cannot provide medical guidance. Always consult a licensed professional.
### What health data can Claude access?
With your permission, Claude can read the following types of data from Apple Health:
- **Activity metrics:** Steps, distance, flights climbed, active calories, exercise minutes, move and stand hours.
- **Workouts:** Type (running, cycling, strength, yoga, etc.), duration, distance, heart rate data, and calories burned.
- **Vitals:** Heart rate, resting heart rate, heart rate variability (HRV), blood pressure, respiratory rate, and blood oxygen.
- **Body measurements:** Weight, height, body mass index, and body fat percentage.
- **Sleep:** Total sleep time, sleep stages, time in bed, and sleep efficiency.
- **Nutrition:** Calories consumed, macronutrients, water intake, and micronutrients (if tracked).
**Note:** By default, Claude doesn't save health information to memory. If you turn on **Include sensitive topics in memory**, Claude may remember health-related context from your conversations. Learn more about **[sensitive topics in memory](https://support.claude.com/en/articles/11817273-use-claude-s-chat-search-and-memory-to-build-on-previous-context#h_6fe1d0e66f)**.
### How to use health features
1. Ask Claude a question about your health or fitness data (for example: "How have my runs been trending this month?" or "Show me my sleep patterns over the past two weeks").
2. Claude will request access to your health data if not already granted.
3. Review the permission prompt and select your preferred option.
4. Claude analyzes your data and provides insights, often with visual charts to help you understand trends.
### Example prompts
- "Help me create a training plan for my upcoming half-marathon based on my recent running data."
- "Why have I been feeling tired lately? Can you look at my sleep and activity data?"
- "Show me how my resting heart rate has changed over the past three months."
- "Compare my workout consistency this month versus last month."
- "What patterns do you see in my step count throughout the week?"
### Understanding health visualizations
Claude displays health insights using native iOS charts that appear directly in your conversation. These charts can show:
- **Bar charts** for comparing activity across days or weeks.
- **Line charts** for tracking trends over time (pace, heart rate, weight)
- **Progress indicators** for goals and milestones
Tap on chart elements to see more details about specific data points.
## Usage guidelines for optimal results
To get the best results, be specific about what you want, include relevant details like dates, times, and locations in your requests, and review content before sending or saving. Claude understands natural language, so you can make requests conversationally.
------------------------------------------------------------------------
## What data can Claude access?
Claude only accesses the data necessary for each specific request:
- **Location:** Current location only when relevant to your request.
- **Calendar:** Event details to check availability and create/modify events.
- **Messages/Email:** Claude does not read existing messages or emails, only creates new content.
- **Reminders:** Existing lists and items to add/manage tasks.
- **Health:** Activity, workout, vital signs, body measurements, sleep, and nutrition data — only when you ask a question that requires this information and have granted permission.
Claude's connection to your iOS apps works through your device's built-in sharing and permission systems—the same secure methods you use with any iPhone app.
## Do I need to grant permission to Claude for iOS?
Permission requirements vary by feature:
- **Messages and Email:** No permissions required (uses your device’s built-in sharing system).
- **Calendar Events:** Permission required for reading calendar; writing can use system UI without permission.
- **Location and Maps:** Permission required when Claude needs to access your location.
- **Reminders:** Prompted when Claude needs to access reminder lists.
- **Health:** Permission required. Claude will request access to specific health data categories when needed.
For features requiring permissions (like location or calendar access), Claude will request permission contextually with clear explanations of why the access is needed. You’ll be prompted to approve the action with three options: Allow once, Always allow, or Don't allow.
These permissions can be managed at any time in your device settings by going to Settings \> Claude. You'll see all available permissions like Location, Calendar, and Reminders and can tap on each permission to adjust access levels. You can toggle between "While Using App” and “Ask next time” to change Claude’s access, or remove permissions by choosing “Never.”
Health permissions work differently from other app permissions. When Claude requests health access, you'll see the standard iOS Health permissions screen where you can choose exactly which data types to share. You can modify these permissions at any time by going to Settings \> Health \> Data Access & Devices \> Claude.
Claude will only request permissions if needed for specific features, and you can always choose to decline while still using other capabilities.
------------------------------------------------------------------------
## Troubleshooting
### Claude isn't offering to use my apps
- Make sure you're using the latest version of the Claude iOS app. For instructions, see **[How to update Claude for iOS](https://support.claude.com/en/articles/11825384-).**
- Try being more specific in your request (refer to the examples listed above).
- Restart Claude for iOS and try again.
### Permission prompts don't appear
- Check that the app for which Claude needs permissions is installed and set up on your phone.
- Verify iOS system permissions by navigating to Settings \> Privacy & Security.
- Ensure Claude for iOS has the necessary permissions enabled.
### Features aren't working as expected
- Your iOS mobile apps may format content slightly differently than Claude.
- You can always edit the content in the destination app before sending or saving.
- Some features may vary based on your iOS version.
### Calendar events aren't opening correctly
- Verify you have a calendar app installed.
- Check that your preferred calendar app is set as the default for calendar events.
- Make sure the calendar app you’re trying to use is up to date.
### Health data isn't appearing or seems incomplete
- Verify that you have a Pro or Max plan and are located in the US.
- Check that you've granted Claude access to the relevant health data types in Settings \> Health \> Data Access & Devices \> Claude.
- Ensure your health data is being recorded. Some data types require an Apple Watch or compatible device.
- If you recently started tracking a metric, there may not be enough historical data for trend analysis.
- Try asking about a specific data type to confirm which categories Claude can access.
**Need more help?** If you're experiencing issues with these features, try restarting Claude for iOS or **[updating to the latest version from the App Store](https://support.claude.com/en/articles/11825384-)**.
---
## using-dictation-on-claude-mobile-44b02d30b2.md
# Use dictation on Claude Mobile
July 23, 2026
Copy for LLM
Dictation is available to all Claude users (Free, Pro, Max, Team, and Enterprise plans). Support for languages other than English is in beta.
Dictation allows you to speak your prompts instead of typing them when using Claude for iOS or Android.
**Note:** Dictation is different from voice mode. Dictation turns your speech into text so you can send a written prompt, and Claude replies in text. Voice mode is a full spoken conversation—you talk to Claude and Claude talks back, and it can use your connected tools. Learn more about **[voice mode](https://support.claude.com/en/articles/11101966-use-voice-mode)**.
## Get started with dictation
1. Open Claude for iOS or Android.
2. Start a new chat with Claude.
3. Tap the microphone icon on the right side of the chat input field.
- If this is your first time using dictation, you'll need to select your preferred language. You can change this later in Settings.
4. Dictate your prompt.
5. Tap the arrow icon to send your prompt.
- To cancel without sending, tap the "X" icon.
Your prompt will automatically appear as text in the chat window. Claude will respond to your prompt in text format.
## Supported languages
Dictation is currently available in these languages:
- English
- French
- German
- Hindi
- Italian
- Japanese
- Korean
- Portuguese
- Russian
- Spanish
- Turkish
- Ukrainian
## Change your language settings
To change your speech input language:
1. Tap your initials in the upper right corner.
2. Select “Speech Input Language.”
3. Choose your preferred language from the dropdown.
## Data privacy
After converting your speech input to text, we will delete your audio recording. We will not retain a copy of your speech input or use it for training our generative models.
Learn more about our privacy practices by visiting our **[Privacy Policy](https://www.anthropic.com/legal/privacy)** and **[Privacy Center](https://privacy.anthropic.com/en/)**.
---
## using-dictation-on-claude-mobile.md
# Using dictation on Claude Mobile
Dictation is currently available for users on free, Pro, and Team plans
Dictation allows you to speak your prompts instead of typing them when using Claude for iOS or Android.
## Getting started
1. Open Claude for iOS or Android.
2. Start a new chat with Claude.
3. Tap the microphone icon on the right side of the chat input field.
- If this is your first time using dictation, you'll need to select your preferred language. You can change this later in Settings.
4. Dictate your prompt.
5. Tap the arrow icon to send your prompt.
- To cancel without sending, tap the "X" icon.
Your prompt will automatically appear as text in the chat window. Claude will respond to your prompt in text format.
## Supported languages
Dictation is currently available in these languages:
- English
- French
- German
- Hindi
- Italian
- Japanese
- Korean
- Portuguese
- Russian
- Spanish
- Turkish
- Ukrainian
## Changing your language settings
To change your speech input language:
1. Tap your initials in the upper right corner.
2. Select “Speech Input Language.”
3. Choose your preferred language from the dropdown.
## Data privacy
After converting your speech input to text, we will delete your audio recording. We will not retain a copy of your speech input or use it for training our generative models.
Learn more about our privacy practices by visiting our [Privacy Policy](https://www.anthropic.com/legal/privacy) and [Privacy Center](https://privacy.anthropic.com/en/).
---
## using-the-claude-widget-on-android-390cb68cef.md
# Use the Claude widget on Android
July 9, 2026
Copy for LLM
The Claude Android widget is available on Android 8.0 Oreo and above.
The Claude Android widget provides quick and convenient access to core features directly from your home screen, allowing you to start new chats, capture images, and use voice dictation with a single tap.
## Add the Claude widget
The Claude widget puts Claude's key features right on your home screen. To add it:
1. Touch and hold an empty area on your home screen
2. Tap "Widgets"
3. Find and tap "Claude"
4. Drag the widget to your desired location
5. Release to place it
6. Optional: Drag the edges of the widget to resize it
## Widget features
The widget offers three quick-access buttons:
- A primary chat button (with Claude's spark icon) to start a new conversation
- A camera button for capturing and sharing images with Claude
- A microphone button for voice dictation
## Use the widget
### Start a chat
Tap the main chat button (with the spark icon) to instantly start a new conversation with Claude.
### Take photos
Tap the camera button to start a new chat and immediately open your camera. You can capture an image and share it with Claude for analysis.
### Voice dictation
Tap the microphone button to start a new chat and begin voice dictation. The first time you use this feature, you'll see a brief explanation about how automatic recording works. You may also need to grant voice permissions if you haven't already done so.
**Note:** All interactions started through the widget will count toward your usage limit.
---
## using-the-claude-widget-on-android.md
# Using the Claude Widget on Android
The Claude Android widget is available on Android 8.0 Oreo and above.
The Claude Android widget provides quick and convenient access to core features directly from your home screen, allowing you to start new chats, capture images, and use voice dictation with a single tap.
## Adding the Claude Widget
The Claude widget puts Claude's key features right on your home screen. To add it:
1. Touch and hold an empty area on your home screen
2. Tap "Widgets"
3. Find and tap "Claude"
4. Drag the widget to your desired location
5. Release to place it
6. Optional: Drag the edges of the widget to resize it
## Widget Features
The widget offers three quick-access buttons:
- A primary chat button (with Claude's spark icon) to start a new conversation
- A camera button for capturing and sharing images with Claude
- A microphone button for voice dictation
## Using the Widget
### Starting a Chat
Tap the main chat button (with the spark icon) to instantly start a new conversation with Claude.
### Taking Photos
Tap the camera button to start a new chat and immediately open your camera. You can capture an image and share it with Claude for analysis.
### Voice Dictation
Tap the microphone button to start a new chat and begin voice dictation. The first time you use this feature, you'll see a brief explanation about how automatic recording works. You may also need to grant voice permissions if you haven't already done so.
**Note:** All interactions started through the widget will count toward your usage limit.
---
## using-voice-mode-on-claude-mobile-apps-43af7ca8d3.md
# Use voice mode
Copy for LLM
Voice mode allows you to have complete spoken conversations with Claude. Instead of typing a prompt and reading a written response, you can speak to Claude and listen to its responses, making it easier to use when your hands are busy but your mind isn't.
Voice mode is a beta feature available to all plans (Free, Pro, Max, Team, and Enterprise) on Claude Mobile (iOS and Android), Claude Desktop, and the web, but is built to work best from your phone.
## What is voice mode?
Voice mode transforms how you interact with Claude by:
- Allowing you to speak to Claude and hear Claude's voice responses.
- Seamlessly switch between text and voice within the same conversation.
- Using web search and the tools you've connected, like Gmail, Google Calendar, Google Docs, and Slack, during a voice conversation.
- Talking with Claude in many more languages
## Enable voice mode
### On the web and Claude Desktop
1. Log in to your Claude account and start a new chat.
2. Tap the sound wave symbol in the lower right corner of the chat window to activate voice mode:
3. Start talking and see your prompt automatically populate in the chat input.
4. Once you finish telling Claude your prompt, it will respond to continue the conversation.
5. Claude will remain in voice mode until you click the “Stop” button in the lower right corner of the chat window:
### On mobile (iOS and Android)
1. Open the Claude app on your device.
2. Tap the voice mode icon (sound wave symbol next to the microphone icon) in the text input field:
3. Choose a voice to personalize your experience.
4. Start speaking to begin your conversation.
------------------------------------------------------------------------
## Use voice mode
**Note:** Voice conversations count toward your regular usage limits based on your subscription plan.
Voice mode offers two ways to talk with Claude, depending on your environment.
### Hands-free mode
In hands-free mode, Claude listens continuously and responds to natural pauses in your speech. This is the default mode—just start talking, and Claude will respond when you finish a thought.
Hands-free mode works best in quiet environments. Claude is designed to handle natural pauses without cutting you off, so you can speak at your own pace without rushing.
If Claude does interrupt you, simply start speaking again—Claude will stop and listen.
### Push-to-talk mode
If you're in a noisy environment or Claude is having trouble distinguishing your voice from background sounds, switch to push-to-talk mode. In this mode, you hold a button while speaking and release it when you're done.
Push-to-talk gives you more control over when Claude listens, which makes it more reliable in challenging environments like busy streets, crowded rooms, or when other people are talking nearby.
## Choose a voice
Claude offers several voice options you can choose from when you first start voice mode.
To change the voice later:
- **On the web and desktop:** Go to **[Settings \> General](https://claude.ai/new#settings/general)** and scroll down to **Voice settings**. Select your preferred voice from the options. You’ll hear a preview when you click each option; click it again to stop the preview.
- **On mobile:** Click the settings button in the bottom left corner while chatting with Claude in voice mode, then tap your preferred voice and pace:
## Choose a model
Voice mode can use the same Claude models you use in text chat, so it can keep up with harder questions, not just quick ones. The models available to you in voice mode follow your plan. When you turn on voice mode, it starts with the model you last used in text chat (for example, Sonnet, Opus, Haiku) and will automatically switch to the latest generation of that model.
Tap or click on the model selector when you're in voice mode to switch models during a conversation. You’ll choose a model without picking a specific generation.
**Note:** Claude Fable is not currently available in voice mode.
## Switch between text and voice
You can switch between text and voice within the same conversation. Your previous context carries over, so you don't lose anything when you switch. This is useful when you start a conversation by typing but want to continue hands-free, or when you need to type something specific (like a URL or code) mid-conversation.
## Use your connected tools
In voice mode, Claude can use the tools you've connected, like Gmail, Google Calendar, Google Docs, and Slack. You can ask Claude to catch you up on your email, check your calendar before a meeting, or summarize a thread without leaving the conversation. Connected tools work the same way in voice mode as they do in text chat and follow the rules of your plan. On the Free plan you can connect one tool, and paid plans can connect more.
**Note:** Not every result can be shown on screen in voice mode, and using several tools at once can add a short delay.
## Use cases
Voice mode is particularly useful for:
- **Daily planning.** Have Claude brief you on what's coming up while you get ready for the day.
- **Learning.** Explore new topics through conversation while commuting, exercising, or doing chores.
- **Creative thinking.** Think out loud with Claude to develop ideas when typing would slow you down.
- **Preparation.** Practice for interviews or important conversations through natural dialogue.
- **Capturing ideas.** Talk through thoughts the moment they come to you, wherever you are.
## Tips for a good experience
- **Start in a quiet space.** Hands-free mode works best when Claude can detect only one voice, so if you're in a noisy or crowded environment, switch to push-to-talk.
- **Speak naturally.** You don't need to speak slowly or pause artificially. Claude is designed to follow natural speech patterns.
- **Break up complex questions.** For multi-part questions, it can help to ask them one at a time rather than all at once.
- **Interrupt if needed.** If Claude is going in the wrong direction, just start talking. Claude will stop and listen.
## Safety measures in voice mode
Voice mode has been developed with safety as a top priority. Several safeguards have been implemented to mitigate potential risks:
- **Limited voice options:** Choose from a preset, limited selection of voices. This prevents voice cloning or impersonation. The system is designed specifically to avoid mimicking specific individuals or personalizing voice outputs.
- **Generative by design**: Claude is designed to generate original responses rather than reproduce text exactly or mimic specific speech patterns, which prevents impersonation.
- **Full policy compliance:** Our usage policy remains fully enforced in voice mode, with all standard model misuse detection and enforcement systems actively monitoring interactions.
------------------------------------------------------------------------
## Troubleshooting
### Claude isn't recognizing my voice correctly
- Make sure you're in a reasonably quiet environment, or switch to push-to-talk mode.
- Check that your device's microphone permissions are enabled for Claude.
- Speak clearly and at a normal pace.
### Voice responses sound choppy or cut out
- Check your internet connection. Voice mode works best on a stable connection.
- Close other apps that might be using significant system resources.
- Make sure your device has enough battery — voice processing uses more power than text.
### Claude stops responding in voice mode
- Check whether you've reached your usage limits.
- Try leaving voice mode and re-entering.
- Make sure your internet connection is stable.
### Claude keeps interrupting me
- Try pausing less between thoughts, or switch to push-to-talk mode for more control over when Claude listens.
- Move to a quieter environment if possible — background noise can sometimes cause false interruptions.
------------------------------------------------------------------------
## Frequently asked questions
### Will my voice conversations be saved?
Yes. Textual transcripts of your audio conversations are saved in your chat history just like text conversations.
### What's the difference between dictation and voice mode?
Dictation converts your speech to text so you can type prompts by speaking. Voice mode is a full two-way conversation — you speak to Claude, and Claude speaks back.
### Can I use voice mode in languages other than English?
Yes. Voice mode supports many more languages, on all plans and on Claude Mobile, Claude Desktop, and web. Support for languages other than English is in beta.
To set your voice language, go to **[Settings \> General](https://claude.ai/new#settings/general)**, then find **Voice \> Language** and choose a language. Changing your app's display language doesn't change your voice language, so set it here. You can also ask Claude to switch languages during a voice conversation.
### Can I use voice mode with Claude Cowork or Claude Code?
In the new Claude experience, voice mode works in any conversation, including ones where Claude is working on a task. In Claude Cowork and Claude Code, dictation is available but voice mode isn't.
### Can Enterprise Admins disable voice mode for their organizations?
If you are an Enterprise owner and would like to disable voice mode for your organization, please **[reach out to Support](https://support.claude.com/en/articles/9015913-how-to-get-support)**.
---
## what-versions-of-android-are-supported.md
4. What versions of Android are supported?
# What versions of Android are supported?
We currently support Android 8.0 Oreo and above.
---
## when-to-use-desktop-and-web-connectors-f9b59fae6a.md
# When to use desktop and web connectors
Copy for LLM
Claude can connect to your tools in two ways: through the web (remote connectors) or through the Claude Desktop app (desktop extensions). Most connectors are remote—they're the default choice and work everywhere you use Claude.
## Use a remote connector when
- The tool is a cloud service you sign into (Slack, Notion, Linear, GitHub, your company's SaaS)
- You want the connector available everywhere—web, mobile, Cowork, Desktop, and Claude Code
- You're connecting something from the **[Connectors Directory](https://claude.ai/directory)**
Remote connectors work across all Claude surfaces. Once connected, they're available everywhere without extra setup.
## Use a desktop extension when
- The tool runs on your computer—local files, a database on localhost, a desktop application
- The tool needs OS-level access (filesystem, clipboard, local processes)
- There's no cloud version to connect to
Desktop extensions run locally and are only available in Claude Desktop and Claude Code—not on web or mobile.
## Plugins work with both
A plugin can bundle either remote or local MCP servers (or both). Adding a plugin that references a remote MCP makes it available everywhere. One that references a local MCP works in Cowork and Claude Code, not in chat.
## Quick guide
[TABLE]
## Get started
- Browse and add remote connectors: **[Settings → Connectors](https://claude.ai/settings/connectors)** or the **[Connectors Directory](https://claude.ai/directory)**
- Install a desktop extension: Open Claude Desktop → Settings → Extensions
- Building your own? See the **[connector building docs](https://claude.com/docs/connectors/building)** for remote connectors or the **[MCPB guide](https://claude.com/docs/connectors/building/mcpb)** for local ones.
---
## why-can-t-i-find-claude-for-android-in-the-play-store.md
4. Why can’t I find Claude for Android in the Play Store?
# Why can’t I find Claude for Android in the Play Store?
If you’re unable to locate the Claude app in your Play Store, you may be located in an [unsupported region](https://support.anthropic.com/en/articles/8461763-where-can-i-access-claude-ai), using an unsupported device, or using an unsupported version of Android.