Claude Code + GLM-4.6 跨平台开发环境搭建全攻略 (Windows/Mac/Linux)

1. Claude Code与GLM-4.6开发环境概述

如果你是一名开发者，最近可能已经听说过Claude Code和GLM-4.6这对黄金组合。Claude Code是由Anthropic公司开发的智能编程助手，它可以直接在你的终端中运行，通过自然语言交互帮你完成代码生成、调试、重构等各种开发任务。而GLM-4.6则是智谱AI最新推出的大语言模型，特别针对中文场景和编程任务进行了优化。

这对组合最大的优势在于它们的互补性：Claude Code提供了强大的开发工具链和交互界面，而GLM-4.6则提供了高质量的模型能力支持。特别是在国内使用环境下，GLM-4.6相比国外模型有着明显的网络优势和价格优势。

我最近在自己的Windows、Mac和Linux三台开发机上全部配置了这个环境，实测下来发现它不仅安装简单，而且运行稳定。相比之前需要折腾各种代理配置，现在只需要几个简单的命令就能搞定。下面我就来详细分享下具体的安装和配置过程。

2. 环境准备与前置条件

在开始安装之前，我们需要确保系统满足一些基本要求。好消息是，Claude Code+GLM-4.6对硬件的要求并不高，普通开发机都能流畅运行。

2.1 操作系统要求

对于Windows用户，建议使用Windows 10或11系统。早期版本可能需要额外配置。Mac用户需要macOS 12及以上版本。Linux用户则推荐Ubuntu 20.04 LTS或更新的发行版。

2.2 必备软件安装

首先需要安装Node.js，这是运行Claude Code的基础环境。建议安装LTS版本（目前是18.x或更高）。安装方法很简单：

# Windows用户可以从官网下载安装包
# Mac用户推荐使用Homebrew：
brew install node

# Linux用户（以Ubuntu为例）：
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

验证安装是否成功：

node -v
npm -v

Git也是必需的，特别是Windows用户需要用它来提供Bash环境。不过最新版的Claude Code已经不再强制依赖Git，但建议还是安装以备不时之需。

# Mac
brew install git

# Linux
sudo apt install git

# Windows用户可以从Git官网下载安装包

3. Windows系统安装指南

Windows可能是最多开发者使用的平台，下面我会详细介绍在Windows上的完整安装流程。

3.1 安装Claude Code核心组件

打开PowerShell（管理员权限），运行以下命令：

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

安装完成后，可以验证下版本：

claude --version

如果遇到权限问题，可以尝试以下解决方案：

1. 以管理员身份运行PowerShell
2. 检查Node.js安装路径是否在系统PATH中
3. 可能需要配置执行策略：Set-ExecutionPolicy RemoteSigned

3.2 配置GLM-4.6环境变量

这是最关键的一步，我们需要告诉Claude Code使用GLM-4.6作为后端模型。

在Windows搜索栏输入"环境变量"，选择"编辑系统环境变量"→"环境变量"，在用户变量中添加以下三项：

变量名：ANTHROPIC_API_KEY
变量值：你的GLM API Key

变量名：ANTHROPIC_AUTH_TOKEN  
变量值：同上

变量名：ANTHROPIC_BASE_URL
变量值：https://open.bigmodel.cn/api/anthropic

保存后需要重启终端才能使变更生效。

3.3 VS Code插件配置（可选）

如果你使用VS Code，可以安装官方插件获得更好的集成体验：

1. 打开VS Code扩展市场
2. 搜索"Claude Code for VS Code"
3. 安装后重启VS Code
4. 点击右上角的Claude图标即可开始使用

插件会自动识别你已经配置的环境变量，无需额外设置。

4. Mac系统安装指南

Mac下的安装流程与Windows类似，但有一些细节差异。

4.1 使用Homebrew安装

推荐使用Homebrew来管理依赖：

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

4.2 配置环境变量

Mac下需要在shell配置文件中添加环境变量。如果你使用zsh（Mac默认）：

nano ~/.zshrc

添加以下内容：

export ANTHROPIC_API_KEY="你的API Key"
export ANTHROPIC_AUTH_TOKEN="你的API Key"
export ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic"

保存后使配置生效：

source ~/.zshrc

4.3 验证安装

运行以下命令测试是否配置成功：

claude

如果看到交互式命令行界面，说明安装成功。你可以尝试输入简单的编程问题，比如"用Python写一个快速排序"，看看是否能得到正确的代码回复。

5. Linux系统安装指南

Linux下的安装流程与Mac类似，主要区别在于包管理工具。

5.1 通过APT安装

对于基于Debian的系统（如Ubuntu）：

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs git

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

5.2 环境变量配置

编辑bash配置文件：

nano ~/.bashrc

添加与Mac相同的环境变量内容，然后：

source ~/.bashrc

6. 常见问题与解决方案

在实际安装过程中，可能会遇到各种问题。这里我总结了一些常见情况及解决方法。

6.1 网络连接问题

如果安装过程中出现网络超时，可以尝试：

# 设置npm镜像源
npm config set registry https://registry.npmmirror.com

# 或者使用代理（如果有）
npm config set proxy http://your.proxy:port

6.2 权限问题

在Linux/Mac上可能会遇到权限错误，解决方案：

# 避免使用sudo npm install
# 可以修复npm权限
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

6.3 API Key无效

如果配置后仍然无法使用GLM-4.6，检查：

1. API Key是否正确
2. 是否在智谱AI平台开通了相应服务
3. 环境变量是否生效（可以echo $ANTHROPIC_API_KEY查看）

7. 进阶配置与使用技巧

基础安装完成后，下面介绍一些提升使用体验的技巧。

7.1 配置模型映射

默认情况下，Claude Code会使用GLM-4.6作为主模型。你可以在~/.claude/settings.json中配置更详细的模型映射：

{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.6"
  }
}

7.2 使用MCP扩展功能

MCP（Model Context Protocol）可以扩展Claude Code的能力。例如安装文档搜索工具：

claude mcp add --transport http context7 https://mcp.context7.io/anthropic

7.3 常用命令速查

• claude edit 文件名：编辑指定文件
• claude generate "描述"：根据描述生成代码
• /clear：清空当前会话
• /status：查看当前模型状态
• /mcp list：列出已安装的MCP扩展

8. 性能优化建议

为了让Claude Code+GLM-4.6运行得更流畅，可以考虑以下优化：

1. 在~/.claude/settings.json中添加：

{
  "env": {
    "API_TIMEOUT_MS": "300000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  }
}

2. 对于大型项目，可以使用.claudeignore文件排除不需要分析的文件，类似.gitignore

3. 定期清理会话历史：

rm -rf ~/.claude/sessions/*

4. 保持Claude Code更新到最新版本：

claude update

经过这样完整的配置，你现在应该可以在Windows、Mac或Linux上流畅使用Claude Code与GLM-4.6的组合了。这个环境特别适合日常开发、快速原型构建和代码维护任务。相比直接使用国外模型，GLM-4.6提供了更稳定的连接和更具性价比的服务。