Jessie职业规划1. 项目概述
最近在开发一个AI辅助编程工具时，发现Claude Code结合智谱GLM-5.1大模型的效果非常出色。但在实际配置过程中，发现不同操作系统下的安装和配置存在不少坑点。本文将详细记录我在Windows、macOS和Ubuntu三大平台上的完整配置过程，包括环境准备、依赖安装、API配置和常见问题解决。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备
2.1 Node.js安装与验证
Node.js是运行Claude Code的基础环境，建议使用v18或更高版本。不同系统的安装方式略有差异：
- Windows：直接下载官方安装包，建议勾选"自动安装必要工具"选项
- macOS：推荐使用Homebrew安装：
brew install node@18 - Ubuntu：通过官方PPA安装最新LTS版本：
bash复制curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo apt-get install -y nodejs
安装完成后，在终端执行node -v和npm -v验证版本。我曾遇到过Ubuntu上默认安装的Node.js版本过低的问题，通过上述PPA方式可以完美解决。
2.2 Git安装与配置
Git用于版本控制，虽然Claude Code本身不需要Git，但很多配套工具会依赖它：
- Windows：安装Git for Windows时，建议选择"Use Git and optional Unix tools from the Command Prompt"选项
- macOS：Xcode Command Line Tools已包含Git，也可通过Homebrew安装
- Ubuntu：标准apt安装即可
提示：Windows用户安装后务必重启终端，否则可能找不到git命令
3. Claude Code安装
3.1 全局安装
使用npm全局安装Claude Code包：
bash复制npm install -g @anthropic-ai/claude-code
不同系统的权限处理：
- Windows：需以管