Claude Code 深度学习手册

主题

桌面应用快速上手 ​

安装 Claude Code 桌面应用并启动第一个本地编码会话，无需终端。

是什么 ​

Claude Code 桌面应用是带图形界面的 Claude Code，专为并行运行多个会话设计：侧边栏管理并行任务、可拖拽的布局（含集成终端与文件编辑器）、可视化 diff 审查、应用实时预览、GitHub PR 监控与自动合并、以及定时任务，全程无需终端。

应用包含三个标签页：Chat（无文件访问的通用对话，类似 claude.ai）、Cowork（在云端 VM 自主运行的后台 agent）、Code（可直接访问本地文件、需实时审批每处改动的交互式编码助手）。本页聚焦 Code 标签页。

怎么工作 ​

  • 桌面应用内置 Claude Code，无需单独安装 Node.js 或 CLI；若想在终端用 claude 命令则需另行安装 CLI。
  • 在 Code 标签页选择环境与项目文件夹后向 Claude 下达任务，每个 session 独立追踪自己的上下文与改动，互不干扰。
  • 环境可选 Local（在本机直接用你的文件运行）、Remote（在 Anthropic 云端运行，关闭应用也会继续，与 Claude Code on the web 同一基础设施）、SSH（通过 SSH 连接远程机器，首次连接时桌面会自动在远程安装 Claude Code）。
  • 默认处于 Ask permissions 模式：Claude 提出改动并等待批准，展示 diff view 与 Accept/Reject 按钮，文件在你接受前不会被修改。
  • 可随时打断与引导：点 stop 按钮立即中断，或输入纠正后按 Enter 在不停止当前动作的情况下发送。
  • 桌面应用与 CLI 运行同一引擎，可在同一项目上同时运行，并共享配置（CLAUDE.md 文件、MCP servers、hooks、skills、settings）。

怎么配置 / 用法 ​

安装与首个会话步骤：

  1. 安装并登录：从对应平台下载安装器并运行，在 macOS 的 Applications 文件夹或 Windows 的开始菜单启动 Claude，用 Anthropic 账号登录。
  2. 打开 Code 标签页：点击顶部中央的 Code 标签；若提示升级则需先订阅付费计划，若提示在线登录则完成登录并重启应用。
  3. 选择环境与文件夹：选 Local，点 Select folder 选择项目目录（建议从你熟悉的小项目开始）。
  4. 选择模型：在发送按钮旁的下拉框选择模型（Opus / Sonnet / Haiku），之后可随时更改。
  5. 下达任务，例如：
Find a TODO comment and fix it
Add tests for the main function
Create a CLAUDE.md with instructions for this codebase
  1. 审查并接受改动：查看 diff view、用 Accept/Reject 批准或拒绝，拒绝后 Claude 会询问如何改换方式。

什么时候用 ​

  • 想用图形界面而非终端使用 Claude Code 时
  • 需要并行运行多个编码会话（各自独立的 Git worktree）时
  • 想要可视化 diff 审查、应用实时预览或 GitHub PR 监控/自动合并时
  • 刚上手 Claude Code、想用熟悉的小项目快速体验时
  • 想设置定时任务（如每日代码审查、每周依赖审计）时

限制 / 坑 ​

  • 桌面应用不支持 Linux，Linux 请改用 CLI。
  • Claude Code 需要 Pro、Max、Team 或 Enterprise 订阅。
  • Windows 上本地会话需先安装 Git（多数 Mac 默认自带 Git）。
  • Chat 与 Cowork 标签页不在本页范围，详见 Claude Desktop 支持文档。

硬事实速查（12 条） ​

  • 三个标签页：Chat、Cowork、Code；本页聚焦 Code。
  • macOS 提供 Intel 与 Apple Silicon 通用版（universal dmg）。
  • Windows 提供 x64 安装器，Windows ARM64 需下载 ARM64 installer。
  • Linux 不提供桌面应用，需用 CLI。
  • 需要 Pro / Max / Team / Enterprise 付费订阅。
  • 三种环境：Local、Remote、SSH；SSH 首次连接会自动在远程机器安装 Claude Code。
  • Remote 会话在关闭应用后继续运行，与 Claude Code on the web 同一基础设施。
  • 默认权限模式为 Ask permissions；另有 Auto accept edits 与 Plan mode。
  • 用 @filename 将指定文件拉入对话，也可用附件按钮或拖拽添加图片/PDF。
  • 输入 / 或点 + → Slash commands 浏览内置命令、自定义 skills 与插件 skills。
  • 用 Ctrl+反引号 打开集成终端。
  • 编辑后出现 +12 -1 形式的改动指示，点击可打开 diff view 逐文件审查并按行评论。

官方出处：https://code.claude.com/docs/en/desktop-quickstart