Claude Code 跨平台安装指南
Claude Code 作为当前 AI 编码领域的强力工具，支持在多种操作系统上运行。本文基于实际工程经验，梳理了 Windows（含 WSL）、Linux 及 macOS 下的安装与配置流程，重点解决环境依赖与变量配置问题。
前置准备
无论选择哪种系统，都需要确保基础开发环境就绪：
- Node.js 环境：建议版本 20+，旧版（如 18）可能遇到兼容性问题。推荐使用
nvm进行版本管理。node -v && npm -v - Git 工具：用于拉取代码或管理依赖。
- API 密钥：从官方控制台获取 API Key 并妥善保管。
Windows 环境安装
Windows 用户有两种主流路径：原生 PowerShell/CMD 或 WSL 子系统。
方案一：原生环境直装
直接在终端执行以下命令即可全局安装：
npm uninstall -g @anthropic-ai/claude-code
npm install -g @anthropic-ai/claude-code
安装完成后重启终端，通过版本号确认：
claude -v
环境变量配置： 需在系统环境变量中添加以下三项：
ANTHROPIC_BASE_URL：指向 API 服务地址ANTHROPIC_API_KEY：你的密钥ANTHROPIC_AUTH_TOKEN：认证令牌
方案二：WSL 子系统
若习惯 Linux 命令行体验，可启用 WSL2：
- 开启功能：控制面板中勾选'适用于 Linux 的 Windows 子系统'和'虚拟机平台'，重启生效。
- 安装发行版：管理员模式下运行
wsl --install自动部署 Ubuntu。 - 集成 Docker：如需容器化部署，Docker Desktop 需勾选 "Use WSL 2 based engine" 并在设置中启用 WSL 集成。
进入 WSL 后，安装步骤与 Linux 一致（见下文），注意挂载 Windows 目录时路径格式为 /mnt/d/...。
Linux / macOS 环境安装
这两个系统安装逻辑基本相同，原生支持 Ubuntu 18.04+、Debian 10+ 及 macOS 10.15+。
一键安装脚本
打开终端执行环境检查与安装：
curl -fsSL https://download.aicodemirror.com/env_deploy/env-install.sh | bash
注：若使用官方源，可直接使用 npm 安装。
卸载与重装
如遇冲突，先清理旧版本：
npm uninstall -g @anthropic-ai/claude-code
随后重新安装：
npm install -g @anthropic-ai/claude-code
配置 API 密钥
创建密钥后，执行配置脚本注入环境变量：
sudo apt-get install jq curl -fsSL https://download.aicodemirror.com/env_deploy/env-deploy.sh | bash -s -- "你的 API_KEY"
配置完成后重启终端，切换至项目目录启动：
cd workspace/project
claude
Docker 容器化部署
适合需要隔离环境的场景。以 Ubuntu 22.04 为基础镜像构建：
1. 编写 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"]
2. 构建与运行
docker pull ubuntu:22.04
docker build -t claude-env .
docker run -it --name claude-code \
-v D:/Tools/Docker/ClaudeCode/Code:/workspace/project \
claude-env
进入容器后验证 Node 版本并执行安装，后续操作同 Linux 环境。
常见问题排查
1. 环境变量残留导致报错 卸载不彻底时，检查隐藏配置文件：
- Mac：删除
~/.zshrc中的相关配置行 - Windows/Linux：删除
~/.claude目录
2. claude -v 报 JS 错误
通常是 Node 版本过低。请升级至 v20 以上：
nvm install 20
nvm use 20
3. 权限不足
部分命令需加 sudo，或在安装前确保当前用户对目标目录有写权限。
结语
安装只是第一步，后续可根据实际需求调整工作流。保持 Node 环境整洁，定期更新依赖，能让 AI 辅助编码更顺畅。
