一、Windows 11 安装 Claude Code

前置条件

1. 安装 Git for Windows — Claude Code 内部依赖 Git Bash 执行命令

• • 下载地址：https://git-scm.com/download/win
  • 一路 Next 默认安装即可
  • 验证：git --version

1. （可选）安装 Node.js 18+ — 如果原生安装失败，可用 npm 方式

安装方式（推荐原生安装）

方式一：PowerShell 一键安装（推荐）

powershell

irm https://claude.ai/install.ps1 | iex

方式二：CMD 安装

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

如果报错 app-unavailable-in-region，需要先开启代理，然后在 CMD 中设置临时代理：

set https_proxy=http://127.0.0.1:7897

方式三：npm 安装（备选）

npm install -g @anthropic-ai/claude-code --registry https://registry.npmmirror.com

安装后配置环境变量

安装完成后，将以下路径添加到系统 PATH：

C:\Users\你的用户名\.local\bin

验证安装，在cmd命令窗口执行：

claude --version

---

二、配置智谱（Zhipu）大模型

智谱官方提供了与 Claude API 兼容的接口，Claude Code 可以直接接入 。

步骤 1：获取智谱 API Key

1. 访问 智谱开放平台
2. 注册/登录账号
3. 创建 API Key 并复制保存

步骤 2：配置 Claude Code（Windows 版）

在 Windows 上，Claude Code 的配置文件位于：

C:\Users\你的用户名\.claude\settings.json

创建或编辑该文件，添加以下内容 ：

JSON

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的智谱API Key",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.1"
  }
}

关键注意点：

• 智谱使用 ANTHROPIC_AUTH_TOKEN，不是ANTHROPIC_API_KEY
• Base URL 必须是 https://open.bigmodel.cn/api/anthropic
• 不要设置 ANTHROPIC_MODEL="glm-5.1"，而是通过 ANTHROPIC_DEFAULT_*_MODEL 做模型映射

步骤 3：完成初始化配置

编辑用户目录下的 .claude.json 文件（如 C:\Users\你的用户名\.claude.json），添加：

JSON

{
  "hasCompletedOnboarding": true
}

步骤 4：启动使用

cmd

claude

首次启动时选择信任 Claude Code 访问文件夹，之后即可正常使用。

---

三、智谱推荐模型对照表

表格

Claude 模型角色	智谱映射模型	特点
Haiku（轻量快速）	glm-4.5-air	快速响应，成本低
Sonnet（平衡主力）	glm-4.7	推理能力强，代码生成优秀
Opus（最强智能）	glm-5.1	旗舰性能，长程任务可达8小时

---

四、常见问题排查

表格

问题	解决方案
claude 不是内部命令	检查 PATH 是否包含 .local\bin 路径
模型不存在/无访问权限	确认使用 ANTHROPIC_AUTH_TOKEN 而非 ANTHROPIC_API_KEY
网络连接失败	智谱 API 国内可直接访问，无需代理
安装时下载慢	使用 npm 方式 + 国内镜像 --registry https://registry.npmmirror.com

五、接入deepseek

如果已经settings.json配置了其他的模型可以备份换成下面的deepseek的
在 Windows 上，Claude Code 的配置文件位于：

C:\Users\你的用户名\.claude\settings.json

创建或编辑该文件，添加以下内容 ：

JSON

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "您的deepseek key",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash[1m]",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_EFFORT_LEVEL": "max",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "model": "opus"
}