// complete guide

Claude Desktop

App 完整功能指南

// Chat · Projects · Code  ·  claude.ai/download  ·  macOS / Windows

01 / Chat(对话)
新建对话 & 历史管理
  • 新建对话 Cmd/Ctrl + N
  • 对话历史 — 左侧边栏列出所有历史对话,按时间倒序排列
  • 搜索历史 — 顶部搜索框,支持关键词全文检索历史对话内容
  • 重命名对话 — 右键点击对话条目,选择 Rename
  • 删除对话 — 右键 → Delete,支持批量选择删除
  • 星标置顶 — 右键 → Star,将常用对话固定到侧边栏顶部
// 对话历史同步云端,跨设备(App / Web / iOS)保持一致
文件附件
支持类型说明
图片PNG · JPG · GIF · WebP,支持多图
PDF直接解析文本内容,可提问
代码文件.py .js .ts .go .rs .md 等纯文本
Office 文档.docx .xlsx .csv(部分账户)
每次对话限制最多 5 个文件,单文件 ≤ 10 MB
拖拽上传 点击 + 按钮 Cmd+V 粘贴图片
// 上传代码文件后可直接说「解释这段代码」「找出 bug」「重构为函数」
Artifacts(工件)
  • 代码 Artifact — 带语法高亮,一键复制,部分语言可在沙箱内运行
  • Markdown 文档 — 实时渲染预览,可导出为 .md 文件
  • HTML Artifact — 内嵌 iframe 预览,所见即所得
  • SVG 图形 — 矢量图直接渲染,支持动画 SVG
  • React 组件 — 实时运行交互式 UI,无需本地环境
  • Mermaid 图表 — 流程图 · 时序图 · 甘特图
// 如何触发 Artifact:对话中描述「创建一个…」「写一个…网页」「画一个…流程图」,Claude 会自动在右侧面板打开 Artifact 预览
Voice Mode & Extended Thinking
VOICE MODE
  • 开启方式 — 输入框右侧麦克风图标,或 Cmd/Ctrl + Shift + V
  • 使用场景 — 免手打对话、开车时查询、多任务处理时语音提问
  • 语言支持 — 中文、英文、日语等多语言识别
EXTENDED THINKING
  • 适用模型 — Claude Sonnet 4 / Claude Opus 4
  • 开启方式 — 输入框底部工具栏点击「思考」图标
  • 适合场景 — 数学推导、复杂代码设计、多步骤规划、逻辑分析
  • 可见思考过程 — 折叠显示推理步骤,展开可查看完整思维链
Computer Use(桌面 App 特有)
  • 功能描述 — Claude 直接控制你的电脑:移动鼠标、点击、输入、截图
  • 开启方式 — 设置 → Features → 启用 Computer Use
  • 授权范围 — 仅在你手动授权后执行,每步操作均可预览确认
  • 使用方式 — 说「帮我打开浏览器搜索 X 并截图」
⚠ 安全注意事项
· 不要在包含敏感信息(银行、密码管理器)的界面使用
· 操作前仔细阅读 Claude 的执行计划
· 随时可按 ESC 或点击「停止」中断执行
· 建议在独立的虚拟桌面空间内使用
快捷键完整列表
快捷键功能
Cmd/Ctrl + N新建对话
Cmd/Ctrl + K搜索历史对话
Cmd/Ctrl + ,打开设置
Cmd/Ctrl + L清除当前对话输入
Cmd/Ctrl + Enter发送消息
Shift + Enter输入框内换行
Cmd/Ctrl + Shift + C复制最后一条回复
Cmd/Ctrl + Shift + V开启 / 关闭语音输入
Cmd/Ctrl + [ / ]切换上/下一条对话
Esc停止生成 / 关闭弹窗
Cmd/Ctrl + W关闭当前标签页
Cmd/Ctrl + R刷新 / 重载应用
使用技巧:System Prompt & 上下文
如何写好 System Prompt
// 好的 System Prompt 结构
你是一名资深 Python 工程师。
// 1. 角色定义

回答时:
- 优先给出可运行的代码示例
- 使用 Python 3.10+ 特性
- 遇到安全问题主动提示
// 2. 行为约束

输出格式:Markdown,代码块注明语言
// 3. 格式要求
// 持续对话技巧:在开头说「我们正在做 X 项目,你之前已了解了 Y」可快速恢复上下文。超长对话可发送「请总结我们目前的进展」后新建对话继续。
02 / Projects(Cowork / 项目协作)
创建项目 & 知识库
  1. 左侧边栏点击 New Project,输入项目名称
  2. 点击 Project Knowledge,上传文件(PDF · 代码 · 文档)
  3. Project Instructions 框填写项目级 System Prompt
  4. 点击 New Chat 开始在项目内对话,所有文件自动注入上下文
  5. 项目内每个对话都共享同一套文件 + 指令,无需重复上传
知识库文件限制说明
单文件大小最大 10 MB
总文件数量Free 20 个 / Pro 无限制
支持格式PDF · TXT · MD · 代码文件 · 图片
Project Instructions 编写指南
开发项目示例
你是本项目的技术顾问。
项目:电商后台 API(Node.js + PostgreSQL)
代码规范:ESLint Airbnb · Prettier
测试框架:Vitest

