Claude Code 跨平台安装与配置指南（Win/Linux/Mac）

重启终端，切换到项目目录启动：

cd /mnt/d/workspace/project
claude

Docker 容器化安装

适合需要隔离环境的场景。

1. 安装 Docker Desktop

从官网下载最新版，安装时勾选'Use WSL 2 based engine'。

2. 配置镜像源

在 Docker Desktop 设置中编辑 Docker Engine，添加国内镜像加速地址。

3. 集成 WSL

在 Resources -> WSL integration 中勾选默认发行版，确保后端为 WSL 2。

4. 构建开发镜像

创建目录并编写 Dockerfile，预装编译器、Node.js 等依赖：

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 pull ubuntu:22.04
docker build -t claude-env .

5. 启动容器

挂载本地代码目录到容器内：

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

进入容器后重复上述安装步骤，配置好 API Key 即可使用。

Linux 与 macOS 环境

这两个系统与 WSL 类似，原生支持较好。

1. 一键安装

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

2. 配置与运行

安装完成后，同样需要配置环境变量并重启终端。切换到项目目录输入 claude 即可。

常见问题排查

① 之前安装过其他版本 全局卸载后再重新安装：

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

Windows 下若失败，请使用管理员模式运行。

② 环境变量残留导致报错

• Mac：检查根目录下 .zshrc，删除相关镜像变量配置。
• Windows：删除用户路径下的 .claude 文件。
• Linux：执行 rm ~/.claude 后重启。

③ 运行 claude -v 报错 通常是 Node 版本过低。请升级至 Node 20+ 版本再试。

④ 其他问题 建议查阅官方文档或社区最新教程以获取针对特定版本的解决方案。