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

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

方案三：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，它会自动进行任务编排和操作。