第一步:准备工作 - 检查 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 -
apt-get install -y nodejs
本文介绍了在 Ubuntu 系统下安装 Node.js、配置 npm 权限、安装 Claude Code 命令行工具的完整流程。通过获取智谱开放平台 API Key,利用自动化脚本或手动编辑配置文件的方式完成环境设置。最后提供了常用命令参考及常见问题排查指南,帮助用户在终端中高效调用 GLM-4.7 模型进行 AI 辅助编程。
node --version
要求:Node.js 18 或更高版本。
注意:这一步时间较长,因为需要下载最新版本。
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
apt-get install -y nodejs
直接运行 npm install -g 会遇到权限错误:
npm error code EACCES
npm error Error: EACCES: permission denied
原因:npm 默认将全局包安装到系统目录(/usr/lib/node_modules/),需要 root 权限。
步骤 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
npm install -g @anthropic-ai/claude-code
安装过程会显示:
added 3 packages in 28s
claude --version
应该显示版本号,例如:
2.1.17 (Claude Code)
如果看到版本号,说明安装成功。
打开浏览器访问:https://open.bigmodel.cn
执行自动配置脚本:
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!
如果自动脚本失败,可以手动配置:
步骤 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
}
保存并退出。
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,说明配置成功。
# 进入已有项目
cd /path/to/your/project
# 或创建测试目录
mkdir -p ~/my-project
cd ~/my-project
claude
Yes信任 或 Trust启动成功后,输入测试命令:
测试 1:查看状态
/status
测试 2:简单对话
你好,请介绍一下你自己
测试 3:代码生成
帮我写一个 Python 的快速排序函数
| 命令 | 功能 |
|---|---|
claude | 启动 Claude Code |
/status | 查看连接状态和模型信息 |
/help | 查看帮助信息 |
/clear | 清除对话历史 |
/exit 或 Ctrl+C | 退出 Claude Code |
解决:按照'第二步'配置 npm 使用用户目录,不要使用 sudo。
解决:
cat ~/.claude/settings.json解决:
# 完全退出 Claude Code
# 重新打开新的终端窗口
claude

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML 转 Markdown在线工具,online