1. Mac 配置 Claude Code + 远程 Ollama 完全指南
最近在折腾 Mac 上配置 Claude Code 并连接远程 Ollama 服务，踩了不少坑也积累了一些经验。Claude Code 作为一款智能编码工具，配合 Ollama 提供的本地和云端模型支持，可以显著提升开发效率。下面就把我的完整配置过程记录下来，包括环境准备、安装配置、远程连接和常见问题解决。
1.1 环境准备与前置条件
在开始之前，确保你的 Mac 满足以下条件：
- macOS 10.15 或更高版本
- 已安装 Homebrew（Mac 包管理工具）
- 终端可正常执行命令
- 能够访问 Ollama 服务（本地或远程）
首先更新 Homebrew 并安装必要的依赖：
brew update && brew upgrade brew install git python3 curl wget如果你的 Mac 是 Intel 芯片，还需要额外安装 Rosetta 2 以兼容部分工具：
softwareupdate --install-rosetta注意：建议在执行任何安装脚本前先检查脚本内容，可以通过 curl 先下载脚本查看后再执行。
1.2 Claude Code 安装与配置
Claude Code 的官方安装方式很简单，但有几个关键点需要注意：
- 通过官方脚本安装：
curl -fsSL https://claude.ai/install.sh | bash安装完成后，需要设置环境变量才能让 Claude Code 连接到 Ollama。编辑你的 shell 配置文件（~/.zshrc 或 ~/.bashrc）：
export ANTHROPIC_AUTH_TOKEN=ollama export ANTHROPIC_API_KEY="" export ANTHROPIC_BASE_URL=http://localhost:11434然后使配置生效：
source ~/.zshrc验证安装是否成功：
claude --version如果遇到"未打开'codex'，因其包含恶意软件"的警告，这是 macOS 的 Gatekeeper 安全机制导致的。可以通过以下方式解决：
- 前往系统设置 > 隐私与安全性
- 在"安全性"部分找到相关提示
- 点击"仍要打开"按钮
1.3 Ollama 服务部署与配置
Ollama 可以部署在本地或远程服务器上。如果你的 Mac 性能足够，本地部署是最简单的选择：
- 下载并安装 Ollama：
curl -fsSL https://ollama.ai/install.sh | sh- 启动 Ollama 服务：
ollama serve- 在另一个终端窗口拉取需要的模型（以 gemma4 为例）：
ollama pull gemma4如果下载速度慢，可以尝试更换国内镜像源：
export OLLAMA_HOST=mirror.ollama.ai ollama pull gemma4对于远程部署的情况，你需要在服务器上安装 Ollama 并确保 11434 端口可访问。可以使用以下命令检查连接：
curl http://<远程服务器IP>:11434/api/tags2. 远程连接配置与 SSH 隧道
2.1 基础 SSH 连接配置
要让 Claude Code 连接到远程 Ollama 服务，最安全的方式是通过 SSH 隧道。首先确保本地和远程服务器之间配置了 SSH 密钥认证：
- 在本地生成 SSH 密钥对（如果还没有）：
ssh-keygen -t ed25519- 将公钥复制到远程服务器：
ssh-copy-id user@remote-server- 测试无密码登录：
ssh user@remote-server2.2 创建 SSH 隧道
建立 SSH 隧道将远程 Ollama 服务端口映射到本地：
ssh -N -L 11434:localhost:11434 user@remote-server这条命令会在后台运行，将远程服务器的 11434 端口映射到本地的 11434 端口。你可以通过以下命令验证隧道是否正常工作：
curl http://localhost:11434/api/tags如果返回模型列表，说明隧道配置成功。
2.3 持久化 SSH 连接
为了防止 SSH 连接意外断开，可以配置 SSH 保持连接：
编辑 ~/.ssh/config 文件（如果没有则创建）：
Host ollama-tunnel HostName remote-server User user LocalForward 11434 localhost:11434 ServerAliveInterval 60 ServerAliveCountMax 5然后可以通过简化命令建立隧道：
ssh -N ollama-tunnel对于更稳定的连接，可以考虑使用 tmux 或 screen 来维持会话：
brew install tmux tmux new -s ollama-tunnel ssh -N ollama-tunnel # 按 Ctrl+B 然后按 D 分离会话3. Claude Code 高级配置与使用技巧
3.1 模型选择与上下文配置
Claude Code 支持多种模型，根据你的需求选择合适的模型很重要：
- 查看可用模型：
ollama list- 运行 Claude Code 并指定模型：
claude --model gemma4:cloud对于大型代码库，建议增加上下文长度：
claude --model gemma4:cloud --context-length 640003.2 常用命令与工作流
Claude Code 提供多种交互方式：
- 直接提问关于代码库的问题：
claude -p "解释这个仓库的结构"- 让 Claude Code 执行命令（需要确认）：
claude -c "运行测试套件"- 非交互式模式（适合脚本）：
claude --yes -- -p "检查代码风格问题"3.3 文件编辑与版本控制集成
Claude Code 可以直接编辑文件，但建议先设置 Git 以防意外更改：
- 初始化 Git 仓库（如果还没有）：
git init- 让 Claude Code 进行更改前创建分支：
claude -c "创建一个新分支来重构这段代码"- 查看更改：
git diff4. 常见问题与解决方案
4.1 连接与 API 错误
"API Error: Connection refused"：
- 检查 Ollama 服务是否运行：
ps aux | grep ollama - 验证端口是否正确：
netstat -an | grep 11434 - 确保防火墙允许该端口：
sudo ufw allow 11434
- 检查 Ollama 服务是否运行：
"API Error: 400 This model's maximum context length..."：
- 减小上下文长度：
--context-length 32000 - 或者选择支持更大上下文的模型
- 减小上下文长度：
SSH 连接问题：
- 如果遇到"hostkeyalgorithms +ssh-dss"错误，编辑 ~/.ssh/config：
Host * HostkeyAlgorithms ssh-ed25519-cert-v01@openssh.com,ssh-rsa-cert-v01@openssh.com,ssh-ed25519,ssh-rsa
- 如果遇到"hostkeyalgorithms +ssh-dss"错误，编辑 ~/.ssh/config：
4.2 性能优化
Ollama 下载慢：
- 使用国内镜像源
- 或者先下载模型文件再手动导入：
curl -O https://ollama.ai/models/gemma4 ollama create gemma4 -f gemma4
内存不足：
- 选择较小的模型
- 增加交换空间：
sudo sysctl vm.swappiness=10
4.3 卸载与清理
如果需要卸载 Claude Code：
- 删除主程序：
rm -rf /usr/local/bin/claude- 清理配置文件：
rm -rf ~/.config/claude- 从 shell 配置中移除环境变量
对于 Ollama：
- 停止服务：
ollama stop- 卸载：
rm -rf ~/.ollama /usr/local/bin/ollama5. 进阶技巧与自动化
5.1 定时任务与监控
利用 /loop 命令设置定时检查：
/loop 30m "检查构建状态并报告失败"结合 cron 实现更复杂的调度：
0 * * * * /usr/local/bin/claude --yes -- -p "每小时代码审查"5.2 插件与集成
VS Code 集成：
- 安装 Claude Code 扩展
- 配置设置指向本地 Ollama
Telegram 通知：
- 创建 Telegram bot
- 配置 Claude Code 插件：
ollama launch claude -- --channels plugin:telegram@claude-plugins-official
5.3 自定义模型与微调
对于高级用户，可以：
- 创建自定义模型：
ollama create my-model -f Modelfile- 微调现有模型：
ollama fine-tune gemma4 --data my-dataset.json- 部署私有模型：
ollama serve --model my-model --port 11435在实际使用中，我发现保持 Ollama 服务稳定运行是关键。可以通过以下命令监控服务状态：
brew services start ollama # 使用 Homebrew 管理服务 tail -f ~/.ollama/logs/server.log # 查看实时日志
