hudo

Appearance

Claude Code 完整安装教程：Windows 上的 AI 编程助手 ​

Claude Code 是 Anthropic 推出的官方命令行工具，定位是"终端里的 AI 编程搭档"。和 GitHub Copilot 在编辑器中自动补全不同，Claude Code 直接在终端运行，能理解整个项目上下文，进行代码生成、重构、调试，甚至帮你操作 Git。

但在 Windows 上把它装好，没那么顺利。

Claude Code 能做什么 ​

Claude Code 不是简单的问答机器人，它能直接操作你的代码库：

  • 代码生成 — 描述需求，自动生成完整函数或模块
  • 代码重构 — 指定重构方向，批量修改多个文件
  • 调试排查 — 粘贴报错信息，定位问题并给出修复方案
  • 文件编辑 — 直接读取和修改项目中的文件，不用手动复制粘贴
  • Git 操作 — 生成 commit message、创建 PR、review 代码

所有操作都在终端完成。进入项目目录，输入 claude，就能开始对话式编程。

安装的两个难题 ​

Claude Code 的官方二进制文件托管在 Google Cloud Storage（GCS）。国内网络环境下，GCS 基本无法直接访问，下载经常超时或直接失败。

退一步，可以通过 npm 安装 @anthropic-ai/claude-code，但这要求系统先装好 Node.js 18 以上版本，还需要配置 npm 镜像源来解决下载速度问题。对于只想装个 AI 工具试试的人来说，先装 Node.js 再折腾 npm 配置，门槛太高了。

用 hudo 一条命令安装 ​

hudo 是一个 Windows 开发环境引导工具，把下载、配置、环境变量这些重复劳动自动化了。安装 Claude Code 只需要：

powershell
hudo install claude-code

背后的流程：

  1. 查询最新版本，从官方 manifest 获取对应平台的 SHA256 校验值
  2. 尝试直接下载 GCS 上的官方二进制文件
  3. 下载失败自动回退，通过 npm + npmmirror 国内镜像安装
  4. SHA256 完整性校验，确保文件未被篡改；校验失败自动清除缓存重试
  5. 安装到 X:\hudo\tools\claude-code\，自动写入用户 PATH

整个过程不需要手动下载、不需要提前装 Node.js（直连成功的话），也不需要配任何环境变量。

安装后配置 ​

安装完成后，打开新的终端窗口，登录你的 Anthropic 账号：

powershell
claude login

按提示在浏览器中完成授权即可。如果你有 API Key，也可以直接设置环境变量：

powershell
$env:ANTHROPIC_API_KEY = "sk-ant-..."

快速上手 ​

进入任意项目目录，启动 Claude Code：

powershell
cd my-project
claude

进入交互模式后，可以直接用自然语言描述需求。也支持单次调用：

powershell
claude "解释一下这段代码的作用"
claude "写一个解析 CSV 文件的函数"
claude "这个报错怎么修复"

Claude Code 会读取项目文件来理解上下文，给出的建议直接基于你的实际代码，而不是泛泛而谈。

总结 ​

Claude Code 把 AI 编程从编辑器插件带到了命令行。在 Windows 上，GCS 不可达和 npm 配置是两道门槛，但用 hudo 可以跳过这些麻烦，一条命令搞定安装和环境配置。

还没安装 hudo？一条命令即可：

powershell
irm hudo.zexa.cc/install.ps1 | iex

基于 MIT 协议发布

Copyright © 2025-2026 Zexa