玩转ClaudeCode：ClaudeCode安装教程（Windows+Linux+MacOS）

Ne0inhk

— 13 min read
玩转ClaudeCode：ClaudeCode安装教程（Windows+Linux+MacOS）

本文介绍如何安装 AI 编码界一骑绝尘的最强工具 ——— Claude Code。安装不同的操作系统环境，本文会从 Windows、Linux、Mac 三个不同的系统环境依次介绍安装方法。

其中，Windows 系统作为大家最主流的操作系统，提供了两种安装方式，一种方式是直接在 Windows 的终端里安装，另一种是在 Windows 的子系统（WSL）内完成安装。其中，通过 WSL 安装，我们又可以分为，WSL 环境的直装和基于 WSL 的容器化安装（Docker），几种方法各有利弊，但均可正常使用。

Windows 环境直装 Claude Code

1. 获取 Claude Code 账号

访问 Claude Code 中国镜像站，完成账户注册。

输入邀请码 DZFW8J，获得价值100$的使用额度。

2. 配置 Claude Code 运行环境

访问 Git官网下载。

在这里插入图片描述

检查环境是否安装，如果没有，需要安装 node 环境（推荐先下载 nvm 做好 node 版本管理）。

node-vnpm-v
在这里插入图片描述

设置 Windows 系统环境变量：

  • 变量名：ANTHROPIC_BASE_URL，变量值：https://api.aicodemirror.com/api/claudecode
  • 变量名：ANTHROPIC_API_KEY，变量值：你的密钥
  • 变量名：ANTHROPIC_AUTH_TOKEN，变量值：你的密钥
在这里插入图片描述


点击确定，保存环境变量的修改。

3. 安装并启动 Claude Code

卸载已安装的Claude Code（未安装请跳过）

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

安装官方原版包

npminstall-g @anthropic-ai/claude-code
在这里插入图片描述

重启Windows PowerShell后运行以下命令，确认安装成功。

claude -v
在这里插入图片描述
d: cd D://workspace/project claude
在这里插入图片描述

Windows 子系统安装 Claude Code

1. 安装 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 内核

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.aicodemirror.com/env_deploy/env-install.sh |bash
在这里插入图片描述


卸载已安装的Claude Code

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

安装官方原版包

npminstall-g @anthropic-ai/claude-code
在这里插入图片描述

在「API密钥」界面配置一个API Key
访问仪表板的「API密钥」页面，创建并复制一个新的API密钥

在这里插入图片描述

复制并执行环境变量配置脚本：

sudoapt-getinstall jq curl-fsSL https://download.aicodemirror.com/env_deploy/env-deploy.sh |bash-s -- "你的API_KEY"
在这里插入图片描述


配置成功后，我们重启终端。

在新终端切换到需要使用 Claude Code 的项目，启动 Claude Code。

cd /mnt/d/workspace/project claude
在这里插入图片描述

3. 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_FRONTEND=noninteractive # 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-getinstall-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/* # 可选：更换回官方 HTTPS 源（此时已有 ca-certificates，可校验证书）# RUN sed -i 's|http://mirrors.aliyun.com|https://archive.ubuntu.com|g' /etc/apt/sources.list# 4. 创建一个非 root 用户，避免容器内文件权限问题 ARG USERNAME=dev ARG UID=1000 RUN useradd-m-u${UID}-s /bin/bash ${USERNAME}\&&apt-get update \&&apt-getinstall-ysudo\&&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-demo）：

docker 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--versionnpm--version

⑥ 获取 Claude Code 账号

访问 Claude Code 中国镜像站，完成账户注册。

输入邀请码 DZFW8J，获得价值100$的使用额度。

⑦ 容器内安装 Claude Code

在容器内的控制台，执行环境检查脚本：

curl-fsSL https://download.aicodemirror.com/env_deploy/env-install.sh |bash
在这里插入图片描述


卸载已安装的Claude Code

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

安装官方原版包

