上周我把主力开发机换成Windows之后第一件事就是重新搭一套顺手的AI编码环境。试了一圈下来最让我意外的组合是“Windows命令行 ClaudeCode 国产大模型”三个名字单拎出来都不稀奇拼在一起之后反而比之前在Mac上还用得顺手。这篇就把完整的安装、接入和排错过程写下来照着走能少踩不少坑。先说清楚我这里说的“使用国产大模型”不是拿ClaudeCode当普通聊天窗口而是让这个终端AI编码工具把推理请求发到DeepSeek这类国产模型的API上既能保留ClaudeCode读写文件、执行命令、改代码的工程能力又不用绑定官方订阅那套成本结构。这篇适合谁主力机是Windows、想用终端AI工具又不想折腾复杂订阅流程、手上有国产大模型API Key或者愿意花几块钱开通的开发者。整个过程从零开始按章节顺序操作半小时内基本能跑通。1. 为什么是Windows ClaudeCode 国产大模型的组合1.1 ClaudeCode是什么它和普通AI聊天有什么区别很多人第一次听到ClaudeCode第一反应是“这不就是个命令行聊天机器人吗”。其实它的核心不是聊天而是“代理式编码”你给它一个任务它能自己读项目文件、定位相关代码、修改多个文件、执行测试命令、看报错再继续改。整个过程都在你的终端里运转而不是把代码复制到网页里来回粘贴。举个例子。你用网页版AI问“给我写一个图片压缩脚本”它只会给你一段代码剩下的你自己处理。但用ClaudeCode你直接说“在这个仓库里加一个脚本把assets目录下的png批量转成webp并更新README的用法说明”它会自己找目录、写文件、执行命令看效果、改README最后告诉你每一步做了什么。这种差异在真实开发里很重要它不再是“答案生成器”而是一个能长期坐在项目里干活的协作者这也是它值得专门写一篇安装配置文章的原因。1.2 为什么非要把国产大模型接进来这个问题的答案很现实成本和门槛。ClaudeCode本身是一个命令行工具安装过程不复杂。但在模型侧官方订阅不是一个适合所有人的方案额度有限、计费逻辑对很多人来说不友好。而国产大模型那边DeepSeek等平台的API好处在于注册即用、按量计费、价格低而且提供了Anthropic兼容的接口端点。这意味着你不需要改ClaudeCode的任何业务逻辑只要把请求地址指向国产大模型的兼容端点再把模型名改成它家的模型名整条链路就通了。我在选型时对比过几家对比项官方/生态平台国产模型API开通门槛相对高需要订阅流程注册平台、充值即可成本按模型定价Chat级调用较贵国产token单价通常更低缓存命中时优势更明显模型能力闭源强模型deepseek-chat/deepseek-reasoner对编码任务表现不错接入方式默认的base_url提供Anthropic兼容端点ClaudeCode直接认这组对比不是要分高下而是想说明当ClaudeCode把“模型后端”和“编码工具”解耦之后你可以用更便宜、更好开通的模型来驱动它组合的性价比会明显提升。2. 开工之前先把Windows这三个环境细节搞定2.1 Node.js版本别用太老的ClaudeCode是npm发布的一个命令行包运行环境是Node.js。Windows上装Node最稳妥的方式是去官网下载LTS版本尽量装18以上、最好20 LTS或更新因为ClaudeCode内部依赖新版Node的很多原生能力版本太老会出现“装是装上了、一启动就报错”的情况。装完在终端里确认node -v npm -v如果机器上已经有多个Node版本建议用nvm-windows做版本管理临时切到要求的版本再执行安装不要和旧项目纠缠。2.2 终端选择Windows Terminal PowerShell 7终端是ClaudeCode的主要交互界面。Windows自带的CMD能用但体验差很多字体、复制粘贴、输出缓冲都比不上Windows Terminal。我更推荐“Windows Terminal外壳 PowerShell 7”作为默认shell原因有三个命令行补全更完整、对UTF-8支持更好、粘贴多行命令不容易丢字符。如果你不想升级PowerShell 7Windows Terminal自带的Windows PowerShell 5.1也能用但遇到中文输出乱码时处理方式会多一点。另外安装ClaudeCode时如果npm报权限错误检查是否以管理员身份运行如果报“无法加载文件”是执行策略问题后面第6章会专门说。2.3 npm源与安装速度Windows下npm默认源在某些场景下会很慢ClaudeCode安装进度条半天不动是常事。建议先把镜像源加上npm config set registry https://registry.npmmirror.com设置之后再执行安装速度差距非常明显。这个配置不影响开发它只让包下载走国内镜像节点。注意很多Windows用户装完npm全局包之后在CMD或PowerShell里敲命令提示“不是内部或外部命令”大概率是全局目录%APPDATA%\npm没有加进PATH。这个问题在第6章会详细讲。3. ClaudeCode本体安装与初始化配置3.1 全局安装命令与版本验证确认Node环境无误后执行一条命令npm install -g anthropic-ai/claude-code安装完成后验证claude --version能正常输出版本号就说明安装成功。注意命令名是claude不是claudecode。3.2 首次启动与登录逻辑第一次在任意项目目录下输入claude命令行会进入初始化流程。它会询问是否用Claude账号登录。我的建议如果只是为了接国产大模型可以不绑定官方账号直接跳过或选择“暂不登录”因为后面我们会通过环境变量把API Key和请求地址指到国产模型上。初始化实际只做两件事检查配置目录、准备用户级配置。完成后进入交互模式等待你的指令。如果此时还没配置环境变量它会提示缺少API Key先不用慌按第4章流程配好再重开终端即可。3.3 配置目录和核心文件ClaudeCode在Windows上的配置存放在用户目录下的.claude文件夹和.claude.json文件里作用是保存会话历史、权限设置、模型偏好等。你可以先看一眼这些文件是否存在不用改。绝大多数配置通过环境变量和会话内斜杠命令就能完成文件级配置只在做精细化权限管理或自定义Skill时才有存在感第5章我会说具体路径。3.4 环境变量是这套方案的心脏ClaudeCode读取几个固定环境变量来决定“请求发到哪、用什么钥匙、调用什么模型”这套机制是整个接国产大模型方案的核心ANTHROPIC_BASE_URL请求的API地址。默认指向Anthropic官方改成国产大模型的兼容端点后流量就发到那里。ANTHROPIC_API_KEY你的模型服务商提供的API密钥。ANTHROPIC_MODEL模型名。把这三个变量设置好ClaudeCode基本不用改任何代码就能从官方模型切换到国产大模型。这也是它适合当Windows日常开发工具的原因没有和某一家模型硬绑定。4. DeepSeek等国产大模型接入实操4.1 获取API Key以DeepSeek为例打开DeepSeek开放平台注册账号、登录在API Keys页面创建一个新Key创建后立即复制保存——平台只显示一次丢了只能重新生成。再往账户充一点钱按目前的token单价日常开发测试几块钱能用很久。如果你用的是别家提供Anthropic兼容端点的国产大模型思路完全一样找到API控制台拿Key在文档中找到“兼容接口”的base URL和模型名。4.2 配置环境变量的三种方式Windows下配置环境变量有三种常见方式命令行临时、用户级持久、系统级。日常开发我推荐用户级持久方式。临时生效只在当前终端内有效$env:ANTHROPIC_BASE_URL https://api.deepseek.com/anthropic $env:ANTHROPIC_MODEL deepseek-chat $env:ANTHROPIC_API_KEY sk-你的key用户级持久化推荐[Environment]::SetEnvironmentVariable(ANTHROPIC_BASE_URL, https://api.deepseek.com/anthropic, User) [Environment]::SetEnvironmentVariable(ANTHROPIC_MODEL, deepseek-chat, User) [Environment]::SetEnvironmentVariable(ANTHROPIC_API_KEY, sk-你的key, User)执行完需要重新打开终端变量才会被读到。如果习惯用CMD也可以用setx命令达到同样效果setx ANTHROPIC_BASE_URL https://api.deepseek.com/anthropic setx ANTHROPIC_MODEL deepseek-chat setx ANTHROPIC_API_KEY sk-你的key提示这里的关键是BASE_URL里的/anthropic路径。DeepSeek对外提供OpenAI兼容和Anthropic兼容两套端点ClaudeCode是Anthropic生态工具必须接Anthropic兼容端点。填成OpenAI的/v1地址是不行的。4.3 模型名选哪个DeepSeek常用的两个模型名deepseek-chat对应通用对话模型速度快、价格低适合大多数编码任务deepseek-reasoner对应推理增强模型处理复杂问题更稳但响应更慢、单价更高。日常写代码我多数用deepseek-chat遇到特别难的逻辑分析再切到deepseek-reasoner。切换方式有两种在ClaudeCode会话内输入斜杠命令查看并修改模型如果版本不支持会话内切换直接改环境变量后重启终端。4.4 跑通验证配置完成后进入一个空目录输入claude启动然后发一条最简单的需求“写一个Python脚本输出1到10的平方。”如果它正常给出代码并生成文件说明链路已经通了。如果没有先看环境变量是否生效——在PowerShell里执行echo $env:ANTHROPIC_BASE_URL如果打印为空说明当前终端没有读取到新的用户级变量重开终端再试。我第一遍接入时踩过一个很蠢的坑ANTHROPIC_MODEL里填了模型展示名而不是API模型名结果ClaudeCode返回“模型不存在”。记住环境变量里填的是API请求用的模型标识不是控制台里显示的花哨名字。5. 实战让这套组合真正干活5.1 一个小任务的设计光能回答提问不算本事能完成一个多步骤开发任务才算把工具用起来。我找了个很典型的任务来做演示“帮我把当前目录下的三个CSV文件合并成一个去掉重复行把日期列统一成YYYY-MM-DD格式最后输出成一个Excel文件。”这个任务涉及扫描目录、读取文件、字段对齐、去重、时间格式化、生成xlsx每一步都可能出问题足够测试完整工作流。5.2 从描述到落地启动ClaudeCode后直接把需求粘进去。它会先复述任务理解然后动手用命令查看目录下有哪些CSV、读取几行样本数据、写一个Python脚本、尝试运行、缺依赖库就安装、最后验证输出文件。这个过程最值得注意的是每一步修改和执行命令前它都会停下来问是否允许。这种确认机制一开始觉得啰嗦但确实能避免乱动文件。对可控场景后面会讲怎么减少确认。5.3 权限控制的正确姿势ClaudeCode的权限控制分几个等级默认每个操作都确认--dangerously-skip-permissions直接跳过所有确认也可以在会话内用/permissions管理白名单规则比如允许对某个目录的写权限。我的建议是跑实验时可以用跳过模式加快速度但在真实项目目录里维持默认确认模式并通过白名单把高频操作放行。这样既不打断节奏又能兜底防误操作。5.4 让它跨文件修改并提交Git这个实战最有价值的是任务没结束我又追加了新需求“把生成的Excel文件名改成包含当天日期的格式然后在README里加一节说明用法最后帮我创建一个Git提交。”ClaudeCode会顺着刚才生成的脚本继续改找到文件名赋值代码修改输出格式编辑README然后逐条执行git add、git commit。我看它生成的提交信息还挺规整比我手写一次commit信息更像样。这个流程说明一个点ClaudeCode不是一次性问答工具它能记住当前项目上下文连续多轮改动都能接上。5.5 用Skill固化团队规范如果你发现某些指令每次都要重复说比如“代码注释必须中文”“测试文件放在tests目录”可以在~/.claude/skills/下建一个Markdown文件把规范写进去下次ClaudeCode遇到对应场景会自动加载。具体创建方式在skills目录下新建一个子目录里面放一个SKILL.md用自然语言描述触发条件和行为规则。这个功能我强烈建议Windows用户用起来因为Windows项目经常有跨平台路径、编码等特殊规范固化在Skill里能避免每次手动交代。5.6 子agent复杂任务拆解的进阶用法ClaudeCode支持子agent机制可以把一个复杂任务拆给多个带独立系统提示词的子任务执行者分别负责代码审查、测试、文档等方向。不过我不建议刚上手就去碰底层的agent配置文件。我的做法是先用自然语言描述分工比如“让一个专门负责测试的子agent检查这个新增模块”ClaudeCode会在内部自行拆分。等你对它的行为模式熟悉了再去做更细粒度的自定义配置。这样既能用上子agent的并行处理能力又不会被配置文件细节绊住。6. Windows下的坑位清单与排查思路6.1 PowerShell执行策略导致脚本无法运行如果你在终端里运行一些.ps1脚本时报“无法加载文件...因为在此系统上禁止运行脚本”是PowerShell默认执行策略太严导致的。解决办法Set-ExecutionPolicy RemoteSigned -Scope CurrentUser这个命令允许本地脚本运行远程下载的脚本仍需签名比较平衡。执行后输入Y确认即可。6.2 命令找不到PATH没刷新的幻觉claude命令明明装了重开终端还是提示“不是内部或外部命令”八成是npm全局目录没有进入PATH。默认npm全局目录在%APPDATA%\npm把它加进用户环境变量PATH然后重开终端。如果是用nvm-windows切换Node后突然丢命令先检查当前Node对应的全局目录是否变化。6.3 中文乱码代码页和编码的问题Windows中文环境下终端默认代码页可能是936GBK而ClaudeCode输出UTF-8两者碰撞就显示乱码。两个解决方向在Windows Terminal的配置文件里把默认代码页切到UTF-8或用chcp 65001临时切换。在PowerShell 7里设置会话输出编码$OutputEncoding [Console]::OutputEncoding [Text.UTF8Encoding]::new()。这个坑在读取中文文件内容时尤其明显建议一次处理完否则排查问题容易被编码干扰。6.4 本地模型/转发服务一直“Waiting for API response”如果你不是直接用云平台API而是通过LM Studio等本地模型服务转发会遇到一个经典现象ClaudeCode发请求后一直转圈最后报“waiting for api response”。原因通常是端点格式不匹配。ClaudeCode期望的是Anthropic兼容端点而LM Studio默认暴露的是OpenAI风格接口直接填http://localhost:1234/v1是不被认的。解决方向有两个一是检查服务有没有提供Anthropic兼容路径二是加一层协议转换把OpenAI端点翻译成Anthropic格式再给ClaudeCode用。不要指望填个地址就能通先确认端点格式再说。6.5 每步都确认烦到想砸键盘ClaudeCode安全确认虽然保险但高频操作时确实打断节奏。我现在的做法很固定开发目录里第一次进入项目用默认确认模式跑一遍确认改动符合预期后如果做的是批量机械操作比如改格式、补注释就用--dangerously-skip-permissions重启一个会话干干完立刻退出。另外也可以用/permissions把常用命令加白名单两种方式配合效率和安全都能兼顾。6.6 想看AI到底干了什么日志与推理过程ClaudeCode的交互比较黑盒但它支持调试日志。启动时加--debug或--verbose参数就能在输出里看到每次请求的本地上下文、发送的提示词片段、API响应信息。如果怀疑“它是不是没读到某个文件”可以用这个方式确认。另外会话内输入/status能查看当前上下文占用、模型、工作目录等状态推荐养成习惯。最后聊点个人体会。这套组合用下来最让我省心的是它把“模型能力”和“工具能力”拆开了。ClaudeCode的工程能力在工具层面国产大模型提供算力与价格层面的优势两者结合之后我在Windows上做日常开发基本感觉不到模型切换成本。如果你照着文章走完一遍最值得体会的不是安装本身而是“让AI在项目里连续干活”的节奏感。先用小任务跑通再慢慢把权限、Skill和日志都调成适合你的样子这套组合会越用越顺手。