Ollama Claude Code

2026-10-29 18:54 更新

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 就说明接上了。

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号