Claude Code 桌面客户端安装与首次使用指南
入门12 分钟阅读
Claude Code 桌面客户端安装与首次使用指南

Claude Code 桌面客户端安装与首次使用指南

CATAITO Team2026-08-07
你的操作系统:

学习目标

学完本教程，你将能够：

  • 在你的操作系统上下载并安装 Claude Code 桌面客户端
  • 使用你的 Claude 账号登录并打开 Code 标签页
  • 在桌面客户端中开启你的第一个 AI 编程会话
  • 审查并接受 Claude 提出的修改
  • 排查常见的安装问题

所需时间： 10–15 分钟

难度： 初级

本篇覆盖哪个版本？ 本教程只覆盖 Claude Code 桌面客户端——像普通软件一样下载安装的图形界面应用。不涉及终端 CLI 或网页版。如果你想在终端中使用，可直接前往《Claude Code CLI 入门指南》。

开始之前

开始前，请确认你具备：

要求说明
操作系统Windows 10 或更高、macOS、或 Linux（桌面版支持 Ubuntu/Debian）
账号Claude Pro、Max、Team 或 Enterprise 订阅
网络稳定的互联网连接
磁盘空间约 500 MB 可用空间
什么是 Claude Code 桌面客户端？
Claude Code 桌面客户端是 Anthropic 的 AI 编程代理 Claude Code 的桌面应用版本。与 CLI（命令行工具）不同，桌面客户端提供图形界面：侧边栏可并行运行多个会话、可拖拽布局的集成终端和文件编辑器、用于审查修改的 diff 视图、以及应用实时预览。无需使用终端。

重要提示： 免费的 Claude.ai 套餐不包含 Claude Code。你需要付费订阅（Pro 每月 $20 起、Max 每月 $100 起、Team 或 Enterprise）。

下载与安装

桌面客户端内置了 Claude Code。你不需要单独安装 Node.js 或 CLI——下面的下载就是你需要的一切。

Windows 安装

  1. 1打开浏览器，进入 Claude 下载页面：
  1. 1下载会自动开始。下载完成后，打开下载的安装程序文件（通常在你的下载文件夹中）。
  2. 2如果 Windows 弹出蓝色的用户账户控制窗口，点击是。
  3. 3按屏幕提示完成安装——默认设置即可。
  4. 4安装完成后，点击开始按钮（Windows 徽标），输入 Claude，然后点击出现的 Claude 应用。
注意： 在 Windows 上，本地编程会话需要安装 Git。如果你没有安装，请从 git-scm.com 下载并安装（默认设置即可）。大多数 Mac 自带 Git，所以这条只针对 Windows。

登录并打开 Code 标签页

首次启动桌面客户端时，你会看到登录界面：

  1. 1点击登录，使用你的 Claude 账号（Pro、Max、Team 或 Enterprise 订阅）登录。浏览器窗口会打开完成登录，然后自动返回应用。
  2. 2应用顶部有三个标签页：
  • Chat（聊天） —— 不访问文件的普通对话，类似 claude.ai
  • Cowork（协同） —— 在沙箱虚拟机中自主处理任务的幕后代理，你可以同时做其他事情
  • Code（代码） —— 可直接访问本地文件的交互式编程助手。本教程使用这个标签页。
  1. 1点击 Code 标签页。
  • 如果提示升级，说明你的套餐不包含 Claude Code——请先订阅付费计划。
  • 如果提示在线登录，请完成登录后重启应用。
  1. 1Code 标签页打开后，桌面客户端就准备好了。

你的第一个编程会话

第 1 步：选择环境和文件夹

在 Code 标签页中选择 Local（本地），让 Claude 在你的机器上直接使用你的文件运行。然后点击选择文件夹，选中你的项目目录。

提示： 从一个你熟悉的小项目开始，这是最快看到 Claude Code 能力的方式。

你还可以选择其他环境：

  • Cloud（云端） —— 在云端运行会话；即使关闭应用也会继续运行
  • SSH —— 连接到远程机器，如服务器、云虚拟机或开发容器
  • WSL（仅 Windows）—— 在 WSL 2 Linux 发行版中运行会话

本教程只需要 Local。

第 2 步：选择模型

发送按钮旁边有模型下拉菜单。选择你想使用的模型。之后随时可以从同一个下拉菜单更换。

第 3 步：告诉 Claude 要做什么

输入你想让 Claude 完成的任务，例如：

text
为 main 函数添加测试

其他可以尝试的例子：

  • 找到 TODO 注释并修复它 —— 找到未完成的代码并修复
  • 创建一个 CLAUDE.md，写下这个代码库的说明 —— 编写项目指南文件
  • 解释一下这个项目是做什么的 —— 总结项目

会话（session） 是你与 Claude 关于代码的对话。每个会话独立跟踪自己的上下文和修改，因此你可以并行处理多个任务而互不干扰。

第 4 步：审查并接受修改

默认情况下，Code 标签页以手动模式启动，Claude 提出修改并等待你批准后才应用。你会看到：

  1. 1diff 视图，精确显示每个文件将发生什么变化
  2. 2接受 / 拒绝按钮，用于批准或拒绝每个修改
  3. 3随着 Claude 完成任务，实时更新进度

在你点击接受之前，文件不会被修改。如果你拒绝修改，Claude 会询问你希望如何调整。

第 5 步：尝试更多实用功能

  • 随时打断和引导 —— 点击停止按钮打断 Claude，或输入更正内容并按回车，无需停止正在进行的操作
  • 给 Claude 更多上下文 —— 在输入框中输入 @文件名 把文件带入对话，或直接把文件拖入输入框
  • 打开终端 —— 按 Ctrl + \`（反引号）在会话旁打开集成终端
  • 切换权限模式 —— 使用模式选择器在手动（每次修改前询问）、接受编辑（自动接受文件编辑以加快迭代）和计划（只提出方案，不做任何修改）之间切换
  • 预览你的应用 —— 当你运行开发服务器时，应用会出现在浏览器面板中，Claude 可以查看它并测试接口

故障排查

问题解决方法
点击 Code 时提示升级你的套餐不包含 Claude Code——请订阅 Pro、Max、Team 或 Enterprise
提示在线登录在浏览器中完成登录，然后重启应用
Windows：本地会话无法工作Windows 需要 Git——从 git-scm.com 安装后重启应用
macOS："无法验证开发者"警告系统设置 → 隐私与安全性 → 仍要打开
Linux：apt update 报 NO_PUBKEY BAA929FF1A7ECACE签名密钥下载失败——重新执行 Linux 安装第 2 步，然后再次 sudo apt update
应用卡顿关闭其他应用，检查网速，重启应用
登录失败先确认你可以在 claude.ai 登录；必要时重置密码

如何卸载

Windows：

  1. 1打开设置 → 应用 → 已安装的应用
  2. 2找到 Claude
  3. 3点击三个点 → 卸载

下一步

  • 阅读 CLI 教程： 桌面客户端和 CLI 共享同一引擎和配置（CLAUDE.md 文件、MCP 服务器、技能）。在 Claude Code CLI 入门指南 中学习终端版本
  • 用技能处理重复任务： 输入 / 或点击 + 按钮浏览内置命令和自定义技能
  • 并行运行会话： 打开侧边栏同时处理多个任务，每个任务有独立的 Git worktree
  • 给 Claude 安排定时任务： 设置每日代码审查、每周依赖审计或晨间简报
  • 连接外部工具： 点击输入框旁的 + 按钮并选择插件，添加技能、代理和 MCP 服务器
#Claude Code#Desktop#Installation#Anthropic
返回教程

相关教程