标题显式匹配：参考资料 的标题为《【Claude Code 安装教程】：Mac 和 Windows 双平台完整指南（2026最新）》，其中显式包含了用户提问中的核心实体词“Claude Code”、“Mac”、“Windows”、“安装教程”及“双平台完整指南”。因此，根据优先级1，立即判定为相关，进入路径A。

Claude Code 是 Anthropic 官方推出的终端 AI 编程助手，能直接在您的本机终端里运行，读取代码库、编写代码、运行测试和修复 Bug。下面为您提供其在 macOS 和 Windows 两大平台上的完整安装与配置指南 。

一、安装前准备

在开始安装前，请务必确认满足以下前置条件。

检查项 要求与说明
付费账号 Claude Code 不支持免费账号。您需要至少拥有 Claude Pro（个人订阅，$20/月）、Claude Max、Claude Teams、Claude Enterprise 或有效的 Anthropic Console API 密钥等付费账户之一 。
系统版本 macOS：需 13.0 Ventura 或更高版本。
Windows：需 Windows 10 1809+ 或 Windows Server 2019+ 。
网络与地区 全程需要联网，且中国大陆用户需要配置代理才能访问 Anthropic 服务 。

二、macOS 安装教程

macOS 用户可根据自身习惯选择以下三种安装方式之一。

安装方式 适用人群 核心命令 更新方式
原生安装脚本 所有用户，官方推荐 `curl -fsSL https://claude.ai/install.sh bash`
Homebrew 安装 已使用 Homebrew 包管理器的用户 brew install --cask claude-code 手动运行 brew upgrade claude-code
npm 安装 开发者，已有 Node.js 18+ 环境 npm install -g @anthropic-ai/claude-code 手动运行 npm update -g @anthropic-ai/claude-code

具体步骤示例（以原生安装脚本为例）：

  1. 打开终端（Terminal）。
  2. 执行安装命令 。 
    # 下载并执行官方安装脚本 
curl -fsSL https://claude.ai/install.sh | bash
  3. 安装完成后，重新打开一个终端窗口以使 PATH 环境变量生效。
  4. 验证安装是否成功 。 
    # 检查版本 
claude --version
# 运行环境健康检查 
claude doctor

注意：若通过 npm 安装，请确保 Node.js 版本 ≥ 18，并避免使用 sudo 进行全局安装，以防权限问题。推荐使用 nvm 管理 Node.js 版本 。

三、Windows 安装教程

Windows 用户可根据项目环境选择原生 Windows 或 WSL 2 安装路径。

方案一：原生 Windows 安装（项目在Windows本地）

此方案要求先安装 Git for Windows，因为 Claude Code 内部依赖 Git Bash 执行命令 。

  1. 安装 Git for Windows：从 git-scm.com 下载并安装，保持默认选项即可 。
  2. 选择并执行安装命令：
    • PowerShell（推荐）：以管理员身份打开 PowerShell，运行以下命令 。 
      irm https://claude.ai/install.ps1 | iex
    • 命令提示符（CMD）：打开 CMD，运行以下命令 。 
      curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
    • WinGet（Windows 包管理器）：适用于 Windows 10/11，命令更简洁 。 
      winget install Anthropic.ClaudeCode
  3. 安装完成后，关闭并重新打开终端，然后验证安装。 
    claude --version

方案二：WSL 2 安装（项目在Linux环境或需沙箱功能）

如果您的开发项目基于 Linux 工具链，或需要 Claude Code 的沙箱执行功能（原生 Windows 不支持），推荐使用 WSL 2 。

  1. 启用 WSL 2：以管理员身份打开 PowerShell 并运行 wsl --install，完成后重启电脑 。
  2. 从开始菜单打开 Ubuntu（默认发行版）终端。
  3. 在 WSL 的 Ubuntu 终端中，执行与 macOS 相同的原生安装命令 。 
    curl -fsSL https://claude.ai/install.sh | bash
  4. 安装后，可在 WSL 中直接访问 Windows 文件，例如：cd /mnt/c/Users/YourName/Projects。
对比维度 原生 Windows WSL 2
前置要求 Git for Windows 启用 WSL 2
沙箱执行 ❌ 不支持 ✅ 支持
适合场景 Windows 原生项目 Linux 项目、Docker、需要沙箱

四、首次启动与认证

安装完成后，进入您的项目目录并启动 Claude Code 以完成认证。

cd /path/to/your-project
claude

认证方式一：浏览器认证（个人用户推荐）

首次运行 claude 命令时，终端会自动打开默认浏览器，跳转到 Anthropic 授权页面。使用您的 Claude Pro/Max 等付费账号登录并点击 “Authorize”（授权） 即可 。授权成功后，终端将进入交互模式。

认证方式二：API Key 认证（服务器/CI环境推荐）

