ClaudeCode 跨平台安装指南：Windows、Linux 与 macOS

ClaudeCode 跨平台安装指南

ClaudeCode 是一款强大的 AI 编程助手，支持在多种操作系统环境下运行。本文将详细介绍如何在 Windows（含 WSL）、Linux 和 macOS 上完成环境搭建与配置，帮助你快速开始本地 AI 编码任务。

前置准备

无论使用哪种系统，都需要先获取账号权限并配置基础环境变量。

1. 注册账号：访问官方注册页面完成账户创建。

2. 获取密钥：在仪表板的「API 密钥」页面创建并复制一个新的 API Key。

3. 配置环境变量：根据系统不同，设置以下变量以指向正确的服务地址。

   • ANTHROPIC_BASE_URL：服务接口地址
   • ANTHROPIC_API_KEY：你的 API 密钥
   • ANTHROPIC_AUTH_TOKEN：认证令牌

Windows 环境安装

Windows 用户有两种主流安装方式：直接在终端安装或使用 WSL 子系统。

方案一：原生终端安装

1. 检查 Node.js 环境 确保已安装 Git 和 Node.js。推荐使用 nvm 进行版本管理。

   node -v && npm -v
   

   如果未安装，请先前往官网下载。

2. 配置环境变量 在系统环境变量中添加上述提到的三个变量，保存后重启 PowerShell。

3. 安装与验证 卸载旧版本（如有）并安装官方包：

   npm uninstall -g @anthropic-ai/claude-code
   npm install -g @anthropic-ai/claude-code
   

   重启终端后运行 claude -v 确认版本。

方案二：WSL 子系统安装

如果你更习惯 Linux 环境，可以通过 WSL2 运行。

1. 启用 WSL 在管理员 Terminal 中执行以下命令开启功能并重启：

   dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
   dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
   

   更新内核并安装默认发行版：

   wsl --update
   wsl --set-default-version 2
   wsl --install
   

2. 安装依赖 进入 WSL 后，执行环境检查脚本：

   curl -fsSL https://download.aicodemirror.com/env_deploy/env-install.sh | bash
   

   随后安装官方包：

   npm uninstall -g @anthropic-ai/claude-code
   npm install -g @anthropic-ai/claude-code
   

3. 配置密钥 将 API Key 填入脚本执行：

   sudo apt-get install jq curl -fsSL https://download.aicodemirror.com/env_deploy/env-deploy.sh | bash -s -- "你的 API_KEY"
   

   配置完成后重启终端即可使用。

方案三：Docker 容器化部署

适合需要隔离环境的开发者。

1. 安装 Docker Desktop 下载最新版并勾选 "Use WSL 2 based engine"。在设置中启用 WSL 集成。

2. 构建镜像 创建一个工作目录并编写 Dockerfile：

   FROM ubuntu:22.04
   ENV DEBIAN_FRONTEND=noninteractive
   
   RUN sed -i 's|http://.*.ubuntu.com|http://mirrors.aliyun.com|g' /etc/apt/sources.list && \
       sed -i 's|http://security.ubuntu.com|http://mirrors.aliyun.com|g' /etc/apt/sources.list
   
   RUN apt-get update && apt-get install -y --no-install-recommends \
       ca-certificates build-essential git curl vim python3 python3-pip nodejs npm \
       --fix-missing -o Acquire::Retries=3 && rm -rf /var/lib/apt/lists/*
   
   ARG USERNAME=dev
   ARG UID=1000
   RUN useradd -m -u ${UID} -s /bin/bash ${USERNAME}
   USER ${USERNAME}
   WORKDIR /workspace
   CMD ["bash"]
   

   构建镜像：

   docker build -t claude-env .
   

3. 启动容器 挂载本地项目目录并运行：

   docker run -it --name claude-code \
     -v D:/Tools/Docker/ClaudeCode/Code:/workspace/project \
     claude-env
   

   进入容器后重复上述安装步骤即可。

Linux 环境安装

原生支持 Ubuntu 18.04+、CentOS 7+ 等主流发行版。

1. 执行安装脚本

   curl -fsSL https://download.aicodemirror.com/env_deploy/env-install.sh | bash
   

2. 安装官方包

   npm uninstall -g @anthropic-ai/claude-code
   npm install -g @anthropic-ai/claude-code
   

3. 配置环境变量

   sudo apt-get install jq curl -fsSL https://download.aicodemirror.com/env_deploy/env-deploy.sh | bash -s -- "你的 API_KEY"
   

macOS 环境安装

支持 macOS 10.15+ 系统。

1. 执行安装脚本

   curl -fsSL https://download.aicodemirror.com/env_deploy/env-install.sh | bash
   

2. 安装官方包

   npm uninstall -g @anthropic-ai/claude-code
   npm install -g @anthropic-ai/claude-code
   

3. 配置环境变量

   sudo apt-get install jq curl -fsSL https://download.aicodemirror.com/env_deploy/env-deploy.sh | bash -s -- "你的 API_KEY"
   

常见问题排查

• Node 版本过低：若运行 claude -v 报错，建议升级 Node.js 至 20 以上版本。
• 环境变量残留：卸载后仍报错，请检查 .zshrc (Mac) 或 .claude 文件 (Linux/Win)，删除相关配置行。
• API Error：通常由密钥配置错误引起，请重新核对环境变量值。

配置成功后，在项目目录下输入指令即可启动 Claude Code，它会自动进行任务编排和操作。