Claude Code 桌面版

在本地或安全的云基础设施上运行 Claude Code 任务，使用 Claude 桌面应用

桌面版 Claude Code（预览版）

Claude 桌面应用为在本地机器上运行多个 Claude Code 会话提供了原生界面，并与网页版 Claude Code 无缝集成。

功能

桌面版 Claude Code 提供：

• 使用 git worktrees 的并行本地会话：在同一个仓库中同时运行多个 Claude Code 会话，每个会话都有自己隔离的 git worktree
• 在 worktrees 中包含 .gitignore 中列出的文件：使用 .worktreeinclude 自动将 .gitignore 中的文件（如 .env）复制到新的 worktrees
• 启动网页版 Claude Code：直接从桌面应用启动在 Anthropic 安全云基础设施上运行的会话

安装

从 claude.ai/download 下载并安装 Claude 桌面应用

使用 Git worktrees

桌面版 Claude Code 支持使用 Git worktrees 在同一个仓库中运行多个 Claude Code 会话。每个会话都有自己隔离的 worktree，允许 Claude 在不同的任务上工作而不会产生冲突。worktrees 的默认位置是 ~/.claude-worktrees，但可以在 Claude 桌面应用的设置中配置。

复制 .gitignore 中忽略的文件

当 Claude Code 创建 worktree 时，通过 .gitignore 忽略的文件不会自动可用。包含 .worktreeinclude 文件可以解决这个问题，它指定哪些被忽略的文件应该被复制到新的 worktrees。

在你的仓库根目录中创建一个 .worktreeinclude 文件：

.env
.env.local
.env.*
**/.claude/settings.local.json

该文件使用 .gitignore 风格的模式。当创建 worktree 时，与这些模式匹配且也在你的 .gitignore 中的文件将从你的主仓库复制到 worktree。

启动网页版 Claude Code

从桌面应用，你可以启动在 Anthropic 安全云基础设施上运行的 Claude Code 会话。

要从桌面启动网页会话，在创建新会话时选择远程环境。

有关更多详情，请参阅 网页版 Claude Code。

捆绑的 Claude Code 版本

桌面版 Claude Code 包含一个捆绑的稳定版本的 Claude Code，以确保所有桌面用户获得一致的体验。即使计算机上已存在 Claude Code 版本，捆绑版本也是必需的，并在首次启动时下载。桌面应用自动管理版本更新并清理旧版本。

环境配置

对于本地环境，桌面版 Claude Code 自动从你的 shell 配置中提取 $PATH 环境变量。这允许本地会话访问开发工具，如 yarn、npm、node 和终端中可用的其他命令，无需额外设置。

自定义环境变量

选择”本地”环境，然后在右侧选择设置按钮。这将打开一个对话框，你可以在其中更新本地环境变量。这对于设置项目特定的变量或开发工作流所需的 API 密钥很有用。出于安全原因，环境变量值在 UI 中被掩盖。

  API_KEY=your_api_key
  DEBUG=true

  # 多行值 - 用引号包装
  CERT="---BEGIN CERT---
  MIIE...
  ---END CERT---"

企业配置

组织可以使用 isClaudeCodeForDesktopEnabled 企业策略选项 在桌面应用中禁用本地 Claude Code 使用。此外，可以在你的 管理员设置 中禁用网页版 Claude Code。

相关资源

• 网页版 Claude Code
• Claude 桌面支持文章
• 企业配置
• 常见工作流
• 设置参考

To find navigation and other pages in this documentation, fetch the llms.txt file at: https://code.claude.com/docs/llms.txt