回答代码问题时:
1. 先确认修改不破坏现有接口
2. 给出完整可运行示例
3. 同时生成对应单元测试
写作项目示例
你是我的写作助手。
写作风格:简洁有力,不用被动语态
目标读者:25-40 岁技术从业者
输出语言:简体中文
禁止:营销腔、过度修饰词
与普通 Chat 的区别
功能普通 ChatProjects
文件上传每次单独上传一次上传永久共享
System Prompt每次手动输入项目级别持久化
对话管理全局混杂按项目独立归档
上下文持久仅当前对话跨对话共享知识库
团队共享不支持Teams/Enterprise 支持
适合场景临时一次性问答持续进行的长期任务
Team 协作(Teams / Enterprise)
  1. 项目设置 → Members → 输入成员邮箱邀请
  2. 设置权限:Viewer(只读)/ Editor(可编辑文件+指令)/ Admin
  3. 成员在自己的 App 内可看到共享项目及所有知识库文件
  4. 每位成员有独立对话历史,但共享同一套 Instructions + 文件
Teams 账户 Enterprise 账户
// 共享项目中的文件更新后,所有成员的新对话自动使用最新版本
使用场景举例
  • 开发项目 — 上传整个代码库 + README,Instructions 写明技术栈和代码规范,所有对话自动理解项目背景
  • 学习项目 — 上传教材 PDF + 笔记,Instructions 设置「用简单语言解释,多举类比」,打造专属导师
  • 写作项目 — 上传已写章节 + 参考资料,Instructions 定义写作风格,每次对话保持一致语气
  • 运维项目 — 上传服务器架构文档 + 操作手册,秒变专属运维助手
  • 客户项目 — 上传客户资料 + 沟通记录,快速生成报告和邮件草稿
// 实用技巧:用 Projects 后,再也不需要每次对话开头粘贴「我有一个 Node.js 项目,用 PostgreSQL,代码规范是...」
03 / Code(Claude Code 集成)
什么是 Claude Code & 打开方式
  • 定义 — Claude Code 是深度集成进终端的 AI 编程 Agent,可读写文件、运行命令、理解整个代码库
  • 从桌面 App 进入 — 侧边栏底部 Code 图标,或菜单 Claude → Open Claude Code
  • 从终端运行 — 先安装:npm install -g @anthropic-ai/claude-code,然后在项目目录运行 claude
  • 工作目录 — Claude Code 在当前目录运行,自动索引项目结构
  • 认证 — 与桌面 App 共享登录状态,无需单独配置 API Key(Pro/Teams 账户)
macOS Windows (WSL) Linux
基本工作流
  1. 打开项目 — 在项目根目录运行 claude 或通过桌面 App Code 入口打开
  2. 描述任务 — 用自然语言说明目标,如「重构 utils.py,将重复逻辑提取为函数」
  3. Claude 分析 — 自动读取相关文件、理解依赖关系、制定修改方案
  4. 审查变更 — diff 视图展示每个文件的具体改动,逐项确认
  5. 接受 / 拒绝y 接受,n 拒绝,e 手动编辑后接受
  6. 运行验证 — Claude Code 可自动运行测试命令,验证变更不破坏现有功能
// 每次操作前 Claude Code 会列出将要执行的步骤,你始终掌握主动权
权限控制机制
操作类型默认行为
读取文件自动执行(无需确认)
写入 / 修改文件展示 diff,等待确认
创建新文件展示内容,等待确认
运行终端命令展示命令,等待确认
网络请求展示 URL,等待确认
删除文件展示路径,等待确认
// 可在 .claude/settings.json 中配置 allowedTools 白名单,对信任的命令跳过确认提示
CLAUDE.md — 项目指令文件

在项目根目录创建 CLAUDE.md,Claude Code 每次启动时自动读取并遵守其中的指令。

# CLAUDE.md 示例结构

## 项目概述
电商后台 API,Node.js 18 + PostgreSQL 15

## 代码规范
- ESLint Airbnb 配置,禁用 console.log
- 所有函数必须有 JSDoc 注释
- 测试覆盖率要求 ≥ 80%

## 常用命令
- 启动开发:npm run dev
- 运行测试:npm test
- 数据库迁移:npm run migrate

## 重要约定
- 不要直接修改 /migrations 目录
- API 路由变更需同步更新 docs/api.md
Slash Commands 速查
命令功能
/help显示所有可用命令和说明
/clear清除当前对话上下文,重新开始
/compact压缩对话历史以节省 Token,保留关键信息
/review对当前 git diff 做代码审查
/memory查看 / 编辑持久化记忆文件
/init为当前项目自动生成 CLAUDE.md
/config打开配置界面(主题 / 模型 / 权限)
/status显示当前对话 Token 使用量
/mcp查看已连接的 MCP 服务器列表
/doctor诊断 Claude Code 安装和配置状态
MCP — Model Context Protocol

MCP 允许 Claude Code 连接外部工具和数据源,极大扩展能力边界。

