Windows 系统Claude Code安装与使用笔记一、基础信息说明1. 适配系统支持Windows 1022H2 及以上、Windows 11全版本仅适配 64 位系统。Claude Code 是 Anthropic 推出的 AI 编程助手可实现代码生成、BUG 修复、代码分析、文件处理等功能提供CLI 终端、无 Node 一键安装、VS Code 插件、WSL 子系统四种安装方案可根据使用场景选择。2. 通用前置要求所有安装方式必看网络设备需正常访问 Anthropic 官方服务器。核心凭证提前获取Claude API Key调用服务必备切勿泄露。获取步骤登录 Anthropic 官网控制台 → 进入API Keys页面 → 点击Create API Key生成并复制保存。可选工具推荐安装Git for Windows提升多安装方式的兼容性。安装官网下载对应版本全程默认安装验证PowerShellgit --version输出版本号即为成功。二、前置环境部署CLI 专属Node.js该步骤仅原生 CLI 安装方式需要其余三种安装方式可跳过。下载安装包前往 Node.js 官网选择 Windows 平台LTS 长期版.msi 格式推荐 18 / 20.x 版本。安装配置双击安装包全程默认下一步务必保留「Add to PATH」勾选状态。环境验证PowerShellnode-v# 要求输出 v18.x 及以上npm-v# 要求输出 v9.x 及以上三、四种安装方案分步教程方案一原生 CLI 安装推荐依赖 Node.js适合习惯终端操作、主流 Windows 开发环境稳定性最强。管理员身份启动 PowerShell右键开始菜单 → 终端(管理员)。国内网络优化可选切换 npm 镜像加速下载npm configsetregistry shturl.cc/cwoqX9v18M9uyqVSPbiL全局安装 Claude Codenpm install-g anthropic-ai/claude-code安装验证claude--version# 正常输出版本号即安装成功补充命令未识别解决方案claude 不是内部或外部命令执行命令获取 npm 全局路径npm config get prefix右键「此电脑」→ 属性 → 高级系统设置 → 环境变量在用户变量中编辑Path新建条目并粘贴上一步获取的路径关闭所有终端重新打开 PowerShell 即可生效。API Key 配置核心二选一永久配置推荐重启终端仍生效快捷键WinR输入sysdm.cpl打开系统属性 → 高级 → 环境变量用户变量新建变量名ANTHROPIC_API_KEY变量值粘贴你的 API Key保存后重启终端。临时配置仅当前终端生效关闭即失效$env:ANTHROPIC_API_KEY你的Claude API Key验证配置echo $env:ANTHROPIC_API_KEY输出对应 Key 即配置成功。CLI 常用基础命令# 1. 进入交互式编程对话模式claude code# 2. 直接提交代码需求claude code编写Python爬虫爬取豆瓣Top250并保存为CSV# 3. 指定模型执行任务claude-3-sonnet 通用首选claude code--model claude-3-sonnet-20240229优化JS代码性能# 4. 读取本地代码文件分析claude code--file./main.py分析代码性能瓶颈并给出优化方案方案二无 Node.js 一键安装轻量版无需部署 Node.js操作最简单适合临时使用、不想配置复杂环境的场景。前置条件必须提前安装Git for Windows。执行安装脚本根据终端选择命令PowerShell 终端irmhttps://claude.ai/install.ps1|iexCMD 终端curl -fsSL https://claude.ai/install.cmd -o install.cmd install.cmd del install.cmd配置环境变量安装路径固定C:\Users\你的用户名\.local\bin参考方案一的Path配置步骤将上述路径添加至用户变量Path验证重启终端执行claude --version。API Key 配置与方案一完全一致。方案三VS Code 插件安装可视化操作推荐日常开发深度集成代码编辑器支持右键操作、侧边栏对话贴合常规编程习惯。安装 VS Code前往官网下载并安装。安装官方插件打开 VS Code快捷键CtrlShiftX进入扩展商店搜索Claude AI认准 Anthropic 官方蓝色图标点击安装重启编辑器生效。插件配置快捷键Ctrl,打开设置搜索Claude API Key粘贴你的密钥可选配置搜索Claude Model默认选择claude-3-sonnet-20240229。核心使用功能代码生成右键空白处 →Claude: Generate Code代码修复/优化选中代码 → 右键Fix Code / Optimize Code实时对话打开左侧Claude侧边栏直接输入需求文件分析拖拽本地代码文件至侧边栏发起分析指令。方案四WSL 子系统安装兼容 Linux 生态适合习惯 Linux 命令行、需要搭配 Linux 开发工具的用户。安装 WSL管理员 PowerShellwsl--install重启电脑根据提示设置 Ubuntu 用户名与密码后续sudo命令需要。WSL 终端内部署环境打开 Ubuntu 终端sudoaptupdatesudoaptinstallnodejsnpm-ynode-v# 验证 Node.js 版本 ≥18安装 Claude Codenpminstall-ganthropic-ai/claude-code永久配置 API Keyechoexport ANTHROPIC_API_KEY你的Claude API Key~/.bashrcsource~/.bashrc验证执行claude --version。四、常见问题排查表问题现象原因解决方法npm 安装提示Permission denied权限错误终端无管理员权限1. 以管理员身份运行 PowerShell2. 追加参数npm install -g anthropic-ai/claude-code --force配置 API Key 后提示「未授权」Key 错误/过期、账号无额度1. 检查 Key 无空格、换行2. 登录控制台核对账号额度3. 重新生成 KeyVS Code 插件无响应网络无法访问官方服务器、插件未生效1. 检查网络2. 重启 VS Code3. 重装插件CLI 提示「模型不存在」模型名称错误使用官方模型claude-3-sonnet-20240229通用、claude-3-opus-20240229复杂任务npm 下载缓慢/超时官方源网络不佳切换国内镜像npm config set registry shturl.cc/cwoqX9v18M9uyqVSPbiL一键安装后命令无法识别未添加.local/bin至环境变量将C:\Users\用户名\.local\bin加入系统 Path重启终端五、安装方案选型总结新手首选原生 CLI VS Code 插件组合兼顾终端高效操作与可视化编辑轻量使用选择无 Node.js 一键安装零额外依赖快速上手Linux 开发习惯选择WSL 子系统安装兼容 Linux 工具链通用核心提醒API Key 是服务调用核心务必妥善保管命令识别异常优先检查系统Path环境变量。需要我帮你整理一份常用命令速查表方便你日常调用吗
Windows 系统Claude Code安装与使用笔记
发布时间：2026/6/11 6:40:02
Windows 系统Claude Code安装与使用笔记一、基础信息说明1. 适配系统支持Windows 1022H2 及以上、Windows 11全版本仅适配 64 位系统。Claude Code 是 Anthropic 推出的 AI 编程助手可实现代码生成、BUG 修复、代码分析、文件处理等功能提供CLI 终端、无 Node 一键安装、VS Code 插件、WSL 子系统四种安装方案可根据使用场景选择。2. 通用前置要求所有安装方式必看网络设备需正常访问 Anthropic 官方服务器。核心凭证提前获取Claude API Key调用服务必备切勿泄露。获取步骤登录 Anthropic 官网控制台 → 进入API Keys页面 → 点击Create API Key生成并复制保存。可选工具推荐安装Git for Windows提升多安装方式的兼容性。安装官网下载对应版本全程默认安装验证PowerShellgit --version输出版本号即为成功。二、前置环境部署CLI 专属Node.js该步骤仅原生 CLI 安装方式需要其余三种安装方式可跳过。下载安装包前往 Node.js 官网选择 Windows 平台LTS 长期版.msi 格式推荐 18 / 20.x 版本。安装配置双击安装包全程默认下一步务必保留「Add to PATH」勾选状态。环境验证PowerShellnode-v# 要求输出 v18.x 及以上npm-v# 要求输出 v9.x 及以上三、四种安装方案分步教程方案一原生 CLI 安装推荐依赖 Node.js适合习惯终端操作、主流 Windows 开发环境稳定性最强。管理员身份启动 PowerShell右键开始菜单 → 终端(管理员)。国内网络优化可选切换 npm 镜像加速下载npm configsetregistry shturl.cc/cwoqX9v18M9uyqVSPbiL全局安装 Claude Codenpm install-g anthropic-ai/claude-code安装验证claude--version# 正常输出版本号即安装成功补充命令未识别解决方案claude 不是内部或外部命令执行命令获取 npm 全局路径npm config get prefix右键「此电脑」→ 属性 → 高级系统设置 → 环境变量在用户变量中编辑Path新建条目并粘贴上一步获取的路径关闭所有终端重新打开 PowerShell 即可生效。API Key 配置核心二选一永久配置推荐重启终端仍生效快捷键WinR输入sysdm.cpl打开系统属性 → 高级 → 环境变量用户变量新建变量名ANTHROPIC_API_KEY变量值粘贴你的 API Key保存后重启终端。临时配置仅当前终端生效关闭即失效$env:ANTHROPIC_API_KEY你的Claude API Key验证配置echo $env:ANTHROPIC_API_KEY输出对应 Key 即配置成功。CLI 常用基础命令# 1. 进入交互式编程对话模式claude code# 2. 直接提交代码需求claude code编写Python爬虫爬取豆瓣Top250并保存为CSV# 3. 指定模型执行任务claude-3-sonnet 通用首选claude code--model claude-3-sonnet-20240229优化JS代码性能# 4. 读取本地代码文件分析claude code--file./main.py分析代码性能瓶颈并给出优化方案方案二无 Node.js 一键安装轻量版无需部署 Node.js操作最简单适合临时使用、不想配置复杂环境的场景。前置条件必须提前安装Git for Windows。执行安装脚本根据终端选择命令PowerShell 终端irmhttps://claude.ai/install.ps1|iexCMD 终端curl -fsSL https://claude.ai/install.cmd -o install.cmd install.cmd del install.cmd配置环境变量安装路径固定C:\Users\你的用户名\.local\bin参考方案一的Path配置步骤将上述路径添加至用户变量Path验证重启终端执行claude --version。API Key 配置与方案一完全一致。方案三VS Code 插件安装可视化操作推荐日常开发深度集成代码编辑器支持右键操作、侧边栏对话贴合常规编程习惯。安装 VS Code前往官网下载并安装。安装官方插件打开 VS Code快捷键CtrlShiftX进入扩展商店搜索Claude AI认准 Anthropic 官方蓝色图标点击安装重启编辑器生效。插件配置快捷键Ctrl,打开设置搜索Claude API Key粘贴你的密钥可选配置搜索Claude Model默认选择claude-3-sonnet-20240229。核心使用功能代码生成右键空白处 →Claude: Generate Code代码修复/优化选中代码 → 右键Fix Code / Optimize Code实时对话打开左侧Claude侧边栏直接输入需求文件分析拖拽本地代码文件至侧边栏发起分析指令。方案四WSL 子系统安装兼容 Linux 生态适合习惯 Linux 命令行、需要搭配 Linux 开发工具的用户。安装 WSL管理员 PowerShellwsl--install重启电脑根据提示设置 Ubuntu 用户名与密码后续sudo命令需要。WSL 终端内部署环境打开 Ubuntu 终端sudoaptupdatesudoaptinstallnodejsnpm-ynode-v# 验证 Node.js 版本 ≥18安装 Claude Codenpminstall-ganthropic-ai/claude-code永久配置 API Keyechoexport ANTHROPIC_API_KEY你的Claude API Key~/.bashrcsource~/.bashrc验证执行claude --version。四、常见问题排查表问题现象原因解决方法npm 安装提示Permission denied权限错误终端无管理员权限1. 以管理员身份运行 PowerShell2. 追加参数npm install -g anthropic-ai/claude-code --force配置 API Key 后提示「未授权」Key 错误/过期、账号无额度1. 检查 Key 无空格、换行2. 登录控制台核对账号额度3. 重新生成 KeyVS Code 插件无响应网络无法访问官方服务器、插件未生效1. 检查网络2. 重启 VS Code3. 重装插件CLI 提示「模型不存在」模型名称错误使用官方模型claude-3-sonnet-20240229通用、claude-3-opus-20240229复杂任务npm 下载缓慢/超时官方源网络不佳切换国内镜像npm config set registry shturl.cc/cwoqX9v18M9uyqVSPbiL一键安装后命令无法识别未添加.local/bin至环境变量将C:\Users\用户名\.local\bin加入系统 Path重启终端五、安装方案选型总结新手首选原生 CLI VS Code 插件组合兼顾终端高效操作与可视化编辑轻量使用选择无 Node.js 一键安装零额外依赖快速上手Linux 开发习惯选择WSL 子系统安装兼容 Linux 工具链通用核心提醒API Key 是服务调用核心务必妥善保管命令识别异常优先检查系统Path环境变量。需要我帮你整理一份常用命令速查表方便你日常调用吗
相关文章
告别匈牙利算法！用SimTrack在nuScenes上实现端到端3D目标跟踪（PyTorch实战）
告别匈牙利算法！用SimTrack在nuScenes上实现端到端3D目标跟踪（PyTorch实战）自动驾驶领域正在经历一场从传统模块化架构向端到端学习范式的革命。在这场变革中，3D多目标跟踪作为环境感知的核心环节，其技术演进尤为引人注…
别再死记硬背了！用Verilog写移位寄存器，从波形图反推代码逻辑（附仿真文件）
逆向工程思维：从波形图反推Verilog移位寄存器设计逻辑在数字电路设计中，移位寄存器就像一条精密的传送带，能够将数据位按照特定方向有序移动。传统学习方式往往从代码语法入手，但今天我们要尝试一种工程师常用的逆向思维方法——通…
4台分布式逆变器VSG控制+二次虚拟阻抗与一致性算法微电网控制（Simulink仿真）
💥💥💞💞欢迎来到本博客❤️❤️💥💥 🏆博主优势：🌞🌞🌞博客内容尽量做到思维缜密，逻辑清晰，为了方便读者。 🎁…
别再手动调参了！用Matlab的Kmeans++搞定图像分割，附完整代码和数据集
用Matlab的Kmeans实现智能图像分割：从原理到工程实践在计算机视觉领域，图像分割一直是个既基础又关键的课题。无论是医学影像分析、自动驾驶中的道路识别，还是遥感图像处理，都离不开高效准确的分割技术。传统手动调参方法不仅耗时…
4步搭建个人云游戏服务器：Sunshine开源游戏串流全攻略
4步搭建个人云游戏服务器：Sunshine开源游戏串流全攻略 【免费下载链接】Sunshine Self-hosted game stream host for Moonlight. 项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine 还在为只能在固定设备上玩游戏而烦恼吗？Sunshine开源…
如何用LANDrop实现跨设备局域网文件传输？告别传统传文件的烦恼！
如何用LANDrop实现跨设备局域网文件传输？告别传统传文件的烦恼！ 【免费下载链接】LANDrop Drop any files to any devices on your LAN. 项目地址: https://gitcode.com/gh_mirrors/la/LANDrop 还在为不同设备间的文件传输而烦恼吗？还…
GEEPro：一个专为 AI 编程助手（Codex 和 Claude）设计的专业 Google Earth Engine 技能包（轻松编写生产级遥感代码——无需任何代码经验））
GEEPro：当AI学会遥感——用自然语言驱动Google Earth Engine的专业级项目深度解析 前言 还没有安装codex的请您先安装codex，另外，想用deepseek的请看我之前写的博客。 终于不用扣扣嗖嗖了：1分钟教你Codex成功接入Deepseek详细教程…
用C语言手搓一个Windows经典扫雷：从二维数组到完整游戏逻辑的保姆级实现
用C语言手搓Windows经典扫雷：从二维数组到完整游戏逻辑的实战指南记得第一次在Windows XP上点开那个绿色小图标时，心跳随着鼠标移动加速的感觉吗？扫雷的魅力在于用逻辑推理对抗随机性，而今天我们要用C语言亲手重建这份刺激。不同于…
Java串口数据实时上云方案：桌面端收发+网页端同步显示
本文还有配套的精品资源，点击获取 简介：基于Java开发的轻量级串口通信工具包，自带Swing图形界面，可直接连接CH340、PL2303、FTDI等主流USB转串口芯片，完成设备数据的发送与接收；内置嵌入式WebSocket服务…
LLM 多轮对话状态管理：从无状态 API 到有状态会话
LLM 多轮对话状态管理：从无状态 API 到有状态会话一、大模型 API 的无状态困境：上下文窗口的有限性与会话连续性 大模型的 Chat API 本质上是无状态的——每次请求都需要发送完整的对话历史。这种设计简化了服务端实现，但给后端架构带来了两个…
Spring Boot 3 与 GraalVM 原生镜像：从 JIT 到 AOT 的启动革命
Spring Boot 3 与 GraalVM 原生镜像：从 JIT 到 AOT 的启动革命 一、JVM 冷启动的性能困境：云原生环境下的启动延迟 Java 应用在云原生环境中面临的核心挑战是冷启动延迟。一个典型的 Spring Boot 2 应用，启动时间约 3-8 秒，内存占…
Go 错误处理与错误链：从哨兵错误到自定义错误类型的工程实践
Go 错误处理与错误链：从哨兵错误到自定义错误类型的工程实践一、Go 错误处理的工程困境：哨兵值与信息丢失 Go 的错误处理采用显式返回值模式，if err ! nil 是每个 Go 开发者最熟悉的代码片段。然而，当项目规模增长后，简…
LED驱动技术全解析：从核心架构到实战选型与避坑指南
1. 从一颗灯珠到千亿市场：LED驱动的技术演进与商业逻辑十几年前，当我第一次从料盘上拿起一颗0603封装的白色LED时，它微弱的光晕和高达几块钱的单颗成本，让我很难想象今天它几乎照亮了我们生活的每一个角落。从手机屏幕的一抹背光&…
索引堆及其优化
索引堆及其优化 引言 索引堆是一种数据结构，广泛应用于计算机科学和软件工程领域。它主要用于解决优先队列问题，如最小堆和最大堆。本文将详细介绍索引堆的概念、实现方法以及优化策略。 索引堆的定义 索引堆是一种基于堆数据结构的索引机制。它通过维护一个堆来存储数据…
从零到日增237精准粉丝，我靠CSDN这张AI卡片爆了！手把手复刻全流程，含配置避坑清单
更多请点击： https://intelliparadigm.com 第一章：CSDN AI 数字营销的官方引流卡片是什么功能？ CSDN AI 数字营销平台推出的「官方引流卡片」，是一种面向技术创作者的轻量级、可嵌入式内容分发组件，专为提升博文、教程…
Zotero Duplicates Merger：5步彻底清理文献库重复条目
Zotero Duplicates Merger：5步彻底清理文献库重复条目 【免费下载链接】ZoteroDuplicatesMerger A zotero plugin to automatically merge duplicate items 项目地址: https://gitcode.com/gh_mirrors/zo/ZoteroDuplicatesMerger 还在为文献库中堆积如山的重…
利用随机有限集理论对蜂群的ILQR和MPC控制研究附Matlab代码
✅作者简介：热爱科研的Matlab仿真开发者，擅长数据处理、建模仿真、程序设计、完整代码获取、论文复现及科研仿真。🍎 往期回顾关注个人主页：Matlab科研工作室🍊个人信条：格物致知,完整Matlab代码及仿真咨询…
为什么你的Gemini邮件CTE低于行业均值2.8倍？：从Prompt架构到发送时序的深度归因
更多请点击： https://intelliparadigm.com 第一章：为什么你的Gemini邮件CTE低于行业均值2.8倍？：从Prompt架构到发送时序的深度归因 Gemini邮件的客户转化效率（CTE）显著偏低，根本原因常被误判为…