以官方方式使用 Claude Code 需要三步：付费套餐，因为免费套餐不包含它，最便宜的是 Pro，每月 20 美元，按年付费为每月 17 美元；然后是 claude.ai 上适用于你系统的官方安装命令；最后是首次启动时通过浏览器登录。沙特阿拉伯在 Anthropic 支持的地区名单上，所以你不需要中间人，也不需要借用别人的账户。之后，从官方插件市场安装 Claude Code Setup 插件，让它读取你的项目并推荐合适的配置，而且不会改动任何一个文件。

为什么一定要走官方途径？

Anthropic 的支持地区政策规定，其产品（包括网页应用、Claude Code 和 API）只在名单所列国家提供，沙特阿拉伯与阿联酋、科威特、卡塔尔、巴林和阿曼一同在列。该政策还规定，即使账户属于受支持的机构，从未列入名单的国家使用也属于不受支持的使用。如果你身在王国境内并使用自己的账户，那就走在正确的路上，没有理由采用可能导致账户被停用的变通办法。

还有第二个原因：官方安装程序会在后台自动更新工具，安全修复一发布就能送到你手上。而插件可能在你的电脑上运行自动命令和外部连接服务器，因此官方文档建议在安装插件前先阅读其详情，最稳妥的起点是 Anthropic 的官方插件市场。

安装前需要准备什么？

根据官方安装页面，运行要求如下：

要求详情
操作系统macOS 13.0 或更高版本，Windows 10 版本 1809 或更高版本，Windows Server 2019，或 Ubuntu 20.04、Debian 10、Alpine 3.19 及更高版本
硬件至少 4 GB 内存，x64 或 ARM64 处理器
网络可用的互联网连接
命令行Bash、Zsh、PowerShell 或 CMD
账户Pro、Max、Team、Enterprise 或 Console 账户

Claude Code 要花多少钱？

工具本身可以免费下载，但运行它需要付费账户。以下是官方价格页面列出的套餐：

套餐价格包含 Claude Code 吗？
Free免费否
Pro每月 20 美元，按年付费为每月 17 美元（预付 200 美元）是
Max每月 100 美元起，用量为 Pro 的五倍或二十倍是
Team 和 Enterprise按席位计费，集中管理和计费是

个人用户先用 Pro 就够了。对于公司，登录指南推荐 Team 或 Enterprise，因为它把计费和权限集中在一个面板里，并能为所有开发者强制统一设置。

如何一步步安装 Claude Code？

打开终端，粘贴适合你系统的命令。下面的命令逐字摘自官方文档，都不需要管理员权限。

在 Mac、Linux 或 WSL 上

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

在 Windows 上

在 PowerShell 中（路径前显示 PS 即可识别）：

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

在 CMD 中：

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

文档建议安装 Git for Windows，让工具能够运行 Bash 命令；没有它时，工具通过 PowerShell 运行。

通过 Homebrew 或 WinGet

你也可以在 Mac 上用 brew install --cask claude-code，或在 Windows 上用 winget install Anthropic.ClaudeCode 安装。请注意，这两种方式不会自动更新工具，需要你自己运行升级命令；而且 Homebrew 的稳定版通常比最新版本晚大约一周。

安装程序下载时不显示进度条，看起来像卡住了也不用担心。完成后，先打开一个新的终端窗口再进行下一步。

如何用你的账户登录？

  1. 在终端中进入项目文件夹，输入 claude。
  2. 工具会打开浏览器窗口，让你用 claude.ai 账户登录。如果没有打开，按 c 复制链接并粘贴到浏览器中。
  3. 如果浏览器显示一个代码而不是自动跳回，请把它粘贴到终端中 Paste code here if prompted 这一行。这种情况多见于 WSL2、SSH 会话或容器中。
  4. 出现 Login successful 后，按 Enter 开始工作。

要退出登录，在会话中输入 /logout。如果你有一个工作账户和一个个人账户，官方做法是通过 CLAUDE_CONFIG_DIR 变量为每个账户分配独立的设置文件夹，例如下面这个别名：

alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'

如何确认安装正常？

claude --version
claude doctor

第一条命令会输出版本号，例如 2.1.211；第二条命令在不启动会话的情况下检查安装和设置文件，并列出每条警告及其解决方法。

什么是 Claude Code Setup 插件？

Claude Code Setup 是 Anthropic 在插件市场中的官方插件，它会分析你的项目并推荐适合的自动化方案。它读取 package.json 等文件、文件夹结构和编程语言，然后在五个类别中各给出最好的一到两条建议，正如其官方仓库所说明的：

类别作用插件中的示例
MCP 服务器把工具连接到外部服务context7 用于文档，Playwright 用于前端测试
技能（Skills）按需加载的现成专业能力规划技能和界面设计技能
钩子（Hooks）每次修改时自动执行的操作自动格式化代码，阻止改动敏感文件
子代理专门的审查者安全、性能和无障碍审查
斜杠命令重复任务的快捷方式/test、/pr-review 和 /explain

最重要的是，它只读：只提建议，不改动你的任何文件，决定权在你手里。如果你专门问某一个类别，它会把选项扩展到三到五个。

如何安装和使用 Claude Code Setup 插件？

  1. 在项目中运行 claude，然后输入：
/plugin install claude-code-setup@claude-plugins-official
  1. 插件详情面板会打开：它将添加什么、最近一次更新时间，以及会占用多少上下文。同意前请先阅读。
  2. 选择安装范围：在你所有项目中为你安装、为在此仓库工作的所有人安装，或只在此仓库中为你安装。
  3. 安装后，输入类似 recommend automations for this project 的请求，或者问：what hooks should I use?

官方插件页面说明，如果安装摘要提示需要，插件可能要用 /reload-plugins 重新加载。

最常见的安装错误有哪些，如何解决？

  • claude not found： 安装目录还没有加入 PATH。打开一个新的终端窗口；如果问题依旧，请查看文档中修复 PATH 的部分。
  • The token '&&' is not a valid statement separator： 你在 PowerShell 中使用了 CMD 命令，请改用 PowerShell 命令。
  • 'irm' is not recognized： 正好相反，你在 CMD 中使用了 PowerShell 命令。
  • 免费套餐： 用免费账户登录是不够的，因为其中不包含 Claude Code。
  • 版本过旧： 如果你是通过 Homebrew 或 WinGet 安装的，请手动运行 brew upgrade claude-code 或 winget upgrade Anthropic.ClaudeCode 升级。

如果你完全不喜欢命令行，官方桌面应用在 Mac、Windows 和 Linux 上提供带图形界面的 Claude Code。我们在Claude Code 2026 年 8 月新功能一文中介绍了该工具的最新更新。

资料来源