Ubuntu 安装 Claude Code 并配置智谱 GLM-4.7

打开浏览器访问：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 的快速排序函数

常用命令参考

常见问题排查

Q1: 安装时提示权限错误

解决：按照'第二步'配置 npm 使用用户目录，不要使用 sudo。

Q2: 启动时提示 API 错误

解决：

1. 检查 API Key 是否正确：cat ~/.claude/settings.json
2. 确认 API Key 在智谱平台是否有效
3. 检查网络连接

Q3: 配置文件修改后不生效

解决：

# 完全退出 Claude Code
# 重新打开新的终端窗口
claude

完整流程总结

1. 安装 Node.js (v18+)
2. 配置 npm 用户目录权限
3. 安装 Claude Code (npm install -g)
4. 获取智谱 API Key
5. 运行配置脚本 (claude_code_env.sh)
6. 验证配置文件
7. 启动并测试 (claude)

现在你可以

• 使用 Claude Code 进行代码开发
• 调用智谱 GLM-4.7 模型
• 在终端中进行 AI 辅助编程