AMZ
用户中心
AI 与自动化

Claude Code安装教程：Mac、Windows、VS Code从零开始

摘要：跑通第一个安全闭环 关键词：Claude Code安装、Claude Code Windows、Claude Code VS Code

公众号文章库2026/7/710 分钟阅读

摘要：跑通第一个安全闭环
关键词：Claude Code安装、Claude Code Windows、Claude Code VS Code

开头：安装成功不算会用，跑通闭环才算入门

很多新手安装 AI 编程工具，最容易卡在两个地方：命令行害怕输错，装完不知道做什么。

Claude Code 的学习目标不应该是“装成功截图”，而是跑通第一个完整闭环：打开项目、让它读文件、提出计划、做一个小修改、运行验证、总结结果。

对跨境卖家来说，这篇不是程序员安装手册，而是一套从零开始的安全练习路线。目标是让你在不碰真实店铺数据、不改生产项目、不暴露密钥的前提下，体验 Claude Code 如何进入工作流。

安装前准备

先准备四样东西。

第一，账号权限。官方文档写明，Claude Code 需要 Pro、Max、Team、Enterprise 或 Console 账号；免费 Claude.ai 计划不包含 Claude Code 访问权限。

第二，电脑环境。官方文档列出的系统要求包括 macOS 13.0+、Windows 10 1809+ 或 Windows Server 2019+、Ubuntu 20.04+、Debian 10+、Alpine Linux 3.19+；硬件要求是 4GB 以上内存，x64 或 ARM64 处理器；需要网络连接。

第三，终端环境。Mac 用 Terminal，Windows 可以用 PowerShell、CMD，也可以用 WSL。官方文档支持 Bash、Zsh、PowerShell 或 CMD。

第四，低风险练习目录。不要一上来打开真实业务项目。先建一个临时文件夹，里面放脱敏样例文件。

如果你是完全新手，先不要追求 VS Code、GitHub Actions、MCP、Hooks。第一目标是跑通最小闭环。

Mac、Linux、Windows怎么装

安装命令以官方文档为准，不要从来路不明的文章复制脚本。

官方文档给出的主要安装方式包括 Native Install、Homebrew、WinGet，以及 Linux 包管理器等。

Mac、Linux、WSL 常见命令是：

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

Windows PowerShell 常见命令是：

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

Windows CMD 常见命令是：

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

如果你用 Homebrew：

brew install --cask claude-code

如果你用 WinGet：

winget install Anthropic.ClaudeCode

这里要注意两点。

第一，PowerShell 和 CMD 命令不一样。官方文档也提醒，如果你看到 && 不是有效语句分隔符，说明你在 PowerShell；如果 irm 不识别，说明你在 CMD。

第二，Homebrew 和 WinGet 安装默认不会像 Native Install 那样自动更新，需要你定期运行升级命令。

Windows用户怎么选：原生Windows还是WSL

Windows 用户最容易纠结：到底用原生 Windows，还是 WSL？

官方文档的建议可以翻译成这样：

  • 如果你的项目是 Windows 原生工具、Excel、PowerShell、本地文件处理，原生 Windows 更直接；
  • 如果你的项目依赖 Linux 工具链，或者你需要 sandboxed command execution，WSL 2 更合适；
  • WSL 安装要在 WSL 发行版里执行 Linux 安装命令，不是在 PowerShell 里装完再拿去 WSL 用。

官方还提到 Git for Windows 是推荐项，尤其在原生 Windows 上，它能让 Claude Code 使用 Git Bash；如果没有 Git for Windows，Claude Code 会通过 PowerShell 工具运行 shell 命令。

对卖家新手，我建议先这样选：

  • 只是做 CSV、Markdown、图片命名、公众号 HTML：原生 Windows + PowerShell 足够；
  • 要做 Node.js、Python、Linux 风格工具链：优先 WSL 2；
  • 不确定：先用原生 Windows 练第一个闭环，不要一开始折腾复杂环境。

安装后先验证，不要马上做项目

安装完成后，先做两个验证。

claude --version

如果这个命令失败，说明安装路径或终端环境还没通。

再运行：

claude doctor

官方文档建议用 claude doctor 做更详细的安装和配置检查。这个步骤很适合新手，因为很多问题不是工具坏了，而是终端、路径、权限、更新渠道、依赖没有配置好。

验证通过后，再运行：

claude

按照浏览器提示完成登录或授权。

第一个练习任务

不要用真实项目练手。先创建一个安全练习目录。

例如：

claude-code-practice/
  notes.md
  sample-ads.csv
  README.md

notes.md 可以写几行杂乱需求：

我想做一个广告搜索词周报工具。
输入是 CSV。
要找出花费高但没有订单的词。
还要找 ACOS 高的词。
输出 Markdown 报告。

sample-ads.csv 可以写几行脱敏数据：

