> 目标：在 **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` 添加：

```bash
export PATH="$USERPROFILE/.local/bin:$PATH"
```

### 2.2 配置 CLAUDE\_CODE\_GIT\_BASH\_PATH（关键）

在 Git Bash 里先找出 bash.exe 的 Windows 路径：

```bash
cygpath -w "$(which bash)"
```

得到类似 `D:\Program Files\Git\usr\bin\bash.exe` 或 `D:\Program Files\Git\bin\bash.exe`。
推荐指向 `...\Git\bin\bash.exe`（更标准），然后在 `~/.bashrc` 添加：

```bash
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`：

```bash
cat > ~/.bash_profile <<'EOF'
if [ -f ~/.bashrc ]; then
  source ~/.bashrc
fi
EOF
```

然后 ​**关闭 Git Bash → 重新打开**​，验证：

```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`）：

```bash
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 标记）

```bash
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` 删除/注释掉：
  ```bash
  export ANTHROPIC_API_KEY=...
  ```
* 或当前会话立刻生效：
  ```bash
  unset ANTHROPIC_API_KEY
  ```

---

## 5. 启动与验证

1. 重新打开 Git Bash（确保 profile 生效）
2. 启动：

```bash
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`（只保留一个）

---

## 智普如何省钱呢？

哈哈，看到这里，如何省钱呢，请和我一起速来拼好模薅羊毛!

🚀 智谱 GLM Coding 超值订阅，邀你一起薅羊毛！Claude Code、Cline 等 20+ 大编程工具无缝支持，“码力”全开，越拼越爽！立即开拼，享限时惊喜价！
链接：https://www.bigmodel.cn/glm-coding?ic=ZNBH1GRBPY