本文介绍如何安装 AI 编码界一骑绝尘的最强工具 ——— Claude Code。安装不同的操作系统环境本文会从 Windows、Linux、Mac 三个不同的系统环境依次介绍安装方法。其中Windows 系统作为大家最主流的操作系统提供了两种安装方式一种方式是直接在 Windows 的终端里安装另一种是在 Windows 的子系统WSL内完成安装。其中通过 WSL 安装我们又可以分为WSL 环境的直装和基于 WSL 的容器化安装Docker几种方法各有利弊但均可正常使用。Windows 环境直装 Claude Code1. 获取 Claude Code 账号访问 Claude Code 中国镜像站完成账户注册。输入邀请码DZFW8J获得价值100$的使用额度。2. 配置 Claude Code 运行环境访问 Git官网下载。检查环境是否安装如果没有需要安装 node 环境推荐先下载 nvm 做好 node 版本管理。node -v npm -v设置 Windows 系统环境变量变量名ANTHROPIC_BASE_URL变量值https://api.aicodemirror.ai/api/claudecode变量名ANTHROPIC_API_KEY变量值你的密钥变量名ANTHROPIC_AUTH_TOKEN变量值你的密钥点击确定保存环境变量的修改。3. 安装并启动 Claude Code卸载已安装的Claude Code未安装请跳过npm uninstall -g anthropic-ai/claude-code安装官方原版包npm install -g anthropic-ai/claude-code重启Windows PowerShell后运行以下命令确认安装成功。claude -vd: cd D://workspace/project claudeWindows 子系统安装 Claude Code1. 安装 WSL 环境① 确认 Windows 功能已开启打开 “控制面板 → 程序 → 启用或关闭 Windows 功能”勾选 “适用于 Linux 的 Windows 子系统” 和 “虚拟机平台”点“确定”后重启电脑。开机后管理员模式打开 Terminal, 启用 WSL 和支撑 WSL2 所需的虚拟机平台组件。dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart再次重启电脑。② 更新和升级 WSL2 内核下载安装包从微软官方网站下载 WSL2 Linux 内核更新包安装完成后在 Terminal管理员中运行wsl --update wsl --set-default-version 2如果你还没安装任何 Linux 发行版可以直接运行wsl --install③ 检查 WSL 发行版状态在 Terminal管理员里输入wsl --list --verbose可以看到已经安装的 Linux 发行版NAME STATE VERSION Ubuntu Stopped 2 docker-desktop Stopped 2 docker-desktop-data Stopped 2如果你还没安装任何 Linux 发行版可以直接运行wsl --install这会自动安装 Ubuntu 并设置 WSL2 为默认。WSL 环境搭建好之后按需选择下面三种安装方式。2. WSL 环境安装 Claude Code① 获取 Claude Code 账号访问 Claude Code 中国镜像站完成账户注册。输入邀请码DZFW8J获得价值100$的使用额度。② 安装 Claude Code启动 WSL 环境执行环境检查脚本curl -fsSL https://download.claudecode.net.cn/env_deploy/env-install.sh | bash卸载已安装的Claude Codenpm uninstall -g anthropic-ai/claude-code安装官方原版包npm install -g anthropic-ai/claude-code在「API密钥」界面配置一个API Key访问仪表板的「API密钥」页面创建并复制一个新的API密钥复制并执行环境变量配置脚本sudo apt-get install jq curl -fsSL https://download.claudecode.net.cn/env_deploy/env-deploy.sh | bash -s -- 你的API_KEY配置成功后我们重启终端。在新终端切换到需要使用 Claude Code 的项目启动 Claude Code。cd /mnt/d/workspace/project claude3. Docker 环境安装 Claude Code① 官网下载安装 Docker Desktop从 Docker 官网 下载并安装最新版。安装过程中勾选 “Use WSL 2 based engine”并完成向导重启。② Docker Engine 配置镜像源打开 Docker Desktop进入设置页面 (齿轮图标) 编辑Docker Engine为下面内容{ builder: { gc: { defaultKeepStorage: 20GB, enabled: true } }, dns: [ 8.8.8.8, 8.8.4.4 ], experimental: false, features: { buildkit: true }, insecure-registries: [ https://hub.atguigu.com ], registry-mirrors: [ https://docker.mirrors.ustc.edu.cn, https://registry.docker-cn.com, http://hub-mirror.c.163.com, https://cr.console.aliyun.com/, https://mirror.ccs.tencentyun.com ] }③ Docker Desktop 与 WSL 集成打开设置的Resources页面。打开WSL integration页面勾选Enable integration with my default WSL distro选项。然后检查Advanced页面内是否提示You are using the WSL 2 backend。显示这个说明我们已经集成上了 WSL。这里要求已安装至少一个 Linux 发行版如 Ubuntu如果没有安装需要参考环境准备完成安装。④ 创建 Claude Code 开发环境镜像我们需要创建一个目录作为Docker的运行目录如D:\Tools\Docker\my-dev然后在运行目录下面创建一个Dockerfile文件。通过编写 Dockerfile可以在镜像里预装编译器、依赖包、工具链等一次构建、随处可复用。Dockerfile文件内容# 1. 基础镜像 FROM ubuntu:22.04 # 关闭交互提示 ENV DEBIAN_FRONTENDnoninteractive # 3. 替换为国内 HTTP 源避免 ca-certificates 未安装时的证书校验错误 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 # 4. 更新索引并安装必备包含 ca-certificates遇到下载错误时重试 3 次并跳过缺失包 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::Retries3 \ rm -rf /var/lib/apt/lists/* # 可选更换回官方 HTTPS 源此时已有 ca-certificates可校验证书 # RUN sed -i s|http://mirrors.aliyun.com|https://archive.ubuntu.com|g /etc/apt/sources.list # 4. 创建一个非 root 用户避免容器内文件权限问题 ARG USERNAMEdev ARG UID1000 RUN useradd -m -u ${UID} -s /bin/bash ${USERNAME} \ apt-get update \ apt-get install -y sudo \ echo ${USERNAME} ALL(ALL) NOPASSWD:ALL /etc/sudoers \ rm -rf /var/lib/apt/lists/* # 5. 切换到普通用户 USER ${USERNAME} # 6. 工作目录 WORKDIR /workspace # 7. 默认启动 shell CMD [bash]接下来我们来构建镜像。打开 Terminal 切到该目录mkdir D:\Tools\Docker\my-dev cd D:\Tools\Docker\my-dev这里我为了防止一次性构建时拉取 ubuntu:22.04 时间过长所以先手动拉下来。docker pull ubuntu:22.04同理node 环境也是。docker pull node:18然后构建镜像给它起个易记的名字比如ubuntu-demodocker build -t ubuntu-demo .其中-t ubuntu-demo是给镜像命名.表示在当前目录作为构建上下文Dockerfile 也在这里。⑤ 启动 Claude Code 开发环境容器将本地的 Claude 安装包目录、项目代码和其他工作目录挂到容器里docker run -it \ --name claude-code \ -v D:/Tools/Docker/ClaudeCode/Claude:/workspace/claude \ -v D:/Tools/Docker/ClaudeCode/Code:/workspace/project \ ubuntu-demo进入容器后验证 Node 与 npm检查版本确保环境正常node --version npm --version⑥ 获取 Claude Code 账号访问 Claude Code 中国镜像站完成账户注册。输入邀请码DZFW8J获得价值100$的使用额度。⑦ 容器内安装 Claude Code在容器内的控制台执行环境检查脚本curl -fsSL https://download.claudecode.net.cn/env_deploy/env-install.sh | bash卸载已安装的Claude Codenpm uninstall -g anthropic-ai/claude-code安装官方原版包npm install -g anthropic-ai/claude-code在「API密钥」界面配置一个API Key访问仪表板的「API密钥」页面创建并复制一个新的API密钥复制并执行环境变量配置脚本sudo apt-get install jq curl -fsSL https://download.claudecode.net.cn/env_deploy/env-deploy.sh | bash -s -- 你的API_KEY配置成功后我们重启终端。在新终端切换到需要使用 Claude Code 的项目启动 Claude Code。cd workspace/project claude输入你的指令点击回车Claude Code会自动进行任务编排和操作。Linux 环境安装 Claude Code1. 获取 Claude Code 账号访问 Claude Code 中国镜像站完成账户注册。输入邀请码DZFW8J获得价值100$的使用额度。2. 安装 Claude CodeClaude Code 原生支持 Ubuntu 18.04、CentOS 7、Debian 10、Fedora 30一键安装即可。打开终端执行环境检查脚本curl -fsSL https://download.claudecode.net.cn/env_deploy/env-install.sh | bash卸载已安装的Claude Codenpm uninstall -g anthropic-ai/claude-code安装官方原版包npm install -g anthropic-ai/claude-code在「API密钥」界面配置一个API Key访问仪表板的「API密钥」页面创建并复制一个新的API密钥复制并执行环境变量配置脚本sudo apt-get install jq curl -fsSL https://download.claudecode.net.cn/env_deploy/env-deploy.sh | bash -s -- 你的API_KEY配置成功后我们重启终端。3. 使用 Claude Code 进行开发在新终端切换到需要使用 Claude Code 的项目启动 Claude Code。cd workspace/project claude输入你的指令点击回车Claude Code会自动进行任务编排和操作。MacOS 环境安装 Claude Code1. 获取 Claude Code 账号访问 Claude Code 中国镜像站完成账户注册。输入邀请码DZFW8J获得价值100$的使用额度。2. 安装 Claude CodeClaude Code 原生支持 macOS 10.15 系统一键安装即可。打开终端执行环境检查脚本curl -fsSL https://download.claudecode.net.cn/env_deploy/env-install.sh | bash卸载已安装的Claude Codenpm uninstall -g anthropic-ai/claude-code安装官方原版包npm install -g anthropic-ai/claude-code在「API密钥」界面配置一个API Key访问仪表板的「API密钥」页面创建并复制一个新的API密钥复制并执行环境变量配置脚本sudo apt-get install jq curl -fsSL https://download.claudecode.net.cn/env_deploy/env-deploy.sh | bash -s -- 你的API_KEY配置成功后我们重启终端。3. 使用 Claude Code 进行开发在新终端切换到需要使用 Claude Code 的项目启动 Claude Code。cd workspace/project claude输入你的指令点击回车Claude Code会自动进行任务编排和操作。安装常见问题① 之前安装过其他版本 Claude Code之前安装过其他版本 Claude Code请先直接全局卸载在任意目录执行$ npm uninstall -g anthropic-ai/claude-codeWindows环境执行失败请使用管理员模式打开命令行。② 卸载残留导致API Error这种一般是环境变量问题。Mac版本根目录下有个隐藏文件夹叫.zshrc里面配置了三个镜像的环境变量删除这三行保存然后重新开一下终端Windows版本删除用户路径下的.claude文件Linux版本rm ~/.claude然后重新启动 claude③ Claude -v 报错运行claude -v可以看到大段 js 报错。大概率是 node 版本问题请提升至 20 以上版本网传18版本即可但经实测18版本仍然有不少安装失败的情况通过切换 node 到 20 版本claude -v成功出现版本号。④ 其他安装问题访问 Claude Code 中国镜像站-最新安装教程 查看最新安装方法和常见安装问题的解答。Claude Code 开发者交流社区福利多多立即加入 Claude Code 中国开发者交流社区期待与你的思维碰撞共同奔赴AI开发的浪潮本文转自网络如有侵权请联系删除。
本文介绍如何安装 AI 编码界一骑绝尘的最强工具 ——— Claude Code。安装不同的操作系统环境本文会从 Windows、Linux、Mac 三个不同的系统环境依次介绍安装方法。其中Windows 系统作为大家最主流的操作系统提供了两种安装方式一种方式是直接在 Windows 的终端里安装另一种是在 Windows 的子系统WSL内完成安装。其中通过 WSL 安装我们又可以分为WSL 环境的直装和基于 WSL 的容器化安装Docker几种方法各有利弊但均可正常使用。Windows 环境直装 Claude Code1. 获取 Claude Code 账号访问 Claude Code 中国镜像站完成账户注册。输入邀请码DZFW8J获得价值100$的使用额度。2. 配置 Claude Code 运行环境访问 Git官网下载。检查环境是否安装如果没有需要安装 node 环境推荐先下载 nvm 做好 node 版本管理。node -v npm -v设置 Windows 系统环境变量变量名ANTHROPIC_BASE_URL变量值https://api.aicodemirror.ai/api/claudecode变量名ANTHROPIC_API_KEY变量值你的密钥变量名ANTHROPIC_AUTH_TOKEN变量值你的密钥点击确定保存环境变量的修改。3. 安装并启动 Claude Code卸载已安装的Claude Code未安装请跳过npm uninstall -g anthropic-ai/claude-code安装官方原版包npm install -g anthropic-ai/claude-code重启Windows PowerShell后运行以下命令确认安装成功。claude -vd: cd D://workspace/project claudeWindows 子系统安装 Claude Code1. 安装 WSL 环境① 确认 Windows 功能已开启打开 “控制面板 → 程序 → 启用或关闭 Windows 功能”勾选 “适用于 Linux 的 Windows 子系统” 和 “虚拟机平台”点“确定”后重启电脑。开机后管理员模式打开 Terminal, 启用 WSL 和支撑 WSL2 所需的虚拟机平台组件。dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart再次重启电脑。② 更新和升级 WSL2 内核下载安装包从微软官方网站下载 WSL2 Linux 内核更新包安装完成后在 Terminal管理员中运行wsl --update wsl --set-default-version 2如果你还没安装任何 Linux 发行版可以直接运行wsl --install③ 检查 WSL 发行版状态在 Terminal管理员里输入wsl --list --verbose可以看到已经安装的 Linux 发行版NAME STATE VERSION Ubuntu Stopped 2 docker-desktop Stopped 2 docker-desktop-data Stopped 2如果你还没安装任何 Linux 发行版可以直接运行wsl --install这会自动安装 Ubuntu 并设置 WSL2 为默认。WSL 环境搭建好之后按需选择下面三种安装方式。2. WSL 环境安装 Claude Code① 获取 Claude Code 账号访问 Claude Code 中国镜像站完成账户注册。输入邀请码DZFW8J获得价值100$的使用额度。② 安装 Claude Code启动 WSL 环境执行环境检查脚本curl -fsSL https://download.claudecode.net.cn/env_deploy/env-install.sh | bash卸载已安装的Claude Codenpm uninstall -g anthropic-ai/claude-code安装官方原版包npm install -g anthropic-ai/claude-code在「API密钥」界面配置一个API Key访问仪表板的「API密钥」页面创建并复制一个新的API密钥复制并执行环境变量配置脚本sudo apt-get install jq curl -fsSL https://download.claudecode.net.cn/env_deploy/env-deploy.sh | bash -s -- 你的API_KEY配置成功后我们重启终端。在新终端切换到需要使用 Claude Code 的项目启动 Claude Code。cd /mnt/d/workspace/project claude3. Docker 环境安装 Claude Code① 官网下载安装 Docker Desktop从 Docker 官网 下载并安装最新版。安装过程中勾选 “Use WSL 2 based engine”并完成向导重启。② Docker Engine 配置镜像源打开 Docker Desktop进入设置页面 (齿轮图标) 编辑Docker Engine为下面内容{ builder: { gc: { defaultKeepStorage: 20GB, enabled: true } }, dns: [ 8.8.8.8, 8.8.4.4 ], experimental: false, features: { buildkit: true }, insecure-registries: [ https://hub.atguigu.com ], registry-mirrors: [ https://docker.mirrors.ustc.edu.cn, https://registry.docker-cn.com, http://hub-mirror.c.163.com, https://cr.console.aliyun.com/, https://mirror.ccs.tencentyun.com ] }③ Docker Desktop 与 WSL 集成打开设置的Resources页面。打开WSL integration页面勾选Enable integration with my default WSL distro选项。然后检查Advanced页面内是否提示You are using the WSL 2 backend。显示这个说明我们已经集成上了 WSL。这里要求已安装至少一个 Linux 发行版如 Ubuntu如果没有安装需要参考环境准备完成安装。④ 创建 Claude Code 开发环境镜像我们需要创建一个目录作为Docker的运行目录如D:\Tools\Docker\my-dev然后在运行目录下面创建一个Dockerfile文件。通过编写 Dockerfile可以在镜像里预装编译器、依赖包、工具链等一次构建、随处可复用。Dockerfile文件内容# 1. 基础镜像 FROM ubuntu:22.04 # 关闭交互提示 ENV DEBIAN_FRONTENDnoninteractive # 3. 替换为国内 HTTP 源避免 ca-certificates 未安装时的证书校验错误 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 # 4. 更新索引并安装必备包含 ca-certificates遇到下载错误时重试 3 次并跳过缺失包 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::Retries3 \ rm -rf /var/lib/apt/lists/* # 可选更换回官方 HTTPS 源此时已有 ca-certificates可校验证书 # RUN sed -i s|http://mirrors.aliyun.com|https://archive.ubuntu.com|g /etc/apt/sources.list # 4. 创建一个非 root 用户避免容器内文件权限问题 ARG USERNAMEdev ARG UID1000 RUN useradd -m -u ${UID} -s /bin/bash ${USERNAME} \ apt-get update \ apt-get install -y sudo \ echo ${USERNAME} ALL(ALL) NOPASSWD:ALL /etc/sudoers \ rm -rf /var/lib/apt/lists/* # 5. 切换到普通用户 USER ${USERNAME} # 6. 工作目录 WORKDIR /workspace # 7. 默认启动 shell CMD [bash]接下来我们来构建镜像。打开 Terminal 切到该目录mkdir D:\Tools\Docker\my-dev cd D:\Tools\Docker\my-dev这里我为了防止一次性构建时拉取 ubuntu:22.04 时间过长所以先手动拉下来。docker pull ubuntu:22.04同理node 环境也是。docker pull node:18然后构建镜像给它起个易记的名字比如ubuntu-demodocker build -t ubuntu-demo .其中-t ubuntu-demo是给镜像命名.表示在当前目录作为构建上下文Dockerfile 也在这里。⑤ 启动 Claude Code 开发环境容器将本地的 Claude 安装包目录、项目代码和其他工作目录挂到容器里docker run -it \ --name claude-code \ -v D:/Tools/Docker/ClaudeCode/Claude:/workspace/claude \ -v D:/Tools/Docker/ClaudeCode/Code:/workspace/project \ ubuntu-demo进入容器后验证 Node 与 npm检查版本确保环境正常node --version npm --version⑥ 获取 Claude Code 账号访问 Claude Code 中国镜像站完成账户注册。输入邀请码DZFW8J获得价值100$的使用额度。⑦ 容器内安装 Claude Code在容器内的控制台执行环境检查脚本curl -fsSL https://download.claudecode.net.cn/env_deploy/env-install.sh | bash卸载已安装的Claude Codenpm uninstall -g anthropic-ai/claude-code安装官方原版包npm install -g anthropic-ai/claude-code在「API密钥」界面配置一个API Key访问仪表板的「API密钥」页面创建并复制一个新的API密钥复制并执行环境变量配置脚本sudo apt-get install jq curl -fsSL https://download.claudecode.net.cn/env_deploy/env-deploy.sh | bash -s -- 你的API_KEY配置成功后我们重启终端。在新终端切换到需要使用 Claude Code 的项目启动 Claude Code。cd workspace/project claude输入你的指令点击回车Claude Code会自动进行任务编排和操作。Linux 环境安装 Claude Code1. 获取 Claude Code 账号访问 Claude Code 中国镜像站完成账户注册。输入邀请码DZFW8J获得价值100$的使用额度。2. 安装 Claude CodeClaude Code 原生支持 Ubuntu 18.04、CentOS 7、Debian 10、Fedora 30一键安装即可。打开终端执行环境检查脚本curl -fsSL https://download.claudecode.net.cn/env_deploy/env-install.sh | bash卸载已安装的Claude Codenpm uninstall -g anthropic-ai/claude-code安装官方原版包npm install -g anthropic-ai/claude-code在「API密钥」界面配置一个API Key访问仪表板的「API密钥」页面创建并复制一个新的API密钥复制并执行环境变量配置脚本sudo apt-get install jq curl -fsSL https://download.claudecode.net.cn/env_deploy/env-deploy.sh | bash -s -- 你的API_KEY配置成功后我们重启终端。3. 使用 Claude Code 进行开发在新终端切换到需要使用 Claude Code 的项目启动 Claude Code。cd workspace/project claude输入你的指令点击回车Claude Code会自动进行任务编排和操作。MacOS 环境安装 Claude Code1. 获取 Claude Code 账号访问 Claude Code 中国镜像站完成账户注册。输入邀请码DZFW8J获得价值100$的使用额度。2. 安装 Claude CodeClaude Code 原生支持 macOS 10.15 系统一键安装即可。打开终端执行环境检查脚本curl -fsSL https://download.claudecode.net.cn/env_deploy/env-install.sh | bash卸载已安装的Claude Codenpm uninstall -g anthropic-ai/claude-code安装官方原版包npm install -g anthropic-ai/claude-code在「API密钥」界面配置一个API Key访问仪表板的「API密钥」页面创建并复制一个新的API密钥复制并执行环境变量配置脚本sudo apt-get install jq curl -fsSL https://download.claudecode.net.cn/env_deploy/env-deploy.sh | bash -s -- 你的API_KEY配置成功后我们重启终端。3. 使用 Claude Code 进行开发在新终端切换到需要使用 Claude Code 的项目启动 Claude Code。cd workspace/project claude输入你的指令点击回车Claude Code会自动进行任务编排和操作。安装常见问题① 之前安装过其他版本 Claude Code之前安装过其他版本 Claude Code请先直接全局卸载在任意目录执行$ npm uninstall -g anthropic-ai/claude-codeWindows环境执行失败请使用管理员模式打开命令行。② 卸载残留导致API Error这种一般是环境变量问题。Mac版本根目录下有个隐藏文件夹叫.zshrc里面配置了三个镜像的环境变量删除这三行保存然后重新开一下终端Windows版本删除用户路径下的.claude文件Linux版本rm ~/.claude然后重新启动 claude③ Claude -v 报错运行claude -v可以看到大段 js 报错。大概率是 node 版本问题请提升至 20 以上版本网传18版本即可但经实测18版本仍然有不少安装失败的情况通过切换 node 到 20 版本claude -v成功出现版本号。④ 其他安装问题访问 Claude Code 中国镜像站-最新安装教程 查看最新安装方法和常见安装问题的解答。Claude Code 开发者交流社区福利多多立即加入 Claude Code 中国开发者交流社区期待与你的思维碰撞共同奔赴AI开发的浪潮本文转自网络如有侵权请联系删除。