npminstall-g @anthropic-ai/claude-code
在这里插入图片描述

在「API密钥」界面配置一个API Key
访问仪表板的「API密钥」页面，创建并复制一个新的API密钥

在这里插入图片描述

复制并执行环境变量配置脚本：

sudoapt-getinstall jq curl-fsSL https://download.aicodemirror.com/env_deploy/env-deploy.sh |bash-s -- "你的API_KEY"
在这里插入图片描述


配置成功后，我们重启终端。

在新终端切换到需要使用 Claude Code 的项目，启动 Claude Code。

cd workspace/project claude
在这里插入图片描述

输入你的指令，点击回车，Claude Code会自动进行任务编排和操作。

在这里插入图片描述

Linux 环境安装 Claude Code

1. 获取 Claude Code 账号

访问 Claude Code 中国镜像站，完成账户注册。

输入邀请码 DZFW8J，获得价值100$的使用额度。

2. 安装 Claude Code

Claude Code 原生支持 Ubuntu 18.04+、CentOS 7+、Debian 10+、Fedora 30+，一键安装即可。

打开终端，执行环境检查脚本：

curl-fsSL https://download.aicodemirror.com/env_deploy/env-install.sh |bash
在这里插入图片描述


卸载已安装的Claude Code

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

安装官方原版包

npminstall-g @anthropic-ai/claude-code
在这里插入图片描述

在「API密钥」界面配置一个API Key
访问仪表板的「API密钥」页面，创建并复制一个新的API密钥

在这里插入图片描述

复制并执行环境变量配置脚本：

sudoapt-getinstall jq curl-fsSL https://download.aicodemirror.com/env_deploy/env-deploy.sh |bash-s -- "你的API_KEY"
在这里插入图片描述


配置成功后，我们重启终端。

3. 使用 Claude Code 进行开发

在新终端切换到需要使用 Claude Code 的项目，启动 Claude Code。

cd workspace/project claude
在这里插入图片描述


输入你的指令，点击回车，Claude Code会自动进行任务编排和操作。

在这里插入图片描述

MacOS 环境安装 Claude Code

1. 获取 Claude Code 账号

访问 Claude Code 中国镜像站，完成账户注册。

输入邀请码 DZFW8J，获得价值100$的使用额度。

2. 安装 Claude Code

Claude Code 原生支持 macOS 10.15+ 系统，一键安装即可。

打开终端，执行环境检查脚本：

curl-fsSL https://download.aicodemirror.com/env_deploy/env-install.sh |bash
在这里插入图片描述


卸载已安装的Claude Code

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

安装官方原版包

npminstall-g @anthropic-ai/claude-code
在这里插入图片描述

在「API密钥」界面配置一个API Key
访问仪表板的「API密钥」页面，创建并复制一个新的API密钥

在这里插入图片描述

复制并执行环境变量配置脚本：

sudoapt-getinstall jq curl-fsSL https://download.aicodemirror.com/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-code

Windows环境执行失败请使用管理员模式打开命令行。

② 卸载残留导致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开发的浪潮！

Read more

《数据结构风云》：二叉树遍历的底层思维＞递归与迭代的双重视角

《数据结构风云》：二叉树遍历的底层思维＞递归与迭代的双重视角

🔥@晨非辰Tong： 个人主页 👀专栏：《C语言》、《数据结构与算法入门指南》 💪学习阶段：C语言、数据结构与算法初学者 ⏳“人理解迭代，神理解递归。” 文章目录 * 引言 * 知识点前瞻 * 一、不一样的前序遍历 * 1.`要求描述：` * 2.`实现示例：` * 3.`算法思路：` * 3.1 `具体代码实现` * 3.2 **==注意要点==** * 二、不一样的中序遍历 * 1.`要求描述：` * 2.`实现示例` * 3.`算法思路：` * 3.1 `具体代码实现：` * 三、不一样的后序遍历 * 1.`要求描述：` * 2.`实现示例：` * 3.`算法思路：` * 3.1 `具体代码实现：` * 四、

