AI 开通手册Max Talk 免费教程
按需查 / 装工具
最后验证 2026-11-16

安装 Claude Code 桌面版

Claude Code 桌面版就在 Claude 桌面 App 里,侧边栏顶上的 Code 页签。装好 App、登录付费账号、选一个文件夹,就能让它动手改文件,不用碰终端。

耗时
约 15 分钟
适合谁
开了 Claude Pro、Max、Ultra 的人
要准备什么
  • 线路已经通(主线第 2 步)
  • Claude 付费账号(第 4 步),免费档用不了 Claude Code
  • 一台 Mac 或 Windows 电脑

先说清楚Anthropic 只在它列出的国家和地区提供 Claude 和 Claude Code,名单里没有中国大陆和香港(官方名单,2026-11-16 查)。请遵守当地法律和 Claude 的使用条款。注册不了 Claude 的,看 国产模型接进 Claude Code。

1

下载 Claude 桌面 App

系统下哪个
Mac通用版,Intel 和 Apple 芯片都能装
Windows一般电脑下 x64 版;ARM 芯片的笔记本下 ARM64 版。也能从 Microsoft Store 装
Linux测试版,只支持 Ubuntu 和 Debian

来源:claude.com/download、官方桌面版上手文档,2026-11-16 查。桌面 App 的最低系统版本这两页没写,以官方帮助中心为准。

  1. 打开 claude.com/download,下你系统那一版。只认这个地址。
  2. Mac:双击安装包,把 Claude 拖进「应用程序」。Windows:双击安装程序,一路下一步。
你应该看到Mac 的「应用程序」或 Windows 开始菜单里有 Claude。
2

登录

  1. 打开 Claude,用你开会员的那个账号登录(Gmail 注册的就点 Google 登录)。
  2. 可能会跳到浏览器里确认,确认完回到 App。
你应该看到Claude 的聊天界面,设置里显示 Pro(或 Max、Ultra)。
3

打开 Code 页签

点侧边栏顶上的 Code。页签只显示图标的话,鼠标停在上面会出名字。

  • 弹出升级提示:这个账号还是免费档,回 开会员。
  • 弹出要你在网页上登录:照着登完,重启 App。
  • 报 403:一般是网络或地区问题,见下面「卡住了」。

桌面 App 自带 Claude Code,不用另外装 Node.js,也不用装命令行版。

你应该看到一个新会话界面,输入框下面有一排小控件。
4

选环境和文件夹

  1. 输入框下面那排,第一个是环境选择,选 Local 分组里最上面那一项(在你自己电脑上跑)。
  2. 旁边是文件夹,点开选 Open folder…,选桌面上那个空的「AI 练手」。
  3. 再往右有模型选择,默认的就行。

新会话下面看不到环境选择,说明你的 App 是旧版布局,选文件夹的位置以你看到的为准,先把 App 更新到最新。

你应该看到输入框下面显示的文件夹是「AI 练手」。
5

选权限模式

同一排里有权限模式,官方给了四种:

模式它会怎么做什么时候用
Manual改文件、跑命令之前都先问你第一次用,选这个
Accept edits改文件自动接受,你事后看改动熟了以后
Plan只出方案,不改任何文件大活动手前先看思路
Auto后台有个检查器拦有风险的操作,不再问你新手先别用

来源:官方桌面版上手文档,2026-11-16 查。

你应该看到权限显示 Manual。发一句「列出当前文件夹里的文件」,它回答文件夹是空的。

顺带:命令行版怎么装

用惯终端、或者想在服务器上用的,可以装命令行版。和桌面版用同一个账号。走近路接国产模型的别照这里装,看 那一页。

1

先看系统

macOS 13 以上;Windows 10 的 1809 版以上;4 GB 以上内存(官方安装文档,2026-11-16 查)。Windows 上官方建议顺手装一个 Git for Windows。

2

粘一行命令

Mac:打开「终端」,粘:

curl -fsSL https://claude.ai/install.sh | bash

Windows:打开 PowerShell(提示符前面有 PS),粘:

irm https://claude.ai/install.ps1 | iex

Mac 用 Homebrew 的也可以 brew install --cask claude-code,Windows 也可以 winget install Anthropic.ClaudeCode,这两种不会自动更新。

安装过程不显示进度,等它跑完,新开一个终端窗口,输入 claude --version。

你应该看到打出一个版本号,比如 2.1.x (Claude Code)。
3

登录

在终端里进到练手文件夹,输入 claude,跟着提示在浏览器里登录。第一次在一个文件夹里打开,它会问你信不信任这个文件夹,选信任。

你应该看到终端里出现 Claude Code 的输入框。

发截图问人之前:把登录邮箱、终端里的用户名路径打码。

卡住了

点 Code 报 403,或者登录报错
多半是网络:线路没开、出口地区不在支持名单里,或者 App 没走线路。先在浏览器里确认 claude.ai 能打开,再查出口 IP(查出口 IP 和泄露)。确认没问题还报错,退出登录再登一次。
命令行安装报 App unavailable in region
官方文档的解释是你所在地区不支持。下载这一步也要走线路,确认终端也在走代理(终端不一定跟着系统代理走,客户端里一般有「复制终端代理命令」一类的按钮,具体见 电脑客户端)。
装完输入 claude 提示 command not found
先关掉终端重新开一个再试。还不行,是安装目录没进 PATH,官方排查页有现成的修法:Troubleshoot installation。也可以先跑一下 claude doctor,它会告诉你哪里不对。
Windows 上报 '&&' 不是有效分隔符,或者 irm 不是内部命令
命令贴错了窗口。看提示符:前面有 PS 的是 PowerShell,用 irm 那一行;没有 PS 的是 CMD,CMD 的命令见官方安装文档。
Code 页签里找不到选文件夹的地方
App 不是最新版。在菜单里检查更新,更新完重开。

做完检查一下

去跑第一件小事 回到装工具