Windows 10 使用 Git Bash 安装 Claude Code 接入智谱 BigModel
本文介绍了在 Windows 10 系统下,利用 Git Bash 环境安装 Claude Code 工具,并将其接入智谱 BigModel 接口的详细步骤。内容涵盖环境配置、环境变量设置、配置文件编写及常见问题排查,帮助用户在无代理环境下完成本地 AI 编程工具的部署与使用。

本文介绍了在 Windows 10 系统下,利用 Git Bash 环境安装 Claude Code 工具,并将其接入智谱 BigModel 接口的详细步骤。内容涵盖环境配置、环境变量设置、配置文件编写及常见问题排查,帮助用户在无代理环境下完成本地 AI 编程工具的部署与使用。

目标:在 Git Bash 里运行
claude,后端走 智谱 BigModel(Claude 兼容接口)。 说明:若你只连国内智谱接口,通常不需要代理。
安装步骤用 PowerShell 跑一次即可(你后续只在 Git Bash 用)。 安装完成后
claude.exe通常在:C:\Users\<你>\.local\bin\claude.exe
claude 能跑)在 ~/.bashrc 添加:
export PATH="$USERPROFILE/.local/bin:$PATH"
在 Git Bash 里先找出 bash.exe 的 Windows 路径:
cygpath -w "$(which bash)"
得到类似 D:\Program Files\Git\usr\bin\bash.exe 或 D:\Program Files\Git\bin\bash.exe。推荐指向 ...\Git\bin\bash.exe(更标准),然后在 ~/.bashrc 添加:
export CLAUDE_CODE_GIT_BASH_PATH="D:/Program Files/Git/bin/bash.exe"
记得把盘符/路径改成你机器实际值。
很多 Git Bash 启动是 login shell,不一定自动加载 .bashrc。创建/覆盖 ~/.bash_profile:
cat > ~/.bash_profile <<'EOF'
if [ -f ~/.bashrc ]; then
source ~/.bashrc
fi
EOF
然后 关闭 Git Bash → 重新打开,验证:
echo "$CLAUDE_CODE_GIT_BASH_PATH"
claude --help
最稳:把 BigModel 配置写到
~/.claude/settings.json,避免不同启动方式读不到环境变量。
在 Git Bash 执行(替换 YOUR_BIGMODEL_KEY):
mkdir -p ~/.claude
cat > ~/.claude/settings.json <<'EOF'
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_BIGMODEL_KEY",
"ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
"API_TIMEOUT_MS": "3000000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
}
}
EOF
cat > ~/.claude.json <<'EOF'
{
"hasCompletedOnboarding": true
}
EOF
注意:
settings.json必须是纯 JSON,不要混入任何命令输出(否则会解析失败,Claude 会退回默认登录流程)。
如果看到告警:
Both ANTHROPIC_AUTH_TOKEN and ANTHROPIC_API_KEY are set…
说明你同时设置了两种鉴权变量。按智谱方案 只保留 ANTHROPIC_AUTH_TOKEN:
~/.bashrc 删除/注释掉:
export ANTHROPIC_API_KEY=...
unset ANTHROPIC_API_KEY
claude
claude 找不到:$USERPROFILE/.local/bin 没加到 Git Bash 的 PATHCLAUDE_CODE_GIT_BASH_PATH 或 .bashrc 未加载.bashrc 写了但不生效:需要 ~/.bash_profile 去 source ~/.bashrc~/.claude/settings.json 不是合法 JSON(被混入命令输出等)ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY(只保留一个)
微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML 转 Markdown在线工具,online