Ollama Claude Code
Claude Code 能读你的代码库、改文件、执行命令。Ollama 通过Anthropic 兼容 API 把它接到本地或云端模型上——这是本章最值得先跑通的一个集成,因为它的配置方式(三个环境变量)是很多 Anthropic 协议工具的通用范式。
版本基线 v0.40.12,官方
docs.ollama.com/integrations/claude-code。
一、最快路径
ollama launch claude
一条命令完成「安装 + 配置 + 启动」。
二、手动配置:三个环境变量
想自己控制、或已经装好 Claude Code 的,配这三个变量即可:
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_API_KEY=""
export ANTHROPIC_BASE_URL=http://localhost:11434
然后运行:
claude --model qwen3.5
也可以写成一行:
ANTHROPIC_AUTH_TOKEN=ollama ANTHROPIC_BASE_URL=http://localhost:11434 ANTHROPIC_API_KEY="" claude --model kimi-k2.7-code:cloud
三个变量各有讲究:
| 变量 | 值 | 为什么 |
|---|---|---|
ANTHROPIC_BASE_URL |
http://localhost:11434 |
不带 /v1,Claude Code 自己拼路径 |
ANTHROPIC_AUTH_TOKEN |
ollama(占位) |
本地无鉴权,但必须非空 |
ANTHROPIC_API_KEY |
空字符串 | 显式置空,避免读到旧 key 冲突 |
三、直连 Ollama 云端(不装 Ollama)
只想用云端模型、本地不想装 Ollama 的情况:
ANTHROPIC_BASE_URL=https://ollama.com \
ANTHROPIC_AUTH_TOKEN="$OLLAMA_API_KEY" \
ANTHROPIC_API_KEY="" \
claude --model glm-5.3-flash
这里的 OLLAMA_API_KEY 从 ollama.com/settings/keys 生成。注意云端的 ANTHROPIC_BASE_URL 是 https://ollama.com,同样不带 /v1。
Claude 的设置文件可能覆盖 shell 变量。如果配置看起来没生效,检查 Claude 的 settings 里是否写死了 base URL 或凭据,改完后用
/status确认连接。
四、接入后支持的能力
| 能力 | 说明 |
|---|---|
| 对话 | 针对仓库或任务提问 |
| 命令行 | 按 Claude Code 的权限流执行命令 |
| 工具调用 | 需模型支持 tools |
| 文件编辑 | 读写项目文件 |
| 子代理 | 拆分任务 |
| 联网搜索 | 走 Ollama 的搜索服务 |
| 网页抓取 | 抓取并总结网页 |
| 视觉 | 传图片和截图 |
| 思考 | 兼容模型可用 thinking |
五、模型与上下文
Claude Code 对上下文要求高,大仓库建议 64k 以上:
## 服务端默认上下文
OLLAMA_CONTEXT_LENGTH=65536 ollama serve
模型要选支持 tools 的,否则文件编辑和命令执行会失效。云端可用 kimi-k2.7-code:cloud 这类编码专用模型。
六、无交互模式(脚本 / CI)
ollama launch claude --model gemma4:cloud --yes -- -p "how does this repository work?"
--yes:跳过选择器、自动拉模型,必须配合--model--之后的参数原样传给 Claude Code
七、定时任务 /loop
Claude Code 内置 /loop,可以把提示词或斜杠命令按周期执行:
/loop <interval> <prompt or /command>
实用例子:
/loop 30m Check my open PRs and summarize their status
/loop 1h Research the latest AI news and summarize key developments
/loop 15m Check for new GitHub issues and triage by priority
这个能力配上本地模型挺有性价比——定时轮询任务本来不需要最强模型,用本地跑几乎零成本。
八、接 Telegram
ollama launch claude -- --channels plugin:telegram@claude-plugins-official
需要先在 BotFather 创建 bot 并装 Telegram 插件。
Claude Code 对多数操作会请求确认。要让 bot 自主工作,需配置权限规则,或在隔离环境里用
--dangerously-skip-permissions。后者风险很高,只在一次性容器里用。
常见问题
| 现象 | 原因 | 处理 |
|---|---|---|
| 连接被拒 | ANTHROPIC_BASE_URL 多写了 /v1 |
去掉 /v1 |
| 401 / 鉴权失败 | ANTHROPIC_API_KEY 没置空 |
显式设成 "" |
| 一直提示无可用模型 | 模型不支持 tools | 换支持工具调用的模型 |
| 回答被截断 | 上下文太小 | 调到 64k 以上 |
| 配置不生效 | Claude settings 覆盖了环境变量 | 检查 settings,/status 复核 |
动手试
## ① 确认 Anthropic 兼容端点通
curl http://localhost:11434/api/version
## ② 三个变量 + 启动
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_API_KEY=""
export ANTHROPIC_BASE_URL=http://localhost:11434
claude --model qwen3.5
进去后打 /status,能看到 base URL 指向 localhost 就说明接上了。

TRAE-AI编程


更多建议: