Claude Code 怎么安装？Windows、Mac 登录与费用说明

更新核验日期：2026 年 9 月 24 日

Claude Code 是 Anthropic 面向代码项目的终端与 IDE 工具。它和 claude.ai 网页聊天不是同一个入口：先安装命令行程序，再用符合条件的 Claude 账号或 Console/云平台账号登录。下面按 Windows、macOS 和 Linux 给出官方安装路径，并说明订阅额度与 API 费用的区别。

安装前先检查

Anthropic 当前文档列出的基础要求包括：macOS 13+、Windows 10 1809+、Windows Server 2019+，或 Ubuntu 20.04+、Debian 10+、Alpine Linux 3.19+；设备至少 4 GB 内存，支持 x64 或 ARM64，并需要互联网连接。Claude Code 还要求所在地属于 Anthropic 支持地区。具体系统、账号和使用资格可能变化，请以官方系统要求和支持地区列表为准。

安装前准备：

  • Windows、macOS 或 Linux 电脑，以及可用的 PowerShell/CMD、Terminal 或终端应用。
  • Windows 上 Git for Windows 是可选项；安装后可为 Claude Code 提供 Git Bash。没有它时，Windows 仍可使用 PowerShell 工具。
  • 确认你拥有可用的 Claude Code 账号或组织席位。Free 网页聊天资格不等于 Claude Code 权限。
  • 只从 Anthropic 官方文档提供的安装命令和入口安装，不运行陌生人发来的脚本。

Windows 安装

打开 PowerShell，普通用户权限即可，不要为了安装而以管理员身份运行。复制官方原生安装命令：

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

安装完成后关闭并重新打开 PowerShell，检查版本：

claude --version

如果你使用 CMD 而非 PowerShell，运行对应的 CMD 命令：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

命令不要跨终端混用：PowerShell 的 irm 在 CMD 中不能直接执行；CMD 的 && 语法在部分旧版 PowerShell 中也不同。也可以在启用 WSL 2 后，于 Linux 终端内安装，但需要在 WSL 的项目目录中运行 Claude Code；Windows 原生项目通常直接走 PowerShell 更简单。Windows 官方设置说明

macOS 或 Linux 安装

打开 Terminal，在官方文档推荐的原生安装方式中选择对应命令：

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

安装结束后重新打开终端，并确认命令可用：

claude --version
claude doctor

macOS/Linux 的启动命令和 Windows 一样。若使用 Debian/Ubuntu、Fedora/RHEL 或 Alpine，也可以按 Anthropic 文档添加其签名软件源，通过系统包管理器安装；软件源的密钥验证步骤不要跳过。原生安装会自动更新；Homebrew、WinGet 和 Linux 包管理器安装通常要按对应方式手动更新。官方安装和更新说明

这些命令会从 Anthropic 官方域名取得安装脚本并运行。安装前确认网址拼写为 claude.ai，不要把命令替换成论坛、网盘或短链提供的脚本。

登录并运行第一个项目

  1. 在终端进入你要处理的代码仓库目录。初次学习可以选一个不含密钥和客户数据的小项目。
  2. 输入 claude 并按提示选择登录方式，在浏览器中完成授权。
  3. 如果系统询问是否信任当前目录，先确认路径和项目来源；不要对来源不明的仓库授予访问权限。
  4. 首次任务先要求解释和规划，不要一开始就让工具批量改文件或执行高风险命令。

可以从只读任务开始：

先阅读项目结构和 README，只总结入口文件、主要模块和测试命令。
不要编辑文件、运行安装命令或读取 .env、密钥文件及个人数据。
如果需要执行任何命令，请先说明目的并等待我确认。

Claude Code 会根据任务读取项目内容，并可在权限允许时修改文件或运行命令。涉及真实项目时，先检查 Git 工作区和备份；审阅工具提出的 diff 与命令，再决定是否批准。不要使用 --dangerously-skip-permissions 来跳过确认。

Claude 订阅、Claude Code 和 API 怎么收费？

这是最容易混淆的部分：

  • Claude 网页/App 订阅与 Anthropic API/Console 是不同产品；购买网页订阅本身不等于获得 API 余额。
  • Claude Code 是否包含在订阅/组织席位中，取决于具体方案、账号、组织设置和所在地。个人 Pro/Max 用户可按官方说明用 Claude 账号授权；Team/Enterprise 用户需确认组织席位和管理员策略。Claude Code 当前文档也列有 Console、Bedrock、Google Cloud 和 Microsoft Foundry 等认证方式。
  • 如果使用 API Key 或云平台认证，调用可能按对应平台的用量计费，而不是扣个人网页订阅额度。特别注意：设置了 ANTHROPIC_API_KEY 时，Claude Code 可能优先使用该密钥；先确认当前认证方式和账单归属，再处理工作任务。
  • 不要只凭套餐名称、旧截图或第三方教程判断额度、价格和组织资格。登录后查看官方账号/管理员页面及个人 Pro/Max 方案说明；组织用户再查Team/Enterprise 方案说明。

常见问题排查

输入 claude 后显示找不到命令

关闭并重新打开终端，再运行 claude --version。如果仍然提示找不到命令，按官方 PATH 排错步骤检查安装目录是否已加入系统 PATH；不要重复安装多个来源不明的版本。

浏览器登录完成了，终端仍未登录

确认浏览器授权的是你期望使用的 Claude 账号或组织；返回原终端等待回调完成。若当前会话连的是 API Key，而你要使用订阅席位，可在 Claude Code 中按官方流程重新登录，并再次确认认证来源与 /status 显示。

Windows 安装命令报语法错误

先看命令提示符是 PS C:\\（PowerShell）还是 C:\\（CMD），再使用对应区块的命令。若安装返回 403、HTML 错误页或其他下载失败，查看官方安装排错文档；不要从网盘下载替代二进制包。

组织账号报 403 或没有 Claude Code 入口

可能是席位类型、组织策略或工作区管理员限制。联系组织管理员确认权限，不要用个人账号处理组织代码，也不要通过切换账号或修改网络去规避服务商规则。

用量耗尽或出现额外用量提示

先查看当前登录方式、套餐用量与付款页面，再决定等待额度重置、联系管理员，或是否明确同意启用按量计费。订阅用量和 API 消费不要混为一笔；不确定费用时不要确认购买或自动充值。

安全使用清单

  • 仅从 Anthropic 官方文档和官方包管理入口安装。
  • 不把 API Key、访问令牌、密码、验证码或 .env 内容贴进提示词或截图。
  • 让工具执行写入、删除、提交或部署前，先检查将运行的命令和文件 diff。
  • 对不熟悉的仓库先做只读总结；不要关闭权限确认来追求“全自动”。
  • 按 Anthropic 当前支持地区和组织政策使用。网络连接设置不会改变服务资格；如果你在受支持地区只是本地网络或浏览器连接异常，可按AI 工具网络排查步骤区分平台故障、账号问题与本地连接。

官方资料与继续阅读

本文为第三方教程，不是 Anthropic 官方支持页。命令、系统要求、账号资格和用量可能更新，安装及登录前请以 Anthropic 官方文档和你账号实际显示为准。

results matching ""

    No results matching ""