GitHub PostgreSQL Slack Notion Jira Figma
# 添加 MCP 服务器(~/.claude/mcp.json)
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_..."
      }
    }
  }
}
// 配置后可直接说「帮我查看 GitHub 上最近 5 个 PR」「把这个 bug 链接到 Jira issue」
Hooks — 自动化触发器

Hooks 在特定事件触发时自动执行 shell 命令,实现流程自动化。

# .claude/settings.json
{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Write",
      "hooks": [{
        "type": "command",
        "command": "git diff --stat"
      }]
    }],
    "PostToolUse": [{
      "matcher": "Write",
      "hooks": [{
        "type": "command",
        "command": "npm run lint --fix"
      }]
    }],
    "Stop": [{
      "hooks": [{
        "type": "command",
        "command": "osascript -e 'display notification \"Claude Code 已完成\"'"
      }]
    }]
  }
}
04 / 使用范例
范例 1:Chat + Artifacts — 日语五十音图表
  1. 新建对话 Cmd + N
  2. 输入:「创建一个交互式日语五十音图表 React 组件,点击假名时播放发音提示,用深色主题」
  3. Claude 自动在右侧 Artifact 面板生成 React 组件代码并实时预览
  4. 点击「在 Artifact 中查看」可进入全屏交互模式
  5. 如需修改,直接说「把背景色改为深蓝色」「给每个格子加上罗马音标注」
  6. 点击「复制代码」拿到完整 React 代码,粘贴到你的项目
// 关键词:「创建一个…React 组件」「生成一个…交互式页面」「写一个…可视化」— 这些描述会触发 Artifact 模式
范例 2:Projects 知识库 — 服务器运维助手
  1. 新建项目,命名「家用服务器运维」
  2. 上传文件:服务器架构图 · 网络拓扑 PDF · WireGuard 配置说明 · 常用命令手册
  3. 填写 Project Instructions:
    你是本服务器的专属运维助手。服务器:Dell Latitude 5420,Ubuntu 24.04,AU 光纤。遇到问题先排查日志,给出完整可执行命令。
  4. 新建对话,直接问「WireGuard 连不上了怎么排查?」
  5. Claude 结合你上传的配置文档给出针对性排查步骤
  6. 后续所有运维对话都在这个项目内进行,无需重复说明背景
// 每次只需描述症状,Claude 自动结合你的实际配置文档提供精准建议
范例 3:Projects 协作写作 — 书籍章节管理
  1. 新建项目「我的书 · 技术写作」
  2. 上传文件:已写章节 · 大纲 · 参考资料 · 风格指南
  3. Project Instructions 写明:写作风格、目标读者、禁止用词、章节结构要求
  4. 每写一个新章节,在项目内新建对话,说「开始写第 X 章:[主题]」
  5. Claude 自动参照已有章节风格,保持全书一致性
  6. 完成后说「对比第 2 章和第 5 章,调整风格使其统一」
// 上传的参考资料越详细,Claude 对风格的把握越准确。建议同时上传「我不喜欢的写作示例」作为反例
范例 4:Code 重构 — Python 脚本模块化
BEFORE(单文件 500 行)
# process.py — 所有逻辑混在一起
def main():
    # 数据库连接、数据处理、报告生成...
    db = connect_db("postgres://...")
    data = db.query("SELECT ...")
    # 200行处理逻辑...
    send_email(result)
操作步骤
  1. 在项目目录运行 claude
  2. 说「重构 process.py,将数据库操作、数据处理、报告生成、邮件发送分别提取为独立模块」
  3. 审查 Claude 提议的文件结构:db.py · processor.py · reporter.py · mailer.py
  4. 逐一确认每个文件的 diff 变更,接受后自动写入
  5. 说「运行 pytest 验证重构后功能一致」
AFTER(模块化结构)
# 项目结构
src/
  db.py         # 数据库连接与查询
  processor.py  # 数据处理逻辑
  reporter.py   # 报告生成
  mailer.py     # 邮件发送
  main.py       # 入口,组装调用
tests/
  test_processor.py
  test_reporter.py
范例 5:Computer Use 自动化 — 表单填写 + 截图确认
  1. 确认已在设置中启用 Computer Use,并理解授权范围
  2. 新建对话,输入:「打开 Safari,访问 example.com/form,用以下信息填写注册表单:姓名 Liu Tao,邮箱 test@example.com,然后截图给我确认」
  3. Claude 展示执行计划(将打开浏览器 → 导航到 URL → 定位表单字段 → 填写 → 截图),确认后开始执行
  4. 每步操作前 Claude 截图并说明「我即将点击这个按钮」,你可随时叫停
  5. 填写完成后 Claude 截图返回,等待你确认是否提交
  6. 你明确说「确认提交」后,Claude 才会点击提交按钮
⚠ 安全注意事项
· 表单中不要让 Claude 填写真实密码或支付信息
· 使用前关闭其他含敏感信息的窗口
· 提交前自行核查截图中的填写内容
· Computer Use 目前处于 Beta,复杂页面可能识别不准确
// Claude Desktop App Complete Guide  ·  Chat · Projects · Code · claude.ai/download