Windows 上用 Claude Code，卡人的往往不是装不上，而是装完之后不知道在哪开项目、鉴权怎么过、命令卡住不动。这篇按「装完到跑顺」的顺序走一遍，每一步都给可执行的检查动作和判断标准，需要看具体数字的地方指向站内页面自行核对。
Windows 上用 Claude Code，真正卡人的常常不是装不上，而是装完之后不知道在哪开项目、鉴权怎么过、命令跑着跑着卡住不动。这篇按「装完到跑顺」的顺序走一遍，每一步都给你能直接照着做的检查动作和判断标准，需要看具体数字的地方指向站内页面自己核对。
先记住一个原则：把每一层问题分开查。网络、鉴权、模型回包是三件不同的事，混在一起反复重试只会浪费时间。下面从安装讲到排查，最后给一份上手清单。
装完到跑通第一个任务
所谓前置条件，说白了就是三样东西：一个能正常用的命令行终端、Node 运行时环境、以及当前项目目录你有读写权限。缺哪一样，启动阶段就会直接报错。报错原文要完整读一遍再动手，别看到红字就关窗口重开，那基本不会变好。
- 确认终端与运行时打开终端，分别查一下 node 版本和当前目录，能正常打印版本和路径就说明基础环境在。报「命令找不到」就先修环境，别急着装客户端。
- 选一条鉴权路径要么走官方账号登录，要么填自定义端点的 Key 和地址。两条路要填的字段不一样，最常见的问题是把 Key 填进了账号登录的地方，表现是反复登录失败，而不是明确报错。
- 最小验证三步找一个小仓库，提一个改动明确的需求，看它能不能读文件、能不能改文件、改完能不能看到 diff。三步都过才算装对了，缺任何一步都先别上主仓库。
日常怎么用才顺手
把工作目录当成它的边界。在项目根目录启动，让它自己去读文件；不要在无关目录启动再手动指一堆路径，路径来回填是最容易出错的地方。同时记住上下文是有成本的：对话开太久、塞进去的文件太多，响应会变慢，账单也会跟着涨。
- 长任务拆成小步：一次只让它做一件你能立刻验证的事，你跑完测试再让它接着改，比一口气丢一个大需求更容易收敛
- 该重开会话的信号：话题已经换了、上下文明显跑偏、或者它开始忘记前面说过的约定，这时候重开比硬撑更快
- Windows 特有的坑：路径分隔符、含空格的目录名、中文路径都可能让工具调用失败，遇到莫名报错先把项目挪到纯英文短路径下再试一遍
- 改动前的自保动作：动手前先确认自己在版本控制里，出问题能一键还原，别在没备份的目录里让它批量改文件
卡住、报错、被限流时怎么办
先分层定位：网络能不能通、鉴权过没过、模型有没有回包，这三层各查一次，比逮着一处反复重试快得多。命令跑着不动，多半是超时或者流式输出断在中间，这时候你需要一个延迟基线来对比，才知道是本地网络问题还是端点问题。
| 现象 | 先查哪层 | 下一步动作 |
|---|---|---|
| 启动即报错 | 本地环境 | 回看报错原文，查运行时和目录权限 |
| 登录反复失败 | 鉴权字段 | 确认 Key 和地址填在正确的位置 |
| 命令长时间无输出 | 网络或端点 | 量一次延迟基线，再和平时对比 |
| 提示稍后再试 | 额度或并发 | 去站内对应页面核对当时的规则 |
| 换个端点还是失败 | 大概率在本地 | 回到安装环节，用最小任务重验一次 |
并发和额度限制通常表现为「请稍后再试」这类模糊提示。具体档位和口径不要凭印象调参数，到 /ai-nav/category/ai-api 看各家的说明，配合 /price-watch 里的价格追踪核对当时的数字再决定怎么调。
反过来也有不适用的时候：如果你所在网络做了出口限制、或者项目本身只能在隔离环境里跑，那再折腾客户端也解决不了，该走内网方案或者换执行环境，别在这个方向上耗。
- 新装一台机器：按「终端 → 运行时 → 鉴权 → 最小验证」四步走一遍，别跳步
- 接手别人的项目：先在只读模式下让它解释代码结构，确认理解对了再让它改
- 感觉变慢变贵：先看是不是会话开太久、文件塞太多，重开一个干净会话对比一下
- 排查超过二十分钟没进展：停下来分层复测，比继续瞎试有效
常见问题
Windows 上装完 Claude Code，一启动就报错怎么办？
先别改配置，把报错原文完整看一遍。多数是 Node 运行时没装好、终端权限不够、或者项目目录在受保护路径下。把项目挪到纯英文短路径、用管理员之外的普通终端重开一次，再不行回到安装步骤逐项核对，确认前置条件都满足了再谈鉴权。
为什么让它改文件它一直不动？
常见两种原因：一是上下文塞太多导致响应慢，二是流式输出中途断了。先用一个简单的小任务试，如果小任务正常就说明是任务太大，拆开再提；如果小任务也卡，去 /tools/speed-test 量延迟，判断是本地网络还是端点问题。
提示「请稍后再试」是哪里出问题了？
这类提示一般是触发了并发或额度限制，不是代码写错了。先降低同时跑的会话数，等一会儿再试；要确认当前档位和额度口径，到 /ai-nav/category/ai-api 和对应的官方价格页面看当时的数字，别用旧印象判断还能不能再多开。
