Claude Code 官方安装指南（智谱AI配置）

Claude Code 官方安装指南（智谱AI配置）

概述

本文档介绍如何安装官方Claude Code CLI工具，并配置为使用智谱AI的GLM模型API。

前置要求

• Node.js 18+ (建议使用nvm管理)
• 智谱AI API Key

安装步骤

1. 获取智谱AI API Key

访问 智谱AI开放平台 注册并获取API Key。

2. 安装Claude Code

重要：需要从官方npm源安装平台包，避免使用中国镜像。

# 安装主包npminstall-g@anthropic-ai/claude-code# 从官方源安装Linux平台包（关键步骤）npminstall-g@anthropic-ai/claude-code-linux-x64@latest--registry=https://registry.npmjs.org/# 运行postinstall脚本链接二进制文件cd~/.nvm/versions/node/v$(node-v)/lib/node_modules/@anthropic-ai/claude-codenodeinstall.cjs

3. 配置环境变量

在~/.bashrc或~/.zshrc中添加：

# 智谱AI API配置（Claude兼容接口）exportANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic"exportANTHROPIC_AUTH_TOKEN="你的智谱AI_API_KEY"exportANTHROPIC_MODEL="glm-5"

重新加载配置：

source~/.bashrc

4. 验证安装

# 检查版本claude--version# 测试API调用claude"你好，请简短介绍你自己"

使用方法

交互模式

claude

进入交互模式后，您会看到官方界面：

╔════════════════════════════════════════════════════════════╗ ║ Welcome back! ║ ║ ║ ║ ▐▛███▜▌ ║ ║ ▝▜█████▛▘ ║ ║ ▘▘ ▝▝ ║ ║ ║ ║ glm-5 · API Usage Billing ║ ║ /your/current/directory ║ ╚════════════════════════════════════════════════════════════╝

单次模式

claude"你的问题或任务"

常用命令

• /help- 显示帮助
• /model- 切换模型
• /clear- 清空对话历史
• /quit或exit- 退出

支持的智谱AI模型

• glm-5- 最新版本
• glm-4.6- 稳定版本
• glm-4-flash- 快速响应版本

配置文件

全局配置

~/.claude/settings.json

{"model":"glm-5"}

项目配置

.claude/settings.json(项目根目录)

故障排查

问题：claude native binary not installed

解决方案：从官方npm源安装平台包

npminstall-g@anthropic-ai/claude-code-linux-x64@latest--registry=https://registry.npmjs.org/cd~/.nvm/versions/node/v$(node-v)/lib/node_modules/@anthropic-ai/claude-codenodeinstall.cjs

问题：API调用失败

检查：

1. 确认ANTHROPIC_AUTH_TOKEN已正确设置
2. 确认ANTHROPIC_BASE_URL指向https://open.bigmodel.cn/api/anthropic
3. 验证API Key有效性

问题：中国镜像导致二进制文件缺失

原因：npmmirror等中国镜像不包含原生二进制文件

解决方案：始终从官方npm源安装平台包

--registry=https://registry.npmjs.org/

更多信息

• Claude Code官方文档
• 智谱AI Claude API兼容文档
• 智谱AI开放平台