环境：Windows + PowerShell

---

一、前置条件

项目	要求
Node.js	v18+
Claude Code	v2.1.42+（推荐最新版）
Git for Windows	已安装（Windows 必须）
GLM Coding Plan	已开通（智谱 BigModel）

---

二、安装 Claude Code

npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

---

三、配置 GLM Coding Plan

方法一：官方自动化工具（推荐）

npx @z_ai/coding-helper

按交互式提示完成配置，会自动处理环境变量和模型映射。

方法二：手动配置

1. 修改 ~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_API_KEY": "你的GLM API Key",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.1",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.1"
  }
}

2. 关键配置项说明

环境变量	作用	正确值
ANTHROPIC_API_KEY	智谱平台生成的 API Key	在 API Key 管理 获取
ANTHROPIC_BASE_URL	API 代理地址	https://open.bigmodel.cn/api/anthropic
ANTHROPIC_DEFAULT_HAIKU_MODEL	快速模型（轻量任务）	glm-4.5-air
ANTHROPIC_DEFAULT_SONNET_MODEL	主力模型（日常编码）	glm-5.1
ANTHROPIC_DEFAULT_OPUS_MODEL	高级模型（复杂推理）	glm-5.1

注意：ANTHROPIC_BASE_URL 的路径是 /api/anthropic，不是 /api/paas/v4。路径错误会导致 Claude Code 回退到默认模型。

---

四、启动与验证

1. 启动

# 关闭所有 Claude Code 窗口后，开新终端
claude

2. API Key 确认

首次启动会提示：

Detected a custom API key in your environment
ANTHROPIC_API_KEY: sk-ant-...87f
Do you want to use this API key?
  1. Yes
  2. No (recommended)

选 No！

原因：选 Yes 会让 Claude Code 将 API Key 存储为内部 Auth Token，与已有的环境变量 ANTHROPIC_API_KEY 冲突，导致 Auth conflict 警告。选 No 时，Claude Code 仍然会从环境变量中读取 API Key 正常工作。

3. 验证模型

# Claude Code 内输入
/status    # 查看当前模型状态
/model     # 切换模型

成功标志：

• 启动界面显示 glm-4.5-air · API Usage Billing
• 无 Auth conflict 警告
• /model 可切换到已配置的 GLM 模型

---

五、常见问题排查

1. Auth conflict 警告

⚠Auth conflict: Both a token (ANTHROPIC_AUTH_TOKEN) and an API key (ANTHROPIC_API_KEY) are set.

原因：之前选了 “Yes” 导致 Claude Code 内部存储了 token。

解决：

claude /logout        # 清除内部 token
claude                # 重启，这次选 No

2. 模型不显示 / 显示 Haiku 4.5

原因：ANTHROPIC_BASE_URL 路径错误。

检查：

echo $env:ANTHROPIC_BASE_URL
# 应输出：https://open.bigmodel.cn/api/anthropic
# 如果是 /api/paas/v4 就错了

修复：修改 ~/.claude/settings.json 中的 ANTHROPIC_BASE_URL 为正确路径。

3. 配置修改不生效

• 关闭所有 Claude Code 窗口
• 开新的终端窗口
• 重新运行 claude
• 如果还不行：删除 ~/.claude/settings.json，重新配置

4. 升级 Claude Code

claude --version     # 查看当前版本
claude update        # 升级到最新版

---

六、环境变量查看命令速查

# 查看所有相关环境变量
Get-ChildItem Env: | Where-Object { $_.Name -match "ANTHROPIC|CLAUDE" } | Format-Table Name, Value

# 检查用户级持久化变量
[System.Environment]::GetEnvironmentVariable("ANTHROPIC_API_KEY", "User")
[System.Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "User")

# 清除用户级 AUTH_TOKEN
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", $null, "User")

---

七、参考链接

• 智谱官方 Claude Code 文档
• GLM Coding Plan 开通
• API Key 管理
• GitHub: glm-cookbook 集成教程