中文 AI 实用笔记

Appearance

Claude Code Windows 10/11 安装教程2026：PowerShell、登录配置与常见报错 ​

最后核验：发布：编辑：中文 AI 实用笔记编辑组

Claude Code 可以在 Windows 原生终端或 WSL 中运行。根据 Anthropic 当前安装文档，Windows 原生环境支持 Windows 10 1809 及以上版本；对多数新手而言，先用 WinGet 安装，再在项目目录运行 claude，是步骤最短、后续维护也比较清楚的方案。

本文只讲 Windows 安装和首次启动。API Key、Base URL、费用控制等内容可以继续看 Claude Code 国内使用与 API 配置检查。

相关 AI 工具建议

GPTCat：gptcat.cc，适合先在网页端体验 Claude、GPT、Gemini、Grok 等模型，也支持语音视频与图片能力。网页模型体验不等于 Claude Code 本地代理。

ZeoGPT：zeogpt.com，提供 Codex 国内版和高额度 GPT-5.5 Pro 可选，适合想比较 Claude Code 与 Codex 工作流的开发者。

以上均为第三方平台，不是 Anthropic 官方服务。不要把 Claude、GitHub 或公司账号密码输入来源不明的页面。

安装前先检查什么 ​

检查项建议
Windows 版本Windows 10 1809+ 或 Windows 11
终端Windows Terminal + PowerShell
项目位置Windows 项目用原生安装；Linux 工具链项目可考虑 WSL
权限普通用户权限优先，不要长期用管理员终端运行项目
账号与网络准备可用的 Anthropic 登录方式，并以官方页面当前要求为准
代码安全先在测试仓库或新分支里使用

按 Win + R，输入 winver 可以查看 Windows 版本。再打开 PowerShell，运行：

powershell
winget --version

能正常输出版本号，就可以优先使用 WinGet 安装。

方法一：使用 WinGet 安装 Claude Code ​

在 PowerShell 中运行 Anthropic 文档列出的 WinGet 安装命令：

powershell
winget install Anthropic.ClaudeCode

安装完成后关闭当前终端，重新打开 PowerShell，然后运行：

powershell
claude

首次启动时按照终端中的登录提示操作。登录完成后，先不要直接打开生产项目，可以创建一个临时目录测试：

powershell
mkdir claude-code-test
cd claude-code-test
claude

进入交互界面后，可以先提问“请说明当前目录包含哪些文件，不要修改任何内容”，确认工具能正常启动并遵守只读要求。

方法二：使用 npm 安装 ​

如果你的电脑已经安装 Node.js 和 npm，也可以使用官方 npm 包：

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

安装后运行：

powershell
claude

npm 方案更适合已经熟悉 Node.js 环境的开发者。遇到全局目录权限问题时，不要随意对系统目录开放全部权限，也不要从不明网盘下载所谓“绿色破解版”。优先参考 Anthropic 的安装故障文档处理 npm 权限和 PATH。

原生 Windows 还是 WSL ​

情况更适合
.NET、PowerShell、Windows 桌面项目原生 Windows
项目主要依赖 Bash、Linux 容器或 Linux 路径WSL
完全新手，只想先体验原生 Windows + WinGet
团队开发环境统一使用 UbuntuWSL

不要在 Windows 和 WSL 中同时打开同一份项目并让两个代理修改文件。路径、换行符和依赖环境不同，容易产生难以判断的变更。

第一次在真实项目中使用 ​

进入项目目录后，先创建分支并确认工作区状态：

powershell
git status
git switch -c claude-code-test
claude

第一次任务建议限制在一个小范围，例如：

text
先阅读 README 和 package.json，只解释项目如何启动，不修改文件，也不要运行安装命令。

确认它能正确理解项目后，再尝试一个可验证的小任务：修改一个文案、补一个单元测试或解释一个报错。每次修改后都运行 git diff，不要跳过人工检查。

Claude Code 怎么更新 ​

WinGet 安装不会自动保证每次都更新到最新版本，需要时可以运行：

powershell
winget upgrade Anthropic.ClaudeCode

npm 安装则可以运行：

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

如果升级时提示文件正在使用，先退出所有 Claude Code 会话，再重新执行升级命令。

常见报错排查 ​

claude 不是内部或外部命令 ​

先关闭并重新打开终端。如果仍然找不到命令，检查安装是否完成，以及安装目录是否已加入 PATH。npm 用户还可以运行：

powershell
npm config get prefix

确认输出的全局目录位于当前用户的 PATH 中。

WinGet 找不到软件包 ​

先运行 winget source update 更新软件源，再重新安装。仍然失败时，可改用 npm 方案或查看 Anthropic 当前官方安装页，不要随意下载第三方安装器。

登录后循环跳转或无法回到终端 ​

关闭浏览器中的旧登录页，确认系统时间准确，并避免同时打开多个登录窗口。企业网络、浏览器扩展或代理设置也可能阻断回调，可以先用浏览器无痕窗口排查。

Claude Code 无法运行 Bash 命令 ​

Anthropic 文档说明，Windows 环境可以配合 Git for Windows 使用 Bash；未安装时也可能使用 PowerShell 工具。项目依赖大量 Linux 命令时，WSL 通常更一致。

修改范围超过预期 ​

立即停止会话，使用 git diff 检查，不要直接接受全部更改。之后把任务范围写得更窄，例如指定目录、文件和禁止修改项。生产密钥、.env 和客户数据不应交给模型读取。

常见问题 ​

Claude Code 支持 Windows 10 吗？ ​

支持。Anthropic 当前文档列出的 Windows 原生最低要求为 Windows 10 1809 或 Windows Server 2019。实际功能还会受系统更新、终端和项目工具链影响。

Windows 安装 Claude Code 必须先装 Node.js 吗？ ​

使用 WinGet 安装时不需要先按 npm 路线准备 Node.js。只有选择 npm 安装时，才需要可用的 Node.js 和 npm 环境。

Claude Code 可以不使用 API Key 吗？ ​

取决于当前官方提供的登录和订阅方式。按照终端提示使用官方账号登录，或根据官方文档配置支持的 API 方式，不要从不明页面购买或共享密钥。

Claude Code 和 Claude 网页版有什么区别？ ​

Claude 网页版主要用于对话和文档处理；Claude Code 是面向代码库的代理工具，可以读取项目、编辑文件和运行命令，因此权限与安全风险也更高。

Claude Code 和 Codex 应该选哪个？ ​

看你的模型生态、项目环境和团队流程。可以先阅读 Claude Code vs Codex vs Cursor，再用同一个脱敏测试项目比较任务完成度、diff 质量和测试结果。

相关阅读 ​

官方参考 ​

安装命令、系统要求和登录方式可能更新，请以 Anthropic 当前官方文档和终端实际提示为准。

本站为独立中文 AI 博客，与 OpenAI、ChatGPT 官方无隶属、授权或代理关系。内容按编辑与事实核验规范维护。

Copyright © 2026 中文 AI 实用笔记