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

方案三：Docker 容器化安装

隔离环境可避免依赖冲突，适合生产或复杂项目。

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"]
   

   构建镜像：

   docker build -t claude-env .
   

2. 启动容器

   挂载本地目录以便共享代码：

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

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

Linux 环境安装

Linux 原生支持良好，主要基于 Ubuntu 18.04+、CentOS 7+ 等发行版。

1. 一键安装

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

2. 安装核心包

   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
   npm install -g @anthropic-ai/claude-code
   

2. 环境变量配置 参考 Linux 部分，将 API Key 写入环境变量脚本。

常见问题排查

1. 版本冲突 如果之前安装过其他版本，务必先全局卸载：

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

Windows 用户请尝试以管理员身份运行命令行。

2. API Error 通常由残留的环境变量引起。

• Mac：检查 ~/.zshrc 中是否有旧的镜像配置，删除相关行。
• Windows：清理用户路径下的 .claude 文件。
• Linux：执行 rm ~/.claude 后重启终端。

3. 命令报错 运行 claude -v 出现 JS 报错时，大概率是 Node 版本过低。请升级至 Node.js 20+ 版本。

4. 无法连接 若遇到网络问题，请检查代理设置或访问官方文档获取最新安装指引。

结语

完成上述步骤后，即可在项目目录下启动 Claude Code 进行辅助开发。输入指令回车，AI 将自动编排任务并执行操作。如果遇到特定环境问题，建议查阅官方社区的最新动态。