Magic Cloud 文档

主题

安装 Claude Code ​

平台里的所有技能（Skills）与工作台都是给 Claude Code 用的。动手装技能之前， 先把 Claude Code 本身装好并能正常登录。

本页依据官方文档整理：Claude Code 概述。 安装选项、手动更新、卸载等更多细节以官方 高级设置 与 安装故障排除 为准。

开始前：网络与账号 ​

  • 网络：默认配置下，Claude Code 的安装、登录和日常使用都需要访问 claude.ai、Anthropic API 等端点。在中国大陆网络环境下这些端点可能无法直连，请先确认网络能连通。企业代理、 Amazon Bedrock 等第三方提供商的网络要求见官方 网络配置。
  • 账号：需要 Claude 订阅 或 Anthropic 控制台 账户。终端 CLI、VS Code、JetBrains 也支持 第三方提供商。

终端 CLI（推荐） ​

平台的技能都跑在终端 CLI 里，优先装这个。

原生安装（推荐） ​

macOS、Linux、WSL：

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

Windows PowerShell：

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

Windows CMD：

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

分不清当前是哪种终端？PowerShell 的提示符是 PS C:\，CMD 是 C:\（没有 PS）。 报 The token '&&' is not a valid statement separator 说明你在 PowerShell 里； 报 'irm' is not recognized as an internal or external command 说明你在 CMD 里。

原生安装会在后台自动更新，始终保持最新版本。

Windows 用户务必装 Git for Windows

本平台主推 Windows + Git Bash：技能的命令都在 bash 里执行。原生 Windows 上请安装 Git for Windows，Claude Code 才会用 Bash 作为 shell 工具； 没装时它会退回 PowerShell，技能里的 bash 命令就跑不起来。（WSL 不需要 Git for Windows。）

Homebrew（macOS） ​

bash
brew install --cask claude-code
  • claude-code 跟踪稳定渠道，通常比最新版晚约一周，并跳过有重大回归的版本； claude-code@latest 跟踪最新渠道，新版本发布即可收到。
  • Homebrew 安装不会自动更新，需手动执行 brew upgrade claude-code （或 brew upgrade claude-code@latest，取决于装的是哪个）。

WinGet（Windows） ​

powershell
winget install Anthropic.ClaudeCode

WinGet 安装不会自动更新，请定期执行 winget upgrade Anthropic.ClaudeCode。

Linux 包管理器 ​

Debian、Fedora、RHEL、Alpine 也可以用 apt、dnf、apk 安装，见官方 用 Linux 包管理器安装。

验证安装 ​

装完后打开一个新的终端窗口，执行：

bash
claude --version

正常会打印一个版本号。

  • 提示找不到 claude / 无法识别：安装目录还不在 PATH 里，按官方 修复 PATH 处理。
  • 安装命令本身报 syntax error near unexpected token '<'、403 或其它错误：到官方 排查安装问题 对照错误找修复方法和替代安装方式。

启动与登录 ​

进入任意项目目录启动（把 your-project 换成你机器上的项目路径）：

bash
cd your-project
claude

首次使用会提示登录。如果已设置 ANTHROPIC_API_KEY 环境变量，并在 Claude Code 询问是否使用该密钥时同意， 就会跳过登录提示。接下来可以照官方 快速入门 跑第一个任务。

其它使用方式 ​

方式怎么装说明
VS Code / Cursor 扩展扩展视图（Ctrl+Shift+X，Mac 为 Cmd+Shift+X）搜索「Claude Code」装好后命令面板输入「Claude Code」→「在新标签页中打开」。见 VS Code
JetBrains 插件JetBrains Marketplace 安装 Claude Code 插件 后重启 IDE需另装上面的终端 CLI。见 JetBrains
桌面应用下载 macOS / Windows x64 / Windows ARM64自带 Claude Code，无需另装 CLI；登录后点「代码」标签。需付费订阅
网页浏览器打开 claude.ai/code无需本地安装

本平台的技能装在本机 ~/.claude/skills/，由本机的 Claude Code（终端 CLI / IDE 扩展 / 桌面应用）读取； 网页版跑在云端，用不到本机技能。

下一步 ​

Claude Code 能正常启动后，安装整套技能。