campaign,ad_group,search_term,spend,sales,orders,clicks,impressions
Auto,A,wireless charger,23.50,0,0,18,1200
Manual,B,fast charger,8.20,39.99,1,6,300
Manual,B,usb c cable,15.00,18.00,1,12,900

然后在这个目录里启动 Claude Code，先让它只读不改：

请先不要修改任何文件。

请阅读当前目录，告诉我：
1. 每个文件的作用；
2. 这个练习项目的业务目标；
3. 你认为可以做成什么最小工具；
4. 需要我确认哪些规则；
5. 如果要实现，建议创建或修改哪些文件。

这一步的目的，是确认 Claude Code 读到了正确目录，并且不会一上来乱改。

第一个可执行闭环：生成周报

当 Claude Code 给出计划后，你可以让它做最小版本：

方案确认。
请只做最小可运行版本。

目标：
读取 sample-ads.csv，生成 weekly-report.md。

报告分为：
1. 高花费无订单；
2. 有订单但 ACOS 偏高；
3. 低花费有转化；
4. 继续观察。

要求：
- 只在当前练习目录内创建或修改文件；
- 不要访问网络；
- 不要删除文件；
- 完成后运行验证命令；
- 总结你改了什么、怎么验证、还有什么风险。

这个任务很安全，但能让你体验完整流程：读取文件、计划修改、编辑文件、运行验证、总结变化。

这才是 Claude Code 入门的关键。

VS Code怎么用

Claude Code 支持 IDE 集成，VS Code 是新手最容易接受的入口之一。

使用时可以这样理解：

  • 终端负责启动 Claude Code 和运行命令；
  • VS Code 负责查看文件、差异和项目结构；
  • Claude Code 负责在你授权下读项目、写方案、改代码和解释变更。

第一次使用 VS Code，不要打开复杂项目。打开练习目录即可。

建议你重点看三件事：

  • Claude Code 准备修改哪些文件；
  • 修改前后 diff 是否合理；
  • 生成的文件能不能按命令运行。

如果你看不懂每一行代码，也至少要能看懂输入、输出、文件名和验证结果。

权限提示怎么看

Claude Code 可以运行命令、编辑文件，所以不要一路无脑确认。

遇到权限提示时，先问自己：

  • 它要改哪个文件；
  • 这个文件是否在练习目录；
  • 它要运行什么命令；
  • 命令是否会删除、移动、上传、联网或修改大量文件；
  • 这一步是否和任务目标相关；
  • 我是否有备份或 Git 记录。

新手可以默认拒绝这些动作：

  • 删除目录；
  • 批量改大量文件；
  • 访问真实店铺数据；
  • 读取包含密钥的文件；
  • 部署到线上；
  • 修改支付、广告预算、账号授权相关代码。

工具越强，越要慢一点确认。

新手最容易犯的错

第一，直接打开真实项目让它乱试。建议先用练习项目。

第二，不看权限提示就一路确认。你要知道它准备运行什么命令、改哪些文件。

第三，不保存原始文件。重要项目先用 Git 或备份保护。

第四，把密钥、账号、客户数据放在练习目录里。不要这样做。

第五，只看“代码写出来了”，不看验证结果。没有验证的修改，不能算完成。

第六，安装成功后不知道练什么。建议先练 CSV 周报、Markdown 整理、Listing 风险词检查这类低风险任务。

一套适合卖家的7天练习路线

第一天，安装并跑 claude --version、claude doctor。

第二天，创建练习目录，让 Claude Code 只读文件并解释目录。

第三天，让它整理一个 notes.md，体验小文件修改。

第四天，让它读取 sample-ads.csv，生成 Markdown 周报。

第五天，故意改坏一个字段名，让它定位错误并修复。

第六天，让它写 README.md 使用说明。

第七天，把练习流程复盘成团队 SOP：输入文件、提示词、验证命令、风险边界。

跑完这 7 天，你才真正理解 Claude Code 的基本协作方式。

不要误读

第一，安装命令会更新，最终以官方文档为准。文章里的命令是当前官方文档中的常见方式，不要脱离官方来源复制未知脚本。

第二，装好 Claude Code 不等于可以直接处理真实店铺数据。先脱敏，先本地，先低风险。

第三，VS Code 不是必须，但它能让新手更容易看清文件变化。终端、IDE、Desktop、Web 只是不同入口，核心仍然是读项目、出计划、改文件、跑验证。

结论

Claude Code 安装的真正目标，是让你跑通“读项目、出计划、改文件、做验证”的第一个闭环。

一旦你理解这个流程，就可以把它从代码工具扩展到运营小工具、资料整理脚本和内部自动化流程。

新手不要追求第一天做大项目。先让它在一个练习目录里，把一份脱敏 CSV 变成一份可读周报。这个小闭环跑通，比收藏十篇安装教程更有用。

参考资料