1. 项目概述
在Mac上本地部署Claude Code并配置国内大模型(GLM)是一个让开发者能够直接在终端使用AI辅助编程的实用方案。相比云端服务,本地部署提供了更快的响应速度、更好的隐私保护以及更灵活的自定义选项。本文将详细介绍从Java环境配置到Claude Code安装,再到GLM模型集成的完整流程。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备
2.1 Java环境配置
Java是Claude Code运行的基础依赖,我们选择OpenJDK 17作为Java运行时环境,主要基于以下考虑:
- OpenJDK是免费开源的Java实现,没有商业授权问题
- JDK 17是当前的长期支持(LTS)版本,稳定性和兼容性最佳
- Homebrew提供的OpenJDK@17包维护良好,更新及时
安装步骤详解:
- 通过Homebrew安装OpenJDK 17:
bash复制brew install openjdk@17
- 创建系统符号链接(解决常见的"找不到Java Runtime"问题):
bash复制sudo ln -sfn /opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-17.jdk
这个步骤特别重要,因为MacOS的Java运行时查找机制需要这个链接才能正确识别通过Homebrew安装的JDK。
- 验证安装:
bash复制java -version
正常应该看到类似"openjdk version "17.0.x"的输出。
- 配置环境变量(永久生效):
bash复制echo 'export PATH="/opt/homebrew/opt/openjdk@17/bin:$PATH"' >> ~/.zshrc
echo 'export JAVA_HOME="/opt/homebrew/opt/openjdk@17"' >> ~/.zshrc
source ~/.zshrc
注意:如果你使用的是bash而不是zsh,请将.zshrc替换为.bash_profile或.bashrc
2.2 Node.js环境准备
Claude Code也可以通过npm安装,因此需要Node.js环境:
- 安装Homebrew(如果尚未安装):
bash复制/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
- 通过Homebrew安装Node.js(包含npm):
bash复制brew install node
- 验证安装:
bash复制node -v
npm -v
3. Claude Code安装
3.1 官方脚本安装(推荐)
最简单的方式是使用官方提供的安装脚本:
bash复制curl -fsSL https://claude.ai/install.sh | bash
这个脚本会自动完成以下工作:
- 检测系统环境
- 下载最新版Claude Code
- 配置必要的环境变量
- 创建命令行快捷方式
3.2 通过npm安装(备选方案)
如果官方脚本安装遇到问题,可以使用npm安装:
bash复制npm install -g @anthropic-ai/claude-code
安装完成后,可以运行以下命令验证:
bash复制claude --version
4. GLM模型配置
4.1 获取智谱API Key
在使用国内GLM模型前,需要:
- 访问智谱开放平台(https://open.bigmodel.cn)
- 注册/登录账号
- 在控制台创建应用并获取API Key
4.2 配置环境变量
编辑zsh配置文件:
bash复制open ~/.zshrc
添加以下配置(替换YOUR_API_KEY为实际的API Key):
bash复制# ==================== Claude Code 智谱配置 ====================
export ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
# 默认模型:glm-4.7-flash(速度快、代码强)
export ANTHROPIC_MODEL="glm-4.7-flash"
# 切换命令:glm-flash → 快速模型;glm-4v → 看图模型
alias glm-flash='export ANTHROPIC_MODEL=glm-4.7-flash; echo "已切换模型:glm-4.7-flash"'
alias glm-4v='export ANTHROPIC_MODEL=glm-4.6v; echo "已切换模型:glm-4.6v(支持识图)"'
# 跳过版本检查避免报错
export CLAUDE_SKIP_VERSION_CHECK=true
# ==================== 配置结束 ====================
使配置生效:
bash复制source ~/.zshrc
4.3 模型选择说明
GLM提供了两个主要模型版本:
- glm-4.7-flash:优化了响应速度,特别适合代码生成和文本处理
- glm-4.6v:支持多模态(包括图像识别),但速度稍慢
可以根据使用场景通过以下命令切换:
bash复制glm-flash # 切换到快速模型
glm-4v # 切换到多模态模型
5. 使用指南
5.1 基本操作
启动Claude交互界面:
bash复制claude
常用命令:
/exit或/quit:退出ClaudeCtrl + C:强制中断当前操作/c或/clear:清空当前对话历史/new:开启新对话/undo:撤销上一轮对话
5.2 文件操作
Claude Code强大的文件操作能力是其特色功能:
- 让AI读取文件内容:
code复制请帮我看一下index.js
- 让AI编辑文件:
code复制帮我修改app.py优化代码
- 项目分析:
code复制帮我分析这个项目结构
5.3 个性化设置
- 终端主题设置:
code复制/terminal-setup
- 切换深色/浅色模式:
code复制/theme
6. 常见问题解决
6.1 Java环境问题
问题:运行claude命令时报"找不到Java运行时"
解决方案:
- 确认OpenJDK 17已正确安装
- 检查符号链接是否存在:
bash复制ls -l /Library/Java/JavaVirtualMachines/
- 验证JAVA_HOME环境变量:
bash复制echo $JAVA_HOME
6.2 API连接问题
问题:无法连接到智谱API
排查步骤:
- 检查API Key是否正确
- 验证网络连接是否正常
- 尝试直接访问API端点:
bash复制curl -X GET "https://open.bigmodel.cn/api/anthropic/v1/models" \
-H "Authorization: Bearer YOUR_API_KEY"
6.3 模型切换不生效
问题:切换模型后行为没有变化
解决方案:
- 确认当前使用的模型:
bash复制echo $ANTHROPIC_MODEL
- 确保已执行source ~/.zshrc使配置生效
- 检查alias定义是否正确
7. 高级配置与优化
7.1 性能调优
对于开发人员,可以调整JVM参数提升性能:
bash复制export JAVA_OPTS="-Xms1g -Xmx2g"
7.2 自定义提示词
在~/.claude/config.json中添加自定义提示词模板:
json复制{
"prompts": {
"code_review": "请以专业开发者的角度严格审查以下代码...",
"bug_fix": "请分析以下错误并给出修复建议..."
}
}
使用时可以直接调用:
code复制/code_review
7.3 历史记录管理
Claude默认会保存对话历史,位置在:
~/.claude/history/
可以定期清理或备份这些文件以释放空间。
