Windows 10 + Git Bash 安装 Claude Code 并接入智谱（BigModel）
目标：在 Git Bash 里运行
claude，后端走 智谱 BigModel（Claude 兼容接口）。 说明：若你只连国内智谱接口，通常不需要代理。
0. 前置条件
- Windows 10
- 已安装 Git for Windows（带 Git Bash）
- 有智谱的 Claude 兼容接口 Key（请勿泄露）
1. 安装 Claude Code（只做安装）
安装步骤用 PowerShell 跑一次即可（你后续只在 Git Bash 用）。 安装完成后
claude.exe通常在：C:\Users\<你>\.local\bin\claude.exe
2. Git Bash 必备配置（让 claude 能跑）
2.1 把 Claude 加入 PATH（Git Bash）
在 ~/.bashrc 添加：
export PATH="$USERPROFILE/.local/bin:$PATH"
2.2 配置 CLAUDE_CODE_GIT_BASH_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"
记得把盘符/路径改成你机器实际值。
2.3 永久修复：确保 Git Bash 启动会加载 ~/.bashrc（坑点）
很多 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
3. 接入智谱 BigModel（推荐用 settings.json，不靠 shell 变量）
最稳：把 BigModel 配置写到
~/.claude/settings.json，避免不同启动方式读不到环境变量。
3.1 写入 ~/.claude/settings.json（必须是纯 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
3.2 写入 ~/.claude.json（智谱文档要求的 onboarding 标记）
cat > ~/.claude.json <<'EOF'
{
"hasCompletedOnboarding": true
}
EOF
注意：
settings.json必须是纯 JSON，不要混入任何命令输出（否则会解析失败，Claude 会退回默认登录流程）。
4. 认证冲突处理（坑点：Auth conflict）
如果看到告警：
Both ANTHROPIC_AUTH_TOKEN and ANTHROPIC_API_KEY are set…
说明你同时设置了两种鉴权变量。按智谱方案 只保留 ANTHROPIC_AUTH_TOKEN：
- 从
~/.bashrc删除/注释掉：export ANTHROPIC_API_KEY=... - 或当前会话立刻生效：
unset ANTHROPIC_API_KEY
5. 启动与验证
- 重新打开 Git Bash（确保 profile 生效）
- 启动：
claude
常见坑位清单（速查）
claude找不到：$USERPROFILE/.local/bin没加到 Git Bash 的PATH- 提示 requires git-bash：没读到
CLAUDE_CODE_GIT_BASH_PATH或.bashrc未加载 .bashrc写了但不生效：需要~/.bash_profile去source ~/.bashrc- 仍然弹登录菜单：
~/.claude/settings.json不是合法 JSON（被混入命令输出等） - Auth conflict：同时设置了
ANTHROPIC_AUTH_TOKEN和ANTHROPIC_API_KEY（只保留一个）
