Claude Code保姆级安装教程-Windows指南

文章目录

• 前言• 一、Claude Code 是什么？• 二、安装 Git for Windows• 三、安装 Claude Code• 四、备选安装方式：npm 安装• 五、登录与认证配置• 六、第一次运行 Claude Code• 七、在项目目录中使用才是正确姿势• 八、常用命令速查• 九、常见问题• 小结

前言

本文面向零基础用户，手把手教你在 Windows 10/11 上安装、配置并跑通 Claude Code。 后续文章会继续围绕一个完整项目展开：用 Claude Code 从零做一个有意思的系统，会涉及MCP、Skill的使用、创建，亮点在于页面的全自动化设计。无论你是想做项目写进简历的在校生，还是想体验 AI 辅助开发但不知道从哪开始的新手，都可以先关注一下，后面我会尽快更新这个系列。

一、Claude Code 是什么？

Claude Code 是 Anthropic 推出的一个命令行 AI 编程工具。

你可以在项目目录中打开它，然后用自然语言告诉它你想做什么，比如分析代码、修改文件、解释报错、生成页面、拆解需求，甚至让它帮你一步步完成一个小项目。

如果你之前只用过 Claude 网页版，可能会觉得它和 Claude Code 只是入口不同。其实两者的使用场景差别很大：Claude 网页版更像是和 AI 聊天，Claude Code 更像是让 AI 进入你的项目现场。

从实际体验上看，Claude Code 有几个很明显的优势：

• 可以直接读取当前项目文件，不需要手动复制代码上下文• 能在真实目录结构中工作，更接近实际开发流程• 支持命令行调用，更适合自动化或脚本场景• 适合连续任务，比如一步步完成一个功能，而不是单次问答• 更容易和 Git、Node、后端服务等开发环境结合• 对“做项目”更友好，而不是只停留在“问问题”

当然，这并不是说所有人一开始都必须直接上 Claude Code。对于新手来说，先了解 Claude 的几种使用方式，会更容易选择适合自己的入口。

一般来说，Claude 主要有三种使用形态：

• 网页版• 命令行（CLI），也就是 Claude Code• 编辑器集成，比如 VS Code / Cursor / Idea

如果你是刚接触 AI 工具的同学，可以先从网页版 https://claude.ai/ 开始。它不需要安装，打开浏览器就能使用，上手成本最低，更适合熟悉 Claude 的对话方式和能力边界。

但如果你的目标是做项目、写代码，甚至像我们这个系列一样搭建一个完整的小产品，那么更推荐直接使用 Claude Code。它和本地开发环境结合得更紧密，能真正参与到项目开发流程中。

至于编辑器集成，更适合已经有固定开发习惯的同学。在日常写代码时，它可以更自然地融入 VS Code、Cursor 这类编辑器，不需要频繁切换窗口。

二、安装 Git for Windows

如果你还没有安装 GiT 的话，请先按照以下步骤安装 Git：

• 打开https://git-scm.com/download/win下载Windows版安装包• 双击下载好的安装程序进行安装，一路摁 Next 全部默认就好

打开 PowerShell，先输入下面这条命令：

git --version

如果能看到类似下面这样的输出，说明 Git 已经安装好了：

git version 2.40.0.windows.1

三、安装 Claude Code

Windows 10/11 上最推荐的方式是使用 PowerShell 一键安装。打开 PowerShell，直接执行：

irm https://claude.ai/install.ps1 | iex

这条命令会拉取 Claude Code 的 Windows 安装脚本并执行。

如果你使用的是 CMD，也可以用下面这条命令：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

如果你平时使用 WSL，也可以在 WSL 终端中执行 Linux 版本的安装命令：

curl -fsSL https://claude.ai/install.sh | bash

安装完成后，建议关闭当前终端，重新打开一个新的 PowerShell，然后输入：

claude --version

如果终端输出了类似下面这样的内容，就说明安装成功了：

2.1.112 (Claude Code)

这里注意一下，运行命令是 claude，不是 claude-code。有些同学安装完成后会下意识输入 claude-code --version，然后以为自己没装成功，其实只是命令写错了。

四、备选安装方式：npm 安装

如果一键安装脚本因为网络等原因无法使用，也可以走 npm 安装方式。但这不是我最推荐的方式，因为它多了一层 Node.js 环境依赖。

先确认电脑里有没有 Node.js：

node --versionnpm --version

如果能看到版本号，说明环境没问题。如果没有，就先安装 Node.js 的 LTS 版本：

• 打开https://nodejs.org/，下载版本号 ≥ 18 的 LTS 长期支持版本• 双击运行安装程序，一路 Next 使用默认选项；

