claude-ollama

Claude Ollama Docker 镜像

sbx/claude-ollama是适配Sandbox Kit的工具镜像,可将Claude Code的API请求路由到本地Ollama实例,支持自定义本地模型,满足离线开发、免成本大模型调试需求。

下载次数: 0状态:社区镜像维护者:sbx仓库类型:镜像最近更新:
下载命令
点击查看

镜像概述

sbx/claude-ollama是基于Docker Sandbox Kit v3实验性规范开发的适配工具镜像,作为官方内置claude代理的分支实现,它将Claude Code的所有API请求转发至本地运行的Ollama实例,替代默认的Anthropic官方接口,适用于离线开发场景、零成本大模型实验以及自定义本地模型的功能测试。

注意:使用该镜像前需提前在主机的默认端口(localhost:***)启动Ollama服务;Linux环境下需为Docker添加启动参数--add-host=host.docker.internal:host-gateway,若连接Ollama失败可改用主机局域网/网桥IP替换host.docker.internal地址。

核心功能

  1. 请求路由转换:将Claude Code的默认Anthropic API请求全部转发至本地Ollama服务地址http://host.docker.internal:11434
  2. 凭证自动适配:自动生成虚拟鉴权令牌,适配Ollama无需真实认证凭证的运行逻辑
  3. 模型别名映射:可将所有Claude系列模型别名(Opus、Sonnet、Haiku等子代理标识)统一映射到用户指定的本地Ollama模型
  4. 网络权限收缩:仅允许容器访问主机***端口,完全阻断对Anthropic官方API域名的访问,避免非必要外部网络请求

使用场景

  1. 无公网环境下的本地大模型开发调试
  2. 零成本调用私有本地大模型完成代码辅助工作流
  3. 基于自定义微调大模型验证Claude Code工作流的兼容性
  4. 大模型应用离线私有化部署的前期适配测试

配置说明

默认调用的本地Ollama模型为gemma4:e4b-it-q4_K_M,可通过修改环境变量CLAUDE_OLLAMA_MODEL指定其他已在Ollama中拉取的本地模型,也可修改镜像Dockerfile内的ENV配置修改默认值。 若需要在自有基础镜像上叠加该适配逻辑,可使用同仓库提供的claude-ollama-mixin分层扩展包。

部署示例

1. 直接运行镜像

console
sbx run "docker.io/sbx/claude-ollama:latest" ~/my-project

2. 从代码仓库直接运行

console
sbx run "git+https://github.com/docker/sbx-kits-contrib.git#dir=claude-ollama" ~/my-project

3. 从本地克隆的代码目录运行

console
sbx run ./claude-ollama/ ~/my-project

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 claude-ollama 镜像标签

docker pull docker.xuanyuan.run/sbx/claude-ollama:<标签>

DockerHub 原生拉取命令

docker pull sbx/claude-ollama:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告