在 Windows 10 上用 Git Bash 装好 Claude Code再让它接上智谱 BigModel 的服务这个组合我前后折腾了一下午才算完全理顺。装完之后最大的感触是这个终端 AI 编程助手并没有想象中那么依赖特定的操作系统或网络环境只要选对终端模拟器、处理好环境变量普通开发者完全可以在本地轻松跑起来。这篇内容适合正在用 Windows 10 做开发、想尝试 Claude Code 但希望使用 BigModel 平台模型服务的读者。我会完整走一遍从环境检查、工具安装到配置接入、常见问题排查的全过程把每一步背后的原因也说清楚。这样哪怕你之前完全没接触过这类工具跟着操作也能上手。1. 先理清这条链路里各个角色的分工1.1 Claude Code 是个什么样的工具Claude Code 本质上是一个运行在终端里的 AI 编程助手。它不像普通聊天网页那样只做问答而是能直接读取你当前项目目录里的文件理解整个代码库的结构然后帮你改代码、写测试、执行命令、排查报错。它通过 npm 分发安装命令就是一条npm install -g。安装之后你在项目目录里敲claude就能进入交互界面。进入之后你可以用自然语言描述需求它会读取文件内容并给出修改建议甚至直接生成 diff 让你确认。对于每天要在编辑器、终端、文档之间来回切换的开发者来说这种“不离开终端就能完成编码辅助”的体验非常连贯。很多人以为 Claude Code 只能在 macOS 或 Linux 上用其实 Windows 也没问题。关键在于两点第一Claude Code 依赖 Node.js 运行时Windows 上装好 Node 后就能跑第二它需要的是一个接近 Unix 风格的终端环境而 Git Bash 恰好能提供这个环境。这两点满足了Windows 10 完全能作为 Claude Code 的主机。1.2 Claude Code 凭什么能把请求转给 BigModelClaude Code 默认情况下会连接它官方定义的接口地址但工具本身留了一个很实用的口子通过环境变量可以修改接口地址。这个设计本来是为了方便企业用户接入私有化部署的服务或者让不同的模型网关来承接请求结果对使用第三方模型服务的开发者来说也非常友好。具体原理是Claude Code 发出的请求遵循 Anthropic Messages API 的消息格式而智谱 BigModel 开放平台提供了兼容这一格式的接入端点。只要我把 Claude Code 的接口地址改成 BigModel 提供的兼容端点同时把认证信息换成智谱的 API Key那么 Claude Code 发出的请求就会被转发到智谱的模型服务上由 GLM 系列模型来实际完成推理。这套机制意味着你不需要修改 Claude Code 本身的代码只需要在启动前设置好几个环境变量。整个过程既简单又可逆——想切回默认服务取消环境变量就行。这也是我比较推荐的方式因为你始终用的是原版 Claude Code 客户端只是把“请求该往哪里发”这件事重新指了一下。1.3 为什么在 Windows 上必须选用 Git Bash在 Windows 10 上你可能第一个想到的是用命令提示符 cmd 或者 PowerShell 来跑 Claude Code。这两个终端我也试过能用但体验很别扭。Claude Code 是交互式终端程序对终端环境的进程控制、彩色输出、快捷键支持都有要求。cmd 的终端渲染能力有限PowerShell 虽然强一些但它的环境变量语法和类 Unix 工具链的协作并不顺畅偶尔会出现输出错乱或者按键无响应的情况。Git Bash 是安装 Git for Windows 时自带的一个终端模拟器它提供了一个类 Linux 的命令行环境。你在里面可以用export设置环境变量可以用source让配置立即生效也可以用ls、grep、curl这些熟悉的命令。Claude Code 在这种环境下运行几乎和在 macOS 终端里的表现一致。另外有一个实际原因Claude Code 的配置文件、环境变量引导大多是基于 bash 语法写的网上能找到的大多数接入案例也都是 bash 命令。如果你用 PowerShell很多命令要额外翻译一遍稍不注意就会踩坑。所以我的建议是既然要用 Claude CodeWindows 上就老老实实从 Git Bash 开始。2. 动手前的三项检查Node.js、Git Bash 与智谱API Key2.1 Node.js版本别低于 18Claude Code 是 Node.js 应用所以机器上必须先有 Node.js 运行时和 npm 包管理器。我建议安装最新的 LTS 版本至少也要 18 以上。版本太低的话安装时会报引擎不兼容的错误或者装上了但运行到一半出现奇怪的问题。打开 Git Bash输入下面两条命令检查版本node -v npm -v如果你已经装了 Node.js但node命令在 Git Bash 里识别不了一般是环境变量 PATH 没配置好或者安装时没勾选自动加入 PATH。遇到这种情况最简单的方法是去 Node.js 官网重新下载安装包安装过程中保持默认的“Add to PATH”选项勾选装完重开 Git Bash 再试。如果你没有装过 Node.js直接装最新 LTS 就行。安装完成后记得重新打开一个 Git Bash 窗口因为环境变量变更不会自动同步到已打开的终端里。2.2 Git Bash确认能打开并能运行命令行工具Git Bash 来自 Git for Windows很多人电脑上已经装了 Git那就自带 Git Bash。你可以直接在开始菜单里搜索“Git Bash”确认一下。打开后输入git --version能输出版本号就说明 Git Bash 环境没问题。顺便建议把 Git Bash 固定到任务栏后面会经常用到。如果你完整安装了 Git for Windows 但找不到 Git Bash大概率是安装时取消了附加组件。这种情况直接重新运行安装包在“Select Components”界面勾选“Git Bash Here”之类的选项补装一下就行。2.3 智谱API Key在 BigModel 平台控制台创建这一步是整个方案的认证基础。你需要有一个 BigModel 开放平台的账号登录后在控制台找到“API Keys”相关页面创建一个新的 API Key。创建时注意两点第一Key 创建成功后会显示一次完整的密钥字符串要立刻保存到本地备忘工具里刷新页面后就只能看到脱敏信息了第二API Key 本身是计费凭证调用模型会产生费用不要在文档、博客、公共代码仓库里明文暴露它。另外除了 API Key你还需要知道智谱开放平台提供的 Anthropic 兼容端点地址。以 BigModel 当前文档为例兼容端点类似https://open.bigmodel.cn/api/anthropic这个地址在不同时期可能有调整建议以你在控制台或官方文档里看到的实际地址为准。写配置的时候接口地址和 API Key 缺一不可。提示在控制台里多花一分钟确认一下你的账户是否已经开通了目标模型的调用权限以及账户余额或赠金是否足够。这些前置状态决定了后面测试时会不会撞上 401 或额度类报错。3. 安装 Claude Code全局装上再确认版本3.1 一条 npm 命令完成安装环境检查完毕后安装本身的步骤其实很短。在 Git Bash 中执行npm install -g anthropic-ai/claude-code-g表示全局安装这样你在任意目录下都能直接执行claude命令。安装过程会下载一组依赖包耗时取决于网络状况一般几十秒到几分钟不等。看到类似added xxx packages的提示就说明安装完成了。这里有一点容易被忽略npm 全局安装的目录在 Windows 上有可能是用户目录下的AppData\Roaming\npm。如果后续你在 Git Bash 里执行claude提示找不到命令先检查这个目录是否在系统 PATH 环境变量里。大多数情况下npm 在安装时会把全局 bin 目录自动加进 PATH但如果你改过 PATH就可能会丢。3.2 安装完先别启动优先检查版本安装完成后先执行claude --version看到版本号说明客户端本体没问题。我遇到过有人安装完直接敲claude启动结果因为某些版本依赖不匹配或者终端环境没准备好界面起不来还以为是安装失败了。实际上只要版本命令能正常输出版本号安装这一步就算通过了。接下来要做的就是配置环境变量。很多教程会把“安装”和“启动”连在一起讲但在这个接入方案里安装后必须先完成环境变量配置再启动客户端。顺序反了的话Claude Code 一启动就可能进入默认的登录流程和我们的目标就不一致了。3.3 多终端环境下的 npm 全局路径问题Windows 上经常同时装着多个终端入口cmd、PowerShell、Windows Terminal、Git Bash。你通过 npm 全局安装的命令理论上这些终端都能用但前提是 PATH 环境变量一致。我自己的习惯是所有安装和配置操作都在 Git Bash 里完成启动 Claude Code 也只从 Git Bash 启动。这样路径一致、配置一致排查问题的时候只需要盯住一个终端环境能省掉很多由于终端差异带来的困惑。如果你非要在 Windows Terminal 里集成 Git Bash那也是可以的本质上还是用 bash 解析器来执行命令而不是用 PowerShell。4. 核心配置用环境变量把 Claude Code 指向 BigModel4.1 三个环境变量各管什么整个接入方案的核心是把 Claude Code 默认的“目标服务地址”和“认证信息”替换成智谱 BigModel 的。这一步不需要改任何配置文件只需要在终端环境里设置好下面几个环境变量。环境变量作用示例值ANTHROPIC_BASE_URL指定 API 请求发往的服务地址https://open.bigmodel.cn/api/anthropicANTHROPIC_AUTH_TOKEN传递认证 Token这里填智谱 API Key你的智谱API KeyANTHROPIC_MODEL指定默认使用的模型 IDglm-4.5 或其他可用模型ANTHROPIC_BASE_URL是修改请求地址的关键。Claude Code 官方客户端有一个默认的服务地址设置了这个环境变量后客户端会把所有 API 请求发送到新地址而不是默认地址。ANTHROPIC_AUTH_TOKEN是认证凭证。客户端在发送请求时会把这里的字符串作为 Bearer Token 放到请求头里智谱的兼容端点会校验这个 Token 是否有效。注意这里填的一定是智谱的 API Key而不是 Claude Code 官方的账号信息。ANTHROPIC_MODEL用于指定默认模型。如果你不在客户端里手动切换模型那么所有对话都会使用这个模型 ID 对应的模型。具体的模型 ID 要以智谱平台控制台显示的为准不同时期的可用模型会不一样。4.2 把配置写进 ~/.bashrc一劳永逸环境变量如果只在当前终端窗口里临时设置那每次打开新窗口都要重新设置一遍显然不现实。正确做法是写进 Git Bash 的启动配置文件中让每个新打开的终端都自动加载这些变量。在 Git Bash 里执行echo export ANTHROPIC_BASE_URLhttps://open.bigmodel.cn/api/anthropic ~/.bashrc echo export ANTHROPIC_AUTH_TOKEN粘贴你的智谱API Key ~/.bashrc echo export ANTHROPIC_MODELglm-4.5 ~/.bashrc执行完可以用文本编辑器打开~/.bashrc确认一下内容。这里的~在 Git Bash 中对应你的用户目录。这三行配置会把环境变量注入到每次启动的 bash 会话中。需要注意的是~/.bashrc只对 bash 会话生效。如果你之后用 PowerShell 或者 cmd 去执行claude这些环境变量不会存在Claude Code 就会回到默认行为。所以请坚持在 Git Bash 里启动。如果你发现每次打开 Git Bash~/.bashrc里的配置有时生效有时不生效原因可能是 Git Bash 的登录 shell 优先加载~/.bash_profile而你的~/.bash_profile里没有引用~/.bashrc。解决方法是在~/.bash_profile中添加一行source ~/.bashrc这样无论怎么加载最终都会执行~/.bashrc里的配置。4.3 别小看这里的认证变量选择你可能注意到我用的是ANTHROPIC_AUTH_TOKEN而不是常见的ANTHROPIC_API_KEY。这里有一个很关键的避坑细节。Claude Code 对ANTHROPIC_API_KEY这个变量有格式校验它会期望值以sk-ant-开头这是官方 API Key 的特征。智谱的 API Key 通常不是这个格式如果你把智谱 Key 填到ANTHROPIC_API_KEY里客户端会直接认为密钥格式不合法拒绝请求。ANTHROPIC_AUTH_TOKEN则没有这么严格的前缀校验它更像是“不管你是谁给我一个 Token 就行”。智谱的 API Key 放到这个变量里兼容端点能正常识别并完成认证。这是我反复试错之后得出的经验也是整个接入方案能够跑通的细节之一。4.4 配置生效与验证配置写进文件后执行下面的命令让配置在当前窗口立即生效source ~/.bashrc然后验证环境变量是否正确echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_AUTH_TOKEN如果输出的值和你设置的一致第一阶段配置就完成了。注意为了安全你可以在确认输出后不再重复打印 API Key避免它残留在终端历史记录里。还有一个验证思路是直接测试兼容端点的连通性。你可以用 curl 发一个小请求确认 API Key 和地址是否可用。不过这一步不是必需的因为稍后启动 Claude Code 进行首次对话时如果配置有问题客户端本身就会给出明确的报错信息到时候再有针对性地排查也不迟。5. 启动 Claude Code首次对话、确认模型与跑通小任务5.1 启动前的小习惯先进入你的项目目录Claude Code 是“面向项目”的 AI 助手它在启动时会以当前目录作为工作目录并读取这个目录下的文件来理解项目上下文。所以我建议进入一个具体的项目目录后再启动而不是直接在用户目录下敲claude。例如cd /d/projects/demo claude首次启动时Claude Code 可能会显示一些欢迎信息或提示这个过程需要一点耐心。如果一切正常你会进入一个交互式命令行界面提示符变成了类似的形式表示可以输入自然语言指令了。如果启动时出现登录相关的提示多半是环境变量没有被客户端读取到。这时先退出回到 Git Bash 里执行echo $ANTHROPIC_BASE_URL确认变量是否存在再检查是否把智谱 Key 写到了ANTHROPIC_AUTH_TOKEN这个正确变量里。5.2 进入交互界面后先看 /status 和 /model进入交互界面后不要急着提需求先执行两个内置命令确认当前状态。输入/status这个命令会展示当前连接状态、身份认证情况和工作目录信息。如果连接信息指向你设置的地址并且认证状态正常那就说明 Claude Code 已经成功和 BigModel 的兼容端点建立起连接。再输入/model这个命令会展示当前使用的模型 ID。你可以在这里检查模型 ID 是否和你预期的一致也可以在支持的情况下切换模型。如果你之前设置了ANTHROPIC_MODEL环境变量这里显示的应该就是你设置的那个模型。这两个命令是排查问题的第一站。凡是“感觉配好了但用不了”的情况先看这里大概率能发现问题出在哪个环节。5.3 用一个小任务验证整条链路状态确认无误后找一个简单的任务来验证全链路。比如让 Claude Code 读取项目里的某个文件回答一个关于代码逻辑的问题。比如说请阅读 README.md 并总结一下这个项目的核心功能如果模型正常返回了内容说明全链路已经打通Claude Code 发出的请求成功到达了智谱的兼容端点智谱的模型完成了推理结果又回到了你的终端。这时你还可以再试一个稍微动态的任务比如“给当前项目写一个 .gitignore 文件”。这类操作会触发 Claude Code 的文件写入能力你可以在编辑器里确认文件是否真正生成。这样不仅能验证对话链路还能验证工具调用能力。5.4 测试中的输出与计费观察跑通之后建议去 BigModel 平台控制台看一下本次请求的调用记录和 Token 消耗。这个习惯能帮你建立对模型调用成本的基本感知。我自己的经验是对话类的短任务消耗非常少但让模型批量生成代码、分析大文件时Token 消耗会快速增加。如果你用的是有免费额度的新账户更要留意用量避免在不经意间把额度用完。控制台一般都有用量明细按时间段筛选就能看到每个请求的 Token 数。6. Windows 10 Git Bash 环境下的常见问题清单6.1 换个终端就提示没登录或连不上这是出现频率最高的问题。很多人在 Git Bash 里配置好环境变量Claude Code 跑通了但换到 Windows Terminal 里的另一个标签页启动claude结果又回到了默认登录流程。原因很简单你配置的环境变量写在了~/.bashrc里这个文件只被 bash 会话读取。如果你在新的标签页里启动的是 PowerShell它根本不会执行~/.bashrc环境变量自然不存在。解决方法有两个要么坚持从 Git Bash 启动要么在 Windows Terminal 中把默认 shell 设置为 Git Bash。如果你的 Windows Terminal 已经把默认终端设置成了 Git Bash但还是读不到配置就检查~/.bash_profile是否存在以及它是否source了~/.bashrc。6.2 模型ID写错导致 404 / model not found请求能发出去但返回类似404、model not found的报错八成是模型 ID 写错了。智谱平台的模型 ID 是区分大小写的而且不同时期开放的模型名可能不一样。我建议不要手动敲模型 ID直接登录 BigModel 平台控制台在模型列表页面找到你需要的模型把 ID 原样复制出来然后粘贴到ANTHROPIC_MODEL环境变量或客户端的模型切换界面里。如果你设置完发现客户端还在用旧的模型 ID记得在交互界面里用/model命令查看当前实际生效的模型。如果显示的不是你设置的试试完全退出 Claude Code重新打开一个新会话。6.3 401 Unauthorized 和额度类提示401 报错说明认证没过常见原因有三个API Key 复制不完整、Token 里混入了空格或换行、API Key 对应的账户没有该模型的调用权限。Git Bash 中设置环境变量时引号里面的内容会原样保存。如果你复制 API Key 的时候多复制了一个换行符环境变量里就会带一个隐藏字符导致鉴权失败。遇到这种情况建议重新设置环境变量并且手动把 API Key 前后可能的多余字符删掉。还有一类提示和“余额不足”“没有权限”相关。这种基本不是在终端环境里能解决的需要回到 BigModel 控制台检查账户状态、模型权限和资源包情况。6.4 输出到一半中断或上下文超限用 Claude Code 处理比较大的代码文件时可能会遇到输出中断或者在请求阶段就提示内容长度超限。本质上是把 Claude Code 的默认请求参数和 BigModel 模型的上下文窗口对接时出现了不匹配。模型本身有上下文长度上限而 Claude Code 默认会尽量保留较长的会话历史。如果对话太长请求就可能超过模型能接受的范围。解决思路是控制单次对话的体量。可以把大任务拆成几个小步骤让 Claude Code 聚焦单个文件或单个函数也可以使用客户端内置的上下文压缩功能相关命令的入口可以通过输入/help查看不同版本略有差异。用完记得清理会话或开启新会话不要让历史记录无限制累积。6.5 编码与中文显示问题Windows 上的终端对 UTF-8 的支持一直不算完美。如果你项目里的文件包含中文注释、中文文件名Claude Code 在处理时偶尔会出现显示乱码或编码转换方面的小问题。我个人的建议是项目路径和文件名尽量使用英文避免中文和空格代码文件里的中文内容通常没问题因为这属于文件内容而非终端解析范围。如果你在终端输出里看到乱码可以在 Git Bash 里执行chcp.com 65001把代码页切到 UTF-8。需要说明的是Git Bash 本身对 UTF-8 的支持比 cmd 好很多绝大多数情况下不乱码。这个命令是用于特殊场景下的补充手段如果当前终端显示正常就不用动它。最后再分享一个我现在的个人习惯环境变量配置好后我会在项目根目录下建一个.claude/目录里面放一个简单的说明文件记录当前项目的模型配置和常用指令。这样换设备、换项目时直接看说明文件就能快速恢复环境不用每次都从零回忆配置过程。Windows 10 上跑 Claude Code 接 BigModel 这件事真正花时间的不是安装而是理解这些配置背后的逻辑。理顺了后面就顺畅了。