By Ne0inhk
【AI深究】K-近邻算法（KNN）详细全流程详解与案例（附大量Python代码演示）| 回归/分类、原理与算法流程、案例与完整代码演示 |K值选择与模型表现、距离度量的选择与影响、加权KNN、工程建议

【AI深究】K-近邻算法（KNN）详细全流程详解与案例（附大量Python代码演示）| 回归/分类、原理与算法流程、案例与完整代码演示 |K值选择与模型表现、距离度量的选择与影响、加权KNN、工程建议

大家好，我是爱酱。本篇我们将系统讲解K-近邻算法（KNN），内容涵盖原理、数学公式、案例流程、代码实现和工程建议，适合新手和进阶者学习。详细内容涵盖：K值选择与模型表现、距离度量的选择与影响、加权KNN，分类跟回归任务都会覆盖到！ 注：本文章含大量数学算式、大量详细例子说明及大量代码演示，大量干货，建议先收藏再慢慢观看理解。新频道发展不易，你们的每个赞、收藏跟转发都是我继续分享的动力！ 注：本文章颇长超过8500字、以及大量Python代码、非常耗时制作，建议先收藏再慢慢观看。新频道发展不易，你们的每个赞、收藏跟转发都是我继续分享的动力！ 一、KNN算法简介 K-近邻算法（K-Nearest Neighbors, KNN）是一种非参数化、懒惰学习的监督学习算法，可用于分类和回归任务。KNN的核心思想是：对一个新样本，找到训练集中距离最近的K个邻居，根据这些邻居的类别或数值来预测新样本的类别或数值。 * 分类任务（Classification）：采用多数投票原则，K个邻居中出现最多的类别为预测类别。 * 回归任务（Regression）：取K个邻居的均值作为预测值。

By Ne0inhk
【算法】二分查找(二)查找边界二分

【算法】二分查找(二)查找边界二分

目录 题目介绍 二段性 1.二段搜索 1.1搜索段端点 1.1.1住段的左端点 1.1.2住段的右端点 2.死循环 2.1中点偏向 2.2多余搜索 3.模板 3.1求段左端点： 编辑 3.2求段右端点： 编辑 4.区别 提交代码 题目介绍 34. 在排序数组中查找元素的第一个和最后一个位置 - 力扣（LeetCode） 给你一个按照非递减顺序排列的整数数组 nums，和一个目标值 target。请你找出给定目标值在数组中的开始位置和结束位置。 如果数组中不存在目标值 target，返回 [-1, -1]。 你必须设计并实现时间复杂度为 O(log n)

By Ne0inhk
【算法通关指南：算法基础篇】二分算法：1.在排序树组中查找元素的第一个和最后一个位置 2.牛可乐和魔法封印

【算法通关指南：算法基础篇】二分算法：1.在排序树组中查找元素的第一个和最后一个位置 2.牛可乐和魔法封印

🔥小龙报：个人主页 🎬作者简介：C++研发，嵌入式，机器人方向学习者 ❄️个人专栏：《算法通关指南》 ✨ 永远相信美好的事情即将发生 文章目录 * 前言 * 一、二分算法 * 二、在排序树组中查找元素的第一个和最后一个位置 * 2.1题目 * 2.2 算法原理 * 2.3代码 * 三、牛可乐和魔法封印 * 3.1题目 * 3.2 算法原理 * 3.3代码 * 总结与每日励志 前言 本专栏聚焦算法题实战，系统讲解算法模块：以《c++编程》，《数据结构和算法》《基础算法》《算法实战》 等几个板块以题带点，讲解思路与代码实现，帮助大家快速提升代码能力ps:本章节题目分两部分，比较基础笔者只附上代码供大家参考，其他的笔者会附上自己的思考和讲解，希望和大家一起努力见证自己的算法成长 一、

By Ne0inhk