第一步：准备工作 - 检查 Node.js
1.1 检查 Node.js 版本
node --version
要求：Node.js 18 或更高版本。
1.2 如果没有安装，执行安装
注意：这一步时间较长，因为需要下载最新版本。
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
第二步：解决 npm 权限问题
2.1 问题说明
直接运行 npm install -g 会遇到权限错误：
npm error code EACCES
npm error Error: EACCES: permission denied
原因：npm 默认将全局包安装到系统目录（/usr/lib/node_modules/），需要 root 权限。
2.2 解决方案：配置 npm 使用用户目录
步骤 1：创建 npm 全局目录
mkdir -p ~/.npm-global
步骤 2：配置 npm 使用这个目录
npm config set prefix '~/.npm-global'
步骤 3：将目录添加到 PATH
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
第三步：安装 Claude Code
3.1 执行安装命令
npm install -g @anthropic-ai/claude-code
安装过程会显示：
added 3 packages in 28s
3.2 验证安装成功
claude --version
应该显示版本号，例如：
2.1.17 (Claude Code)
如果看到版本号，说明安装成功。
第四步：获取智谱 API Key
4.1 访问智谱开放平台
打开浏览器访问：https://open.bigmodel.cn
4.2 注册/登录账号
4.3 创建 API Key
- 进入 API Keys 管理页面：https://bigmodel.cn/usercenter/proj-mgmt/apikeys
- 点击'创建新的 API Key'
- 复制并保存 API Key（只显示一次，务必妥善保管）
第五步：配置 Claude Code
方法 A：使用自动化脚本（推荐）
执行自动配置脚本：
curl -O "https://cdn.bigmodel.cn/install/claude_code_env.sh" && bash ./claude_code_env.sh
脚本会提示你输入 API Key：
🔑 Please enter your ZHIPU API key:
输入你的 API Key 并回车（注意：输入时不会显示任何字符，这是正常的安全设计）。
看到以下信息说明配置成功：
✅ Claude Code configured successfully ✅ 🎉 Installation completed successfully!
方法 B：手动配置（备选方案）
如果自动脚本失败，可以手动配置：
步骤 1：创建配置目录
mkdir -p ~/.claude
步骤 2：创建 settings.json 文件
nano ~/.claude/settings.json
步骤 3：粘贴以下内容（替换 your_zhipu_api_key）
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "your_zhipu_api_key",
"ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
"API_TIMEOUT_MS": "3000000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
}
}
保存：Ctrl + O → Enter → Ctrl + X 退出。
步骤 4：创建 .claude.json 文件
nano ~/.claude.json
步骤 5：粘贴以下内容
{
"hasCompletedOnboarding": true
}
保存并退出。
第六步：验证配置
6.1 检查配置文件
cat ~/.claude/settings.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
}
}
如果能看到你的 API Key，说明配置成功。
第七步：启动并使用 Claude Code
7.1 进入项目目录
# 进入已有项目
cd /path/to/your/project
# 或创建测试目录
mkdir -p ~/my-project
cd ~/my-project
7.2 启动 Claude Code
claude
7.3 首次启动提示
- "Do you want to use this API key?" → 选择
Yes - "Do you trust the authors of the files in this folder?" → 选择
信任或Trust
7.4 测试功能
启动成功后，输入测试命令：
测试 1：查看状态
/status
测试 2：简单对话
你好，请介绍一下你自己
测试 3：代码生成
帮我写一个 Python 的快速排序函数
常用命令参考
| 命令 | 功能 |
|---|---|
claude | 启动 Claude Code |
/status | 查看连接状态和模型信息 |
/help | 查看帮助信息 |
/clear | 清除对话历史 |
/exit 或 Ctrl+C | 退出 Claude Code |
常见问题排查
Q1: 安装时提示权限错误
解决：按照'第二步'配置 npm 使用用户目录，不要使用 sudo。
Q2: 启动时提示 API 错误
解决：
- 检查 API Key 是否正确：
cat ~/.claude/settings.json - 确认 API Key 在智谱平台是否有效
- 检查网络连接
Q3: 配置文件修改后不生效
解决：
# 完全退出 Claude Code
# 重新打开新的终端窗口
claude
完整流程总结
- 安装 Node.js (v18+)
- 配置 npm 用户目录权限
- 安装 Claude Code (npm install -g)
- 获取智谱 API Key
- 运行配置脚本 (claude_code_env.sh)
- 验证配置文件
- 启动并测试 (claude)
现在你可以
- 使用 Claude Code 进行代码开发
- 调用智谱 GLM-4.7 模型
- 在终端中进行 AI 辅助编程