然后执行：

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

这里有一个坑：包名必须是 @anthropic-ai/claude-code，不要安装成 claude-code。 npm 上存在非官方同名包，正确包名是带 @anthropic-ai/ 前缀的这个。

如果之前装错了，可以先卸载：

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

装完之后同样用下面的命令验证：

claude --version

五、登录与认证配置

Claude Code 还需要完成认证才能真正使用。常见方式有两种：一种是直接登录 Claude.ai 账号，另一种是配置 API Key。

新手最容易理解的是直接登录：

claude login

执行后，浏览器会打开登录页面，按提示完成授权即可。

如果你使用的是 API Key，可以在 PowerShell 中临时设置：

$env:ANTHROPIC_API_KEY = "sk-ant-你的密钥"

如果你使用的是非官方转发地址，可能还需要配置 Base URL：

$env:ANTHROPIC_BASE_URL = "你的Base URL"

这种写法只在当前 PowerShell 窗口有效。窗口关掉后，配置就没了。

如果想长期生效，可以在 Windows 环境变量里配置。按 Win + S 搜索“环境变量”，进入“编辑系统环境变量”，点击“环境变量”，然后在“用户变量”里新增：

保存后重新打开终端，再运行 Claude Code。

另外，也可以通过用户目录下的 .claude/settings.json 做更完整的配置。

以下是一个示例：

{  "env": {    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",    "ANTHROPIC_BASE_URL": "你的Base URL",    "API_TIMEOUT_MS": "300000"  },  "language": "简体中文"}

这里不建议一开始就把所有配置项都塞进去。对于第一次使用来说，能登录、能正常提问、能在项目目录中运行，就已经够了。

六、第一次运行 Claude Code

配置完成后，就可以开始第一次运行了。

打开 PowerShell，进入一个你准备测试的目录：

cd 你的项目路径

然后输入：

claude

这时会进入 Claude Code 的交互界面。建议第一次不要直接让它写复杂功能，可以先让它理解当前目录：

请你分析一下这个项目的目录结构，并告诉我它主要是做什么的

如果当前目录里没有项目，也可以先创建一个测试文件夹，再启动 Claude Code：

mkdir claude-code-testcd claude-code-testclaude

然后输入：

请帮我创建一个简单的项目说明文档，主题是 AI 简历优化网站

这样做的好处是风险低。第一次使用时，不建议直接在重要项目里让它大规模修改文件。先用一个空目录试试它如何生成文件、如何展示修改、如何请求确认，会更稳。

七、在项目目录中使用才是正确姿势

Claude Code 最适合的使用方式，不是在任意位置打开后随便提问，而是在项目根目录下启动。

比如后面我们要做“AI 简历优化网站”，可以先创建一个项目目录：

mkdir ai-resume-optimizercd ai-resume-optimizerclaude

进入之后，可以先让它帮我们做项目规划：

我想做一个面向校招生的 AI 简历优化网站。请你先不要写代码，先帮我梳理这个项目的核心功能、页面结构和开发步骤。

这个指令很适合作为第一次体验。因为它不要求 Claude Code 立刻写代码，而是先让它参与需求拆解。对于小白来说，这一步比直接生成代码更重要。

后续我们真正开始做项目时，也会沿用这种方式：先让 Claude Code 理解目标，再让它拆任务，最后才进入具体实现。

八、常用命令速查

下面这些命令不用一次性记住，先知道它们能做什么就行。真正写项目时，用多了自然会熟。

进入 Claude Code 交互界面后，还有一些内部命令也很常用：

九、常见问题

如果安装后输入 claude 提示找不到命令，先关闭终端重新打开，再试一次：

claude --version

如果仍然不行，大概率是环境变量没有刷新，或者安装没有成功。可以运行以下命令，它会检查当前环境并提示潜在问题：

claude doctor

如果是 npm 安装很慢，可以考虑切换 npm 镜像源：

npm config set registry https://registry.npmmirror.com

然后重新执行：

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

如果出现网络超时，可以检查当前网络是否能正常访问 Anthropic 服务。如果使用了代理或中转地址，再确认 ANTHROPIC_BASE_URL 是否配置正确。

小结

到这里，Claude Code 就算真正跑起来了。

这一章我们没有急着写代码，而是先完成了三件事：准备 Windows 10/11 环境，安装 Claude Code，完成登录和基础配置。下一步才是更关键的部分：怎么向 Claude Code 提需求，才能让它给出稳定、可执行、少返工的结果。

参考资料Claude Code 官方文档Claude Code Installation Guide

Windows 10/11 安装 Claude Code 完全指南