小贺AI产品与教程中心
进入小贺API
首页小贺AI小贺APIAI知识库画图提示词MCPSkills配置教程AI动态
打开小贺AI进入小贺API
安装客户端

Claude Code CLI 下载安装教程
仅提供命令行（CLI），按系统完成安装

先按你的系统选择 Claude Code 的官方安装方式，安装结束后运行 claude --version 验证命令是否可用。

小贺AI编辑部 · 实测更新 2026-09-16 · 阅读约 10 分钟
Claude Code 目前没有独立桌面 App，请按系统完成 CLI 安装，再进行登录与验证。
查看系统安装方式 查看验证方法
1

Claude Code 只有 CLI 版本

Claude Code 目前没有独立桌面 App，官方主要通过命令行（CLI）使用，请按你的操作系统完成安装。

命令行安装（唯一使用方式）

在 PowerShell、macOS Terminal 或 Linux Shell 中运行 Claude Code，适合开发、脚本集成和自动化任务。

支持 Windows、macOS 和 Linux可与项目、脚本和其他工具链配合使用安装完成后直接运行 claude
2

按系统安装 CLI

Claude Code 没有桌面安装包，请从官方 Setup 页面选择对应系统的 CLI 安装方式。

Windows

x64 / ARM64

  • 使用官方 CLI 安装方式
  • 适合主流 Windows 10/11 系统。
  • 安装后重新打开终端
查看安装说明

macOS

Intel / Apple Silicon

  • 使用官方 CLI 安装方式
  • 适合 macOS 12 及以上版本。
  • 安装后重新打开终端
查看安装说明

Linux

x64 / ARM64

  • 使用官方 CLI 安装方式
  • 支持主流 Linux 发行版（如 Ubuntu、Debian 等）。
  • 安装后重新打开终端
查看安装说明

提示：请始终按 Claude Code 官方 Setup 页面提供的 CLI 方式安装，避免使用来源不明的脚本或安装包。

3

Windows CLI 安装步骤

Windows 没有 Claude Code 独立 App，请在 PowerShell 中安装并使用 CLI。

1

打开 PowerShell

在开始菜单搜索 PowerShell，打开普通用户终端即可。

2

执行官方安装命令

运行官方 PowerShell 脚本；也可以改用 winget 安装。

3

重新打开终端

安装完成后关闭并重新打开 PowerShell，让 PATH 配置生效。

4

检查版本

运行 claude --version，确认 CLI 已经可以被系统找到。

Windows · PowerShell

官方 CLI 安装命令

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

# 或使用 winget
winget install Anthropic.ClaudeCode
4

macOS / Linux CLI 安装

macOS 和 Linux 同样使用命令行安装，不需要下载桌面应用。

macOS · Homebrew

官方 CLI 安装命令

brew install --cask claude-code
Linux

官方 CLI 安装命令

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

npm 安装方式

npm install -g @anthropic-ai/claude-code
5

验证是否安装成功

安装完成后，通过以下命令检查版本与环境健康状态。

检查版本

在终端中运行

claude --version\nclaude doctor

如果看到版本号，说明安装成功！

  • 可以正常显示 Claude Code 版本号
  • 命令行可以正常启动
  • 能够正常登录并开始使用
  • 如遇到问题，可查看下方常见问题
6

常见问题

以下是 CLI 安装过程中最常遇到的问题和解决方法。

为什么找不到 Claude Code 桌面版？

Claude Code 目前没有独立桌面 App，官方主要提供 CLI。请打开 PowerShell、Terminal 或 Linux Shell，按本文命令安装和使用。

安装时提示权限不足？

先使用普通用户终端执行安装；如果设备有组织策略，再按管理员要求处理，不要关闭安全软件。

命令行提示 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

安装后下一步

安装完成后，建议继续完成配置并开始使用。

手动配置 API不依赖网页登录，手动配置 Claude Code 接入到目标 API。查看教程 用 CC Switch 配置使用 CC Switch 配置并管理多个 Provider，提升使用效率。查看教程 API 报错排查如遇到 401/403/404/429 等错误，查看详细排查指南。查看教程

已经安装 Claude Code？继续配置并开始使用

完成安装后，通过 CC Switch 或手动配置 API，开始处理你的真实项目。

前往配置教程