1. Mac 配置 Claude Code 远程 Ollama 完全指南最近在折腾 Mac 上配置 Claude Code 并连接远程 Ollama 服务踩了不少坑也积累了一些经验。Claude Code 作为一款智能编码工具配合 Ollama 提供的本地和云端模型支持可以显著提升开发效率。下面就把我的完整配置过程记录下来包括环境准备、安装配置、远程连接和常见问题解决。1.1 环境准备与前置条件在开始之前确保你的 Mac 满足以下条件macOS 10.15 或更高版本已安装 HomebrewMac 包管理工具终端可正常执行命令能够访问 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 或 ~/.bashrcexport ANTHROPIC_AUTH_TOKENollama export ANTHROPIC_API_KEY export ANTHROPIC_BASE_URLhttp://localhost:11434然后使配置生效source ~/.zshrc验证安装是否成功claude --version如果遇到未打开codex因其包含恶意软件的警告这是 macOS 的 Gatekeeper 安全机制导致的。可以通过以下方式解决前往系统设置 隐私与安全性在安全性部分找到相关提示点击仍要打开按钮1.3 Ollama 服务部署与配置Ollama 可以部署在本地或远程服务器上。如果你的 Mac 性能足够本地部署是最简单的选择下载并安装 Ollamacurl -fsSL https://ollama.ai/install.sh | sh启动 Ollama 服务ollama serve在另一个终端窗口拉取需要的模型以 gemma4 为例ollama pull gemma4如果下载速度慢可以尝试更换国内镜像源export OLLAMA_HOSTmirror.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 userremote-server测试无密码登录ssh userremote-server2.2 创建 SSH 隧道建立 SSH 隧道将远程 Ollama 服务端口映射到本地ssh -N -L 11434:localhost:11434 userremote-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 # 按 CtrlB 然后按 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 11434API Error: 400 This models maximum context length...减小上下文长度--context-length 32000或者选择支持更大上下文的模型SSH 连接问题如果遇到hostkeyalgorithms ssh-dss错误编辑 ~/.ssh/configHost * HostkeyAlgorithms ssh-ed25519-cert-v01openssh.com,ssh-rsa-cert-v01openssh.com,ssh-ed25519,ssh-rsa4.2 性能优化Ollama 下载慢使用国内镜像源或者先下载模型文件再手动导入curl -O https://ollama.ai/models/gemma4 ollama create gemma4 -f gemma4内存不足选择较小的模型增加交换空间sudo sysctl vm.swappiness104.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 扩展配置设置指向本地 OllamaTelegram 通知创建 Telegram bot配置 Claude Code 插件ollama launch claude -- --channels plugin:telegramclaude-plugins-official5.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 # 查看实时日志
