文章目录前言一、Claude Code 是什么二、安装 Git for Windows三、安装 Claude Code四、备选安装方式npm 安装五、登录与认证配置六、第一次运行 Claude Code七、在项目目录中使用才是正确姿势八、常用命令速查九、常见问题小结前言本文是系列文章【从零开始的Claude Code零代码生活】的第一篇面向零基础用户手把手教你在 Windows 10/11 上安装、配置并跑通 Claude Code。后续文章会继续围绕一个完整项目展开用 Claude Code 从零做一个 AI 简历优化系统。无论你是想做项目写进简历的在校生还是想体验 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 CodeWindows 10/11 上最推荐的方式是使用 PowerShell 一键安装。打开 PowerShell直接执行irmhttps://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-fsSLhttps://claude.ai/install.sh|bash安装完成后建议关闭当前终端重新打开一个新的 PowerShell然后输入claude--version如果终端输出了类似下面这样的内容就说明安装成功了2.1.112(Claude Code)这里注意一下运行命令是claude不是claude-code。有些同学安装完成后会下意识输入claude-code --version然后以为自己没装成功其实只是命令写错了。四、备选安装方式npm 安装如果一键安装脚本因为网络等原因无法使用也可以走 npm 安装方式。但这不是我最推荐的方式因为它多了一层 Node.js 环境依赖。先确认电脑里有没有 Node.jsnode--version npm--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-code npm 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搜索“环境变量”进入“编辑系统环境变量”点击“环境变量”然后在“用户变量”里新增变量名变量值ANTHROPIC_API_KEY你的 API KeyANTHROPIC_BASE_URL你的 Base URL没有则不填保存后重新打开终端再运行 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 Codemkdir claude-code-test cd claude-code-test claude然后输入请帮我创建一个简单的项目说明文档主题是 AI 简历优化网站这样做的好处是风险低。第一次使用时不建议直接在重要项目里让它大规模修改文件。先用一个空目录试试它如何生成文件、如何展示修改、如何请求确认会更稳。七、在项目目录中使用才是正确姿势Claude Code 最适合的使用方式不是在任意位置打开后随便提问而是在项目根目录下启动。比如后面我们要做“AI 简历优化网站”可以先创建一个项目目录mkdir ai-resume-optimizercd ai-resume-optimizerclaude进入之后可以先让它帮我们做项目规划我想做一个面向校招生的 AI 简历优化网站。请你先不要写代码先帮我梳理这个项目的核心功能、页面结构和开发步骤。这个指令很适合作为第一次体验。因为它不要求 Claude Code 立刻写代码而是先让它参与需求拆解。对于小白来说这一步比直接生成代码更重要。后续我们真正开始做项目时也会沿用这种方式先让 Claude Code 理解目标再让它拆任务最后才进入具体实现。八、常用命令速查下面这些命令不用一次性记住先知道它们能做什么就行。真正写项目时用多了自然会熟。命令使用场景claude启动交互模式最常用claude 你的问题不进入交互界面直接提一个问题claude --version查看当前 Claude Code 版本claude doctor检查安装和环境配置是否正常claude login登录或重新认证账号claude logout退出当前账号claude config查看或修改配置claude update更新 Claude Codeclaude --help查看帮助信息进入 Claude Code 交互界面后还有一些内部命令也很常用命令使用场景/help查看可用命令/login在交互模式中登录或切换账号/model切换模型/config打开配置界面/clear清空当前对话上下文/compact压缩上下文适合长对话后继续使用/cost查看当前会话消耗Ctrl C中断当前操作Ctrl D退出 Claude Code九、常见问题如果安装后输入claude提示找不到命令先关闭终端重新打开再试一次claude--version如果仍然不行大概率是环境变量没有刷新或者安装没有成功。可以运行以下命令它会检查当前环境并提示潜在问题claude doctor如果是 npm 安装很慢可以考虑切换 npm 镜像源npm configsetregistry 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 (morphllm)Windows 10/11 安装 Claude Code 完全指南2026 年4月最新版菜鸟教程