Claude Code 怎么用:官方安装与登录步骤
装之前先看系统要求
Claude Code 是 Anthropic 出的终端编程工具。官方安装文档对系统、硬件和终端都有要求,支持的系统版本和硬件配置以官方安装文档页面为准,终端可以用 Bash、Zsh、PowerShell 或 CMD。除此之外还有一条:所在地必须在 Anthropic 支持的国家和地区内。
所在地这一条最容易被忽略。按 2026-11-16 的支持地区页,中国大陆、香港、澳门不在名单里,台湾在。所在地不在名单内属于官方不提供服务,官方排错页写到这时安装命令可能直接返回 App unavailable in region,本站不提供用代理绕开地区限制的方法。
官方给的几种安装方式
- 原生安装(官方推荐):macOS、Linux、WSL 在终端运行文档给出的安装命令,Windows 在 PowerShell 或 CMD 里运行对应命令,不需要管理员权限,装好后会在后台自动更新;
- Homebrew 与 WinGet:用包管理器安装;
- npm:要先装好 Node.js,版本要求以官方文档为准,官方提醒不要加 sudo。
Debian、Fedora、RHEL、Alpine 还可以用官方签名的 apt、dnf、apk 软件源安装,分稳定版和最新版两个频道。Homebrew 和 WinGet 装的不会自动更新,要自己定期升级。安装命令请从官方安装文档页面复制,不要用来源不明的一键脚本。不想用终端的,官方还提供桌面版 App,可以在图形界面里使用 Claude Code,下载入口同样在官方文档里。
装好后怎么确认
新开一个终端窗口,运行 claude --version,能打印出版本号就说明装上了。提示找不到命令,多半是安装目录还没加进 PATH,官方的安装排错页有对应说明。想做更完整的检查,可以运行 claude doctor,它会列出安装状态和设置文件里的问题。
第一次登录
在项目目录里运行 claude,它会打开浏览器让你登录。浏览器没自动弹出时,按 c 复制登录链接手动打开;登录完成后终端显示 Login successful。需要退出时在 Claude Code 里输入 /logout。能登录的是付费的个人订阅、团队账号或 API 控制台账号,免费版不含 Claude Code,具体哪些方案包含以官方定价页面为准。
以上按 Anthropic 官方页面 2026-11-16 的版本整理,以官方页面为准。