最近 Claude Code 的热度我不用多说了吧，身边只要是写代码的朋友，基本都在折腾这个命令行 AI 编程工具。但说实话，官方文档对 Windows 的支持写得比较简略，默认示例全是 macOS 和 Linux 的命令，很多人在 Windows 上装的时候就卡在第一步。我前后在三四台不同配置的 Windows 机器上装过 Claude Code，踩了不少坑，也总结出了一套稳定、可复现的安装流程。这篇指南就是基于我实际测试过的路径整理出来的，覆盖从环境准备、安装、登录认证到常见报错排错的全过程，照着操作基本不会翻车。
这个小工具能做什么？简单说，它把 Claude 的能力直接塞进了终端里，你可以在命令行里让它读你的代码、改文件、跑测试、写 commit，甚至让它解释一段复杂报错。适合谁用？每天跟终端打交道的开发者、想用 AI 提升编码效率的人，以及不愿意开 GUI 工具、喜欢纯键盘操作的朋友。我把安装过程中的关键节点、每个命令背后的原因、以及报错时的排查思路都写清楚了，不是单纯甩几条命令让你复制，而是让你真明白每一步在干什么。
1. 安装前的几个关键准备
1.1 确认 Windows 版本与终端工具
不要一上来就装，先花两分钟确认环境，很多安装失败其实都出在基础环境不满足上。Claude Code 官方对 Windows 的要求是 Windows 10 及以上版本，但根据我的实测，Windows 10 的某些精简版和旧版本可能存在系统组件缺失的问题，安装时更容易遇到奇怪报错。如果你手上是 Windows 10 21H2 以上的完整版，问题不大；如果是 Windows 11，基本上任何版本都能正常跑。
终端工具建议直接用 Windows Terminal。为什么强调这个？因为老版的 conhost（就是传统控制台窗口）对 ANSI 颜色转义支持不完整，Claude Code 在终端里输出的彩色高亮内容会变成一堆乱码。Windows Terminal 可以从微软商店直接安装，也可以走 winget 命令：
winget install Microsoft.WindowsTerminal装完以后，建议把默认终端设置为 Windows Terminal，后面所有操作都在里面执行，体验会统一很多。另外，顺手确认一下系统允许你执行正常的 PowerShell 脚本，默认的“受限(Restricted)”策略会导致后面npm install -g全局命令正常，但运行claude命令直接报红。检查方法是在 PowerShell 里输入：
Get-ExecutionPolicy如果返回结果是Restricted，那么后续安装完 claude 后，你需要用Set-ExecutionPolicy -Scope CurrentUser RemoteSigned来调整。这一步建议放到安装 Claude Code 后再做，因为全局 npm 包的安装本身不需要脚本执行权限，但首次启动 claude 时那个启动脚本需要。我已经被这个坑卡住过一次，后面问题排查章节我会再详细说。
1.2 安装 Node.js 18 及以上版本
Claude Code 是一个 npm 包，运行依赖 Node.js 运行时环境，所以安装它的前提是先把 Node.js 备好。官方文档建议版本是 18 及以上，但我实际测试下来，Node.js 18 虽然能装能跑，某些插件场景下偶尔会有内存报错；Node.js 20 LTS 是最稳妥的选择，长期支持版，稳定性和兼容性都更好。Node.js 22 也能用，但目前不是 LTS，不建议生产环境或者工作主力机去追这个新版本。
去 Node.js 官网下载 Windows 安装包（.msi 文件），一路 Next 装完即可。安装时需要注意一个点：安装向导里有一个 “Add to PATH” 的选项，默认是勾选的，不要取消勾选，否则安装完以后node和npm命令都找不到。安装完成后，重开一个终端窗口，输入以下三条命令确认安装结果：
node -v npm -v where nodenode -v看到 v20.x 之类的版本号，npm -v看到 10.x 左右的版本号，where node能看到 node.exe 所在路径，这三项都正常就说明 Node.js 环境没问题。
顺带说一句，有些朋友装过 nvm-windows（Node 版本管理器），这种情况下不一定要重新装 Node，用 nvm 切到 20 LTS 版本效果也一样。如果你的机器上同时存在多个 Node 版本，建议在 nvm 里设置一个默认版本，避免终端里node命令指向了旧版本。
1.3 检查终端网络连通性
这一步经常被忽略，但实际中卡住最多的人就卡在这里。npm 默认从官方源下载包，而 Claude Code 以及它的依赖包体积不小，在部分网络环境下，直接从官方源拉取会非常慢，甚至超时中断。
我建议在安装前先做一次简单的网络连通性检查。在 PowerShell 里执行：
npm ping这个命令会向 npm 官方源发送一个请求并返回耗时。如果你发现耗时很长或者直接报错，那就把 npm 源切换到国内镜像（比如淘宝镜像源），切换命令是：
npm config set registry https://registry.npmmirror.com切换完以后再npm ping一次，正常情况下响应时间应该在几百毫秒以内。镜像源只影响包的下载速度和可用性，不影响 Claude Code 本身的登录和运行逻辑。后面如果遇到 npm 安装卡在某个包上不动，八成就是网络问题，切镜像源基本能解决。
1.4 准备一个可用的 Claude 账号
在开始安装之前，你需要确认自己有一个能用的 Claude 账号，因为安装完成后首次运行必须要登录认证才能跟模型对话。这个账号分为两种：一种是通过 Claude.ai 官网订阅的账号（Pro 或 Max 套餐），另一种是 Anthropic API 平台的账号（按 token 付费）。
两者的区别直接影响你认证登录时的选择，我建议先想好自己要走哪条路。如果你平时已经在浏览器里用 Claude 写东西、改文档，那直接在终端里登录 Claude.ai 订阅账号，能复用你现有的对话额度和订阅费用；如果你是做开发、有明确的 API 调用需求，或者想通过代码方式把 Claude 的能力集成到自己的脚本里，那申请一个 API Key 更灵活，用多少付多少，费用可控。
我个人的建议是，第一次体验 Claude Code 优先用 Claude.ai 订阅账号登录，因为流程最直接，不需要额外申请 Key、不需要理解 token 计费逻辑；等你确认这个工具真的能帮你提高效率以后，再考虑要不要开 API。这个选择在后面的认证章节会展开讲，这里你只需要知道账号是硬前提就行。
2. 核心安装流程详细拆解
2.1 用 npm 全局安装 Claude Code
环境准备就绪以后，安装这个动作本身并不复杂，核心命令就一条：
npm install -g @anthropic-ai/claude-code-g参数表示全局安装，意味着所有终端和目录下都能直接使用claude命令，不会局限于某个项目文件夹。这一点非常重要，因为 Claude Code 虽然是 AI 编程助手，但它不是在项目里跑一个 local 服务，而是一个全局命令行工具，你需要在任意目录下都能启动它。
安装过程通常会持续一两分钟，取决于网速和依赖包数量。如果中途看到类似gyp ERR的字样，不用太紧张，Claude Code 的部分原生依赖在安装时会尝试编译，Windows 上偶尔会提示缺少 C++ 构建工具链。这种情况我后面会单独讲，大多数时候是一个无害警告，不影响主程序使用。
安装完成后，终端会显示类似下面的输出：
added XXX packages in Xs如果你看到的是npm error开头的红色信息，先不要继续往下走，直接跳到第 5 章的“常见报错与解决实录”去对照排查。最常见的两个原因一个是网络超时，一个是 npm 源不可访问。
2.2 验证安装结果与查看版本信息
安装完毕后，重开一个新的终端窗口（这一步不要省，因为新装的全局命令不会自动刷新到已打开终端的 PATH 环境变量里），输入：
claude --version如果正常，你会看到一个版本号输出，格式类似于1.0.x。看到版本号，就说明主程序已经成功安装到你的 Windows 系统上了。此时再执行：
claude --help你能看到一长串帮助信息，包括启动、配置、会话管理、模型切换等子命令。建议不要一眼扫过就关掉，里面有几个参数非常实用，比如--continue可以继续上一次对话，--resume可以指定恢复某个历史会话。这些命令我在第 4 章会详细演示，这里先混个眼熟。
如果你执行claude时提示 “claude 不是内部或外部命令”，说明 npm 全局安装目录没有注册到系统 PATH 里。这是什么原因呢？Node.js 安装时会把%APPDATA%\npm（或者 nvm 对应的路径）加入系统 PATH，但如果你是用绿色版 Node 或者手动改过目录，这个路径可能就没被正确注册。排查和解决办法在第 5 章问题排查里，这里先不打断安装主线。
2.3 首次启动前的环境变量与终端设置
这里有一个 Windows 特有的设置项需要提前处理，就是终端代码页的问题。Claude Code 交互界面包含不少 Unicode 字符和彩色输出，默认的 GBK 代码页有时会导致显示错乱。我习惯在 Windows Terminal 里把默认代码页切到 UTF-8，操作方式是直接在终端里执行：
chcp 65001这条命令只对当前终端窗口生效，关掉重开就恢复原样了。想永久生效，可以在 Windows Terminal 的设置里，把默认配置文件的语言环境设置为 UTF-8，或者在系统“区域设置”里勾选“Beta: 使用 Unicode UTF-8 提供全球语言支持”。我建议只在当前终端执行chcp 65001就够了，动系统级设置怕引起其他软件乱码，不划算。
另外一个建议是，把你常用的项目工作目录提前创建好，比如D:\projects\my-app，后续启动 Claude Code 时直接cd到这个目录再运行。因为 Claude Code 是“跟着目录走”的工具，它在哪个目录启动，它的上下文范围默认就是那个目录里的文件。目录结构清晰，它读代码时的效率会高很多。
首次启动时，Claude Code 可能会提示你安装一些辅助组件，比如它自己的内嵌运行时或终端集成。看到这类提示直接同意即可，这些组件都属于工具自身的正常组成部分，一般体积不大，几分钟内能完成。
3. 认证登录：让 Claude Code 真正可用
3.1 通过 Claude.ai 订阅账号登录（推荐新手）
一切就绪后，在终端启动：
claude首次运行会自动进入认证流程，终端会显示一个登录地址，同时弹出一个等待页面，提示你在浏览器中打开该链接。这个机制和很多现代 CLI 工具的 OAuth 登录一样，你只需要在浏览器里确认授权即可，不需要手动复制粘贴复杂密钥。
具体操作流程是这样的：浏览器打开登录页后，如果没登录 Claude.ai，先输入你的账号密码登录；登录成功后，页面会显示授权请求，点击确认“授权”按钮，然后回到终端。此时终端会自动检测到授权成功，显示类似“登录成功，欢迎使用 Claude Code”的提示，整个认证闭环完成。
这里有一个我在实际操作中注意到的细节:如果你在浏览器里用的是邮箱账号，而同一浏览器还登录着多个 Google 账户、多个邮箱地址，务必确认登录的是你注册 Claude 时用的那一个，否则会出现“授权成功但账号对不上”的错位情况。遇到这种情况时，退出浏览器里所有账号，重新登录正确账号，再试一次授权即可。
登录完成后，终端会显示出可以使用的模型信息。如果你订阅的是 Pro 套餐，能看到对应模型的额度和状态；如果是 Max 套餐，额度会更高。首次登录后对对话数量不满意的话，可以在设置里调整模型配置，这些在后续章节会讲到。
3.2 使用 API Key 登录（开发者进阶路线）
如果你走 API 路线，流程稍有不同。需要先到 Anthropic 的 API 控制台，在 API Keys 页面创建一个新的密钥。创建时建议给这个 Key 起一个明确用途的名字，比如claude-code-windows，方便后续在账单项里看清是哪个应用在消耗额度。
拿到 Key 以后，在终端设置一个名为ANTHROPIC_API_KEY的环境变量。Windows 上的临时设置方式是：
$env:ANTHROPIC_API_KEY="sk-ant-xxxxxxxx"然后启动claude，它就会直接用这个 Key 认证，跳过 OAuth 流程。需要提醒的是，用$env:设置的环境变量只在当前终端窗口有效，关掉终端就没了。你想长期使用的话，用系统环境变量面板把这个变量永久配置进去，或者在 PowerShell 里执行：
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-ant-xxxxxxxx', 'User')设置完以后，重开终端才能生效。
关于 Key 的安全性问题，在这里多说一句：绝对不要把 API Key 提交到 Git 仓库里，也不要写在公开项目或踩坑文档中。我见过不少人因为图省事，把 Key 直接写进了.env文件，结果文件被误提交到 GitHub，几小时内账户就被盗刷了。API Key 的泄露风险和信用卡号的泄露风险是一个级别的，务必当敏感信息处理。一个相对稳妥的做法是使用本地密钥管理工具，或者至少确认.gitignore文件里把包含密钥的文件排除在外。
3.3 登录后的权限确认与会话检查
登录完成后，不要着急马上进入业务，先做一个基础的功能自检。在 Claude Code 交互界面里，随便输入一个简单问题，比如：
你好，请用一句话说明你是谁，以及当前模式支持什么能力。如果模型能正常回复，说明整体链路——终端 → Claude Code → Anthropic 认证 → 模型推理——全部打通了。如果回复出现网络超时或模型不可用，那可能是账号额度限制或网络问题，按第 5 章里的排查方案逐个处理。
在会话界面里，你可以输入/help查看所有可用的斜杠命令，比如/model切换模型、/status查看账户状态、/clear清空当前上下文、/exit退出工具。我建议花两分钟把/model和/status两个命令看一遍，因为日常使用中最常见的就是查询账户额度和切换模型。
关于登录状态还有一个容易忽略的点：Claude Code 的登录状态是存储在用户目录下的，换了一个终端、换了一个项目目录，登录态依然有效，不需要每次启动都重新认证。这在日常使用中很方便，但如果你的机器是多人共用的，注意不要把自己的认证信息留在公共账户下。
4. 常用操作与真实使用场景
4.1 启动交互模式的基本姿势
登录完成以后，每次想用 Claude Code，只需要在目标目录里执行：
claude它会进入一个交互式 REPL 环境，命令行前缀会变成›，跟普通的 PowerShell 提示符明显不同。在这个交互界面里，你可以直接用自然语言描述需求，比如：
帮我看看当前目录下有哪些 Python 文件，并总结每个文件的职责。Claude Code 会读取当前目录的文件结构，给出汇总信息。这里有个小技巧：启动时你可以加一个--dangerously-skip-permissions参数，跳过它每次操作前询问权限的环节。但这个参数默认是关闭的，我强烈不建议打开，因为 AI 执行命令是有副作用的，比如它会帮你执行删除文件或格式化磁盘的命令，权限确认环节是对你的一种保护。宁可每次多按一次回车确认，也别为了省几秒钟把安全机制关掉。
如果你想直接让它执行一个任务而不是进入交互模式，也可以使用非交互式参数：
claude -p "列出当前目录下的所有文件，并输出每行字符数"-p表示 print 模式，它执行完任务后直接输出结果并退出，适合在脚本或者 CI/CD 流程中调用。
4.2 让 Claude Code 读懂并修改项目代码
Claude Code 的核心能力不是简单聊天，而是对代码库的理解和修改。当你在某个项目目录下启动它以后，它默认会把当前目录当作工作区的根目录。此时，你可以让它“读”代码文件、分析结构、定位 bug，甚至直接修改文件。
举个例子，我在一个 Node.js 项目里遇到一个诡异的 bug，启动服务后偶尔报错，我直接在 Claude Code 里说：
请查看 src 目录下的 server.js 和所有路由文件，找出可能导致服务启动不稳定的问题，并给出修改建议。它会先遍历相关文件，然后逐行分析，指出可能出问题的地方，最后给出具体的修改方案。如果方案可行，你只需要确认，它就会执行修改并告诉你改动了哪些文件。
这里要特别提醒一句：Claude Code 的上下文窗口虽然很大，但不是无限的。当你的项目文件非常多、代码量很大的时候，建议用自然语言明确缩小范围，比如“只看src/modules/user下面的代码”，而不是让它分析整个仓库。我实测过，范围限定得越清楚，回答质量和修改准确率越高。
另外，在让它执行修改之前，最好先确认当前代码处于 Git 管理下，并且工作区干净（没有未提交的改动）。这样即使 AI 改错了，你也能随时用git checkout .回滚。这是血的教训，我曾在没有 Git 管理的目录里让 Claude Code 改了一段配置，改坏了以后只能靠记忆恢复，非常痛苦。
4.3 测试、排错、提交的完整闭环
Claude Code 不仅写代码，也能帮你在项目里跑测试和排错。比如你在写一个前端项目，可以直接对它说：
运行项目中的单元测试，如果有失败用例，分析原因并修复。它会在终端里自动执行对应的测试命令，然后把结果返回给你，对失败用例给出分析。这个功能在集成测试阶段特别好用，节省了来回切换窗口、手动执行测试命令的时间。
排错场景下，你还可以直接把报错信息粘贴给 Claude Code：
我运行 npm run build 时报了这段错误：xxxxxxxx。请帮我分析原因并给出修复方案。它会结合项目上下文和报错信息给出定位，比直接把报错粘贴到搜索引擎里找资料要高效得多。这里我总结一个技巧：粘贴报错时，尽量附带上你执行的是哪条命令、使用的 Node 版本、相关的代码片段，信息越完整，AI 的定位越准确。不要让 AI 猜你做了什么。
完成一轮修改后，你还能让它帮你写提交信息：
查看当前 Git 变更，帮我生成一个简明扼要的 commit message。它会分析你的代码改动，生成符合常规风格的提交信息。这个小功能我已经用了一个多月，提交信息质量稳定，节省了大量写 commit message 的时间。
5. 常见报错与解决实录
5.1 PowerShell 执行策略导致 claude 命令无法运行
报错现象：全局安装完成后，输入claude提示“因为在此系统上禁止运行脚本。有关详细信息，请参阅 https:/go.microsoft.com/fwlink/?LinkID=135170 中的 about_Execution_Policies。”
原因分析：Windows PowerShell 默认执行策略是 Restricted，只允许运行系统签名的脚本，而 npm 全局包生成的.ps1启动脚本不在信任列表里。这个限制是 Windows 的安全机制，正常情况下不会影响系统使用，但它会挡住 Claude Code 的启动脚本。
解决办法：在 PowerShell 里用管理员权限执行：
Set-ExecutionPolicy -Scope CurrentUser RemoteSignedRemoteSigned的意思是本地创建的脚本可以运行，从互联网下载的脚本必须有签名。这是个人电脑上最推荐的安全策略，不建议直接设置成Unrestricted，那样会放宽所有脚本执行限制，安全性会明显下降。
设置完成后，重新打开终端验证claude --version。如果之前终端窗口已经打开，一定要完全关闭重开，否则还是老的执行策略。
5.2 npm 全局安装慢或卡在某个包不动
报错现象：执行npm install -g @anthropic-ai/claude-code以后，进度条长时间不动，或者等了十几分钟都没装完。
原因分析：npm 默认从官方源下载，特定网络环境下对国外源的通路不稳定，尤其在依赖包数量多、单包体积大的情况下容易卡住。Claude Code 依赖的包不算少，所以这种情况在 Windows 上很容易遇到。
解决办法：先 Ctrl+C 终止当前安装，然后切换 npm 源：
npm config set registry https://registry.npmmirror.com npm config get registry确认输出为https://registry.npmmirror.com以后，重新执行安装命令。镜像源和官方源的数据是同步的，不用担心装到旧版本或者被篡改的情况。这个切换是全局生效的，后续安装其他 npm 包也会快很多。
这里顺便说一个判断技巧：如果卡住的包始终是同一个名字，并且重试后依然卡住，可以试试清空 npm 缓存：
npm cache clean --force缓存损坏的情况虽然不常见，但一旦遇到就很难察觉，因为它表现为“永远装不上”而不是“立即报错”。
5.3 claude 命令提示不是内部或外部命令
报错现象：安装过程正常结束，没有报任何错误，但输入claude提示“不是内部或外部命令，也不是可运行的程序或批处理文件”。
原因分析：npm 全局安装的可执行文件目录没有被加入系统 PATH。Windows 上，npm 全局安装目录通常在C:\Users\你的用户名\AppData\Roaming\npm，如果这个路径不在 PATH 环境变量里，系统就找不到claude命令。
解决办法：先确认全局安装目录的路径：
npm config get prefix输出结果是全局根目录，把输出路径下的npm子目录（例如C:\Users\你的用户名\AppData\Roaming\npm）加到系统 PATH 里。操作方式：按 Win 键，输入“环境变量”，打开“编辑系统环境变量”，在“高级 → 环境变量”里找到用户变量中的 Path，把上述路径追加进去，确认保存后重开终端。
如果重启后依然不行，检查一下是不是 Node.js 安装时没有勾选 “Add to PATH”。这种情况少见，但确实有人装 Node 时会手动取消勾选。重新运行 Node.js 安装包，或者手动把 Node.js 的安装目录也添加到 PATH。
5.4 登录时提示连接失败或认证超时
报错现象：运行claude后，终端显示需要登录的链接，但浏览器打开链接后一直转圈，或者登录完成返回终端时提示认证失败。
原因分析：认证流程需要终端与 Anthropic 服务端进行几次网络通信。如果你的本地网络环境对 Anthropic 相关域名的通路易受影响，就可能出现认证页面能打开但回调失败的情况。
解决办法：这类问题的排查思路是先确认基础网络连通性，再关注服务状态。可以先查看帮助信息确认本地工具版本，再留意服务状态页面是否有事故公告。如果网络反复异常，建议等待一段时间后再试，或者更换网络环境（比如从公司网络切换到一个普通家庭网络）再验证。反复失败时注意不要把认证回调地址复制错，浏览器地址栏里的完整 URL 都要保留。
另外有一个容易忽略的原因：系统时间和实际时间不一致。OAuth 认证流程中的 token 校验对时间敏感，如果系统时间偏差过大，认证会直接失败。检查系统时间的方法是任务栏右下角的时间，或者 PowerShell 里执行：
Get-Date如果时间明显不对，开启“自动设置时间”并同步一次。
5.5 账户额度不足触发限制提示
报错现象：使用过程中，终端提示类似“your weekly claude code limit is 50%”或额度用尽无法继续对话。
原因分析：Claude Code 的用量和你的订阅套餐或 API 额度挂钩。Pro 套餐的每周对话次数有限，Max 套餐额度更高，API 是按 token 计费。当达到或接近限制时，工具会明确提示你剩余额度。这类提示本身是正常的产品逻辑，并不代表程序有问题。
解决办法：在交互界面输入/status查看当前账户用量详情。如果确实是套餐额度不够，考虑升级套餐，或者切换到 API Key 按需付费。如果是 API 模式，去控制台查看当前账户余额，充值或调整限额即可。不要试图用多个账号轮换来绕开限制，这不符合服务条款，也不稳定。
我个人的建议是，日常轻量使用（改几行代码、解释报错、写 commit message）用订阅额度完全够；高频、项目级的使用，比如让 AI 批量重构代码、生成测试用例，那确实 API 更划算，费用也更可预测。
5.6 终端中文乱码、颜色显示异常
报错现象：Claude Code 输出的中文内容显示为乱码，或者彩色输出变成一堆[32m之类的转义字符。
原因分析：Windows 控制台的代码页和 Unicode 渲染问题。老式控制台对 UTF-8 和 ANSI 颜色支持不好，Claude Code 默认输出是 UTF-8 编码，两者冲突就产生乱码。
解决办法：优先使用 Windows Terminal，它对 ANSI 转义和 Unicode 的支持是原生的，基本不会出问题。如果你必须使用传统控制台，可以按 Win+R 输入cmd后用：
chcp 65001临时切到 UTF-8 代码页，但颜色显示可能还是会有异常。第二个办法是在 Claude Code 会话里输入/config，在设置里关闭彩色输出选项，牺牲一点视觉效果换取可读性。就我实测来看，Windows Terminal 是目前 Windows 上体验最好的终端，比传统控制台强太多，能装就装。
6. 与编辑器搭配使用及相关技巧
6.1 在 VS Code 内置终端中使用 Claude Code
很多人问 Claude Code 能不能在 VS Code 里用。答案是不仅能，而且体验比单独开一个终端更好。因为 VS Code 的内置终端可以直接聚焦到当前打开的项目目录，Claude Code 启动后天然就能读取到你正在编辑的整个项目上下文。
操作方式：VS Code 里按 Ctrl +打开内置终端，确保当前工作目录是你打开的项目文件夹（默认就是），直接输入claude`。它读取的就是你正在看的这个项目，不用手动 cd。这个集成方式对前端项目、Node 项目特别方便，因为 Claude Code 可以直接结合编辑器的文件树理解项目结构。
我实际使用下来，一个非常顺手的流程是：在 VS Code 里改完代码，切到内置终端运行claude -p "查看当前 git diff，帮我写一个提交信息"，得到的提交信息直接复制回 VS Code 源码管理面板。整个流程不离开编辑器窗口，效率非常高。VS Code 里不只有内置终端，还可以通过安装扩展来增强 Claude Code 的显示效果，它能解析 Claude Code 的 markdown 格式输出，让 AI 的返回结果看起来更清晰。
6.2 本地模型替换：cc-switch 与 Ollama 搭配
部分朋友希望在本地搭建更私密的 AI 编码环境，不想把所有代码都发送到云端，这时候可以把 Claude Code 的模型后端切换到本地模型。社区里常用的配套工具是 cc-switch，它本质是一个配置切换器，能帮助你快速在不同模型服务之间切换，配合 Ollama 可以把本地部署的开源模型接入 Claude Code。
这个玩法的原理是：Claude Code 支持通过环境变量或配置文件指定不同的 API 端点。正常情况下默认指向 Anthropic 官方服务，而 cc-switch 能把端点改到本地运行的 Ollama 服务地址上，让 Claude Code 的界面不变，但背后的模型变成了你本地的开源模型（比如 Qwen、Llama 之类）。
不过我要直言，本地模型的代码能力和 Claude 的差距还是明显的，体验上像是从“专业同事”降级成了“见习助手”。我的建议是，日常代码工作用官方模型，涉及敏感代码或离线环境时再切到本地模型。cc-switch 的安装和使用不复杂，但因为它不是官方工具，遇到问题需要去它的项目仓库看文档，更新也比较快。如果你需要严格的数据保密，本地模型是目前可行的一条路；如果你追求的是代码能力和效率，官方模型还是首选。
6.3 几个我从实战中总结的实用技巧
Claude Code 用下来，有几个细节确实改变了我日常的开发习惯。第一个是给它“定角色”。启动时加上一句角色描述，比如“你是一名资深前端工程师，请以代码审查者的身份分析下面的代码”，它返回的建议质量会明显不同。AI 对上下文中的角色设定很敏感，善用这个特性可以提升输出的专业度。
第二个技巧是善用会话管理。claude --continue可以直接恢复上一次会话的上下文，非常适合分支任务的中断和继续。比如上午让它分析了一个模块，下午想继续讨论，加--continue就能接着聊，上下文不会丢。claude --resume则能选择恢复历史会话列表中的任意一个，适合同时跟进多个任务的情况。
第三个技巧是限定文件范围。Claude Code 默认读取整个目录的文件，如果项目里有node_modules、dist、.git这类体积巨大的目录，不但在启动时会影响上下文处理速度，还容易让 AI 的分析被无关文件干扰。项目根目录下加一个配置文件，把这些不需要的目录排除掉，建议排除node_modules、dist、build、.git、__pycache__等目录。做完这个配置以后，Claude Code 的响应速度和准确率都会有明显提升。
另外还有一个 Windows 特有的小技巧：如果你的命令路径中包含中文或空格，启动 Claude Code 之前先确认当前目录路径是否正常显示。某些终端编码环境下，中文路径会导致 Claude Code 读取文件异常。最稳妥的办法是把工作目录放在纯英文路径下，比如D:\dev\project-name，虽然不能保证一定有用，但确实能省掉很多环境相关的幺蛾子。
写在最后的个人体会
Claude Code 在 Windows 上的安装流程本身并不复杂，核心就三步：装对 Node.js、npm 全局安装、登录认证。真正让人栽跟头的，反而是那些被官方文档默认忽略的环境细节——执行策略、PATH 注册、代码页、网络连通性。我写这篇指南的初衷，就是把这些藏在表面之下的坑一个个挖出来放在明面上，让后来的人能少走弯路。
最后再分享一个我坚持了很久的小习惯：每次在 Claude Code 里让它执行任何修改操作之前，我都会确认一次当前工作区是否已有未提交的 Git 变更。这个习惯看上去很基础，但它救过我太多次了。AI 工具的代码修改能力越强，我们的回滚意识就要越强，这是一个成熟开发者该有的自觉。希望这篇指南能帮你在 Windows 上顺利跑起 Claude Code，用它提升效率的同时，也能保持对代码质量的主导权。