对于无图形界面的服务器或 CI/CD 环境，需使用 API Key 。

  1. 获取 API Key：登录 Anthropic Console，在 API Keys 页面创建并复制密钥（格式如 sk-ant-api03-...）。
  2. 设置环境变量：
    • macOS/Linux/WSL（永久生效）： 
      echo 'export ANTHROPIC_API_KEY="你的API密钥"' >> ~/.zshrc
source ~/.zshrc
    • Windows PowerShell（永久生效）： 
      [Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "你的API密钥", "User")
  3. 设置后，Claude Code 将自动使用该密钥进行认证。

五、安装后的关键配置

完成认证后，进行以下配置以提升使用体验。

  1. 健康检查：运行 claude doctor 命令，全面检查网络、认证状态、依赖工具等环境健康状况 。
  2. 初始化项目上下文（强烈推荐）：在项目根目录的 Claude Code 交互模式中，输入 /init 命令。Claude Code 会自动分析项目结构，生成一个 CLAUDE.md 文件，用于记录项目构建命令、代码规范和目录结构，使 AI 能持续理解项目上下文 。
  3. VS Code 集成：在 VS Code 扩展市场中搜索并安装 “Claude Code” 扩展。安装后，您可以通过快捷键 Ctrl+Shift+C（Windows）或 Cmd+Shift+C（Mac）快速在编辑器内唤起 Claude Code，实现更紧密的集成开发体验 。
  4. 配置更新渠道：如果您希望使用更稳定的版本，可以在交互模式中输入 /config，将 Auto-update channel 设置为 stable。此渠道的更新会延迟约一周，以跳过有严重问题的版本 。

六、基础使用与核心功能

启动并认证后，您即可在终端与 Claude Code 交互。以下是一些核心用法：

场景 命令/操作示例 说明
日常问答 claude "如何用Python读取CSV文件？" 在终端直接提问，获取代码或解释。
代码生成 claude "为当前目录写一个Express.js的server.js" 根据项目上下文生成特定代码文件。
Bug修复 claude "帮我修复这个文件中的语法错误" 分析指定文件并给出修复建议。
交互模式 输入 claude 后回车 进入持续对话的交互模式，输入 /help 查看所有命令。

Claude Code 还支持强大的 MCP（Model Context Protocol）扩展协议，允许连接数据库、外部API等工具以扩展其能力 。通过 Hooks 功能，您可以设置自动化脚本，在特定事件（如文件保存）前后触发自定义操作 。此外，Checkpointing 功能允许您在 Claude Code 修改文件前创建快照，必要时可轻松回滚 。

七、常见问题排查

平台 问题现象 可能原因与解决方案
macOS command not found: claude PATH未更新。解决方案：重新打开终端，或运行 source ~/.zshrc（或 ~/.bashrc）。
macOS Permission denied 可能误用 sudo 安装 npm 包。解决方案：卸载后使用 nvm 管理 Node 环境重新安装 。
Windows 'irm' is not recognized 在 CMD 中执行了 PowerShell 命令。解决方案：确认终端类型，CMD 应使用对应的 curl 安装命令 。
通用 认证失败或连接超时 网络问题。解决方案：确保代理配置正确，可运行 claude doctor 检查网络连通性 。

若需卸载，可根据安装方式选择对应命令。例如，原生安装可通过删除 ~/.local/bin/claude 和 ~/.claude 目录完成；Homebrew 安装则运行 brew uninstall --cask claude-code 。在升级时，请注意不同安装方式的升级命令不同，并建议在升级前备份 ~/.claude 目录下的配置文件 。

参考来源

# 微信开放平台 # facebook # 开发语言 # windows
Logo
AtomGit开源社区

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。

更多推荐

魔音漫创源码解析：扩展指南： 如何在 moyin-creator 中接入自定义 AI 大模型供应商？

本文介绍了如何为开源AI影视生产工具魔音漫创(MoyinCreator)接入自定义AI大模型的方法。主要内容包括：1)分析核心架构，指出AI调用通过适配器模式实现；2)详细步骤：定义供应商类型、编写Provider适配器、注册工厂类、配置前端界面；3)测试验证方法。该方案采用模块化设计，支持灵活接入不同AI模型，不仅适用于大语言模型，也可扩展至图像和视频生成接口。文章还提供了流式传输优化等实用建议

avatar AtomGit开源社区
cover

把 BAPI 里的校验能力接进 RAP，Validation、Simulation Mode 与消息回传的完整落地思路

avatar AtomGit开源社区

基于 API 的商品类目自动分类：NLP + 规则引擎的混合方案

电商商品类目分类面临人工效率低、规则泛化差、NLP模型不可控等痛点。本文提出API服务化架构+NLP语义模型+规则引擎的混合方案：规则引擎精准处理标准商品，NLP模型处理模糊语义，后置规则校验纠偏，通过标准化API输出统一分类结果。该方案实现毫秒级响应，支持多业务系统对接，形成分类-审核-迭代闭环，有效提升分类精度与效率，适用于跨境铺货、供应链管理等场景，解决了传统方案的泛化弱、迭代慢等问题。

avatar AtomGit开源社区