命令行安装（本页路线）
在 PowerShell、macOS Terminal 或 Linux Shell 中运行 Claude Code，适合开发、脚本集成和自动化任务。
支持 Windows、macOS 和 Linux可与项目、脚本和其他工具链配合使用安装完成后直接运行 claude安装客户端Claude Code CLI 下载安装教程
Claude Code CLI 下载安装教程
本页聚焦命令行（CLI），按系统完成安装
小贺AI编辑部 · 官方资料核对 2026-10-11 · 含教学预期
本页按系统安装 CLI；需要图形界面可选择官方桌面应用的 Code 标签。安装后继续登录与只读验证。
$ claude
Welcome to Claude Code!
>1
本页演示 CLI 安装路线
2
按系统安装 CLI
本页安装 CLI；从官方 Setup 页面选择对应系统的安装方式，桌面应用是独立路线。
Windows
x64 / ARM64
- 使用官方 CLI 安装方式
- 适合主流 Windows 10/11 系统。
- 安装后重新打开终端
macOS
Intel / Apple Silicon
- 使用官方 CLI 安装方式
- 适合 macOS 13 及以上版本。
- 安装后重新打开终端
Linux
x64 / ARM64
- 使用官方 CLI 安装方式
- 支持主流 Linux 发行版（如 Ubuntu、Debian 等）。
- 安装后重新打开终端
提示：请始终按 Claude Code 官方 Setup 页面提供的 CLI 方式安装，避免使用来源不明的脚本或安装包。
3
Windows CLI 安装步骤
打开 PowerShell
在开始菜单搜索 PowerShell，打开普通用户终端即可。
执行官方安装命令
运行官方 PowerShell 脚本；也可以改用 winget 安装。
重新打开终端
安装完成后关闭并重新打开 PowerShell，让 PATH 配置生效。
检查版本
运行 claude --version，确认 CLI 已经可以被系统找到。
Windows · PowerShell
官方 CLI 安装命令
irm https://claude.ai/install.ps1 | iex
# 或使用 winget
winget install Anthropic.ClaudeCode4
macOS / Linux CLI 安装
macOS · Homebrew
官方 CLI 安装命令
brew install --cask claude-codeLinux
官方 CLI 安装命令
curl -fsSL https://claude.ai/install.sh | bashWindows / macOS / Linux
npm 安装方式
npm install -g @anthropic-ai/claude-code5
验证是否安装成功
检查版本
在终端中运行
claude --version
claude doctor如果看到版本号，说明安装成功！
- 可以正常显示 Claude Code 版本号
- 命令行可以正常启动
- 能够正常登录并开始使用
- 如遇到问题，可查看下方常见问题
6
常见问题
为什么找不到 Claude Code 桌面版？
Claude Code 可在终端、IDE、桌面应用与网页使用。本页讲 CLI；图形界面请打开 Claude 桌面应用的 Code 标签，见 官方桌面说明。
安装时提示权限不足？
先使用普通用户终端执行安装；如果设备有组织策略，再按管理员要求处理，不要关闭安全软件。
命令行提示 command not found？
重新打开终端让 PATH 生效，再运行 Windows 的 Get-Command claude -All 或 macOS/Linux 的 type -a claude 检查安装位置。
如何更新到最新版本？
优先回到 Claude Code 官方 Setup 页面按当前说明更新，不要混用多个旧安装脚本或来源不明的包。
CLI 可以接入 API 吗？
可以。完成 CLI 安装后，再按手动 API 配置或 CC Switch 教程设置 Base URL、Key 和模型。
7
登录并完成一次只读任务
先在准备好的练习目录运行 claude。首次启动按界面选择你实际拥有的 Claude 订阅或 Anthropic Console 账户；能打印版本只证明安装，不证明账户已获访问权限。
claude --version
claude doctor
claude创建一个 README.txt，内容为 practice。进入后输入：只读当前目录，告诉我 README.txt 的内容与依据，不创建或修改文件。预期能说明 practice 与文件名；本文未逐平台实测该登录任务。
使用 API 的读者再选择官方 API 或兼容供应商路线；已有可用账号无需为了本教程改用第三方服务。若环境中存在 ANTHROPIC_API_KEY，先确认当前启动是否采用它，不要把 API 认证与订阅登录混为一条流程。