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地址。
核心功能
- 请求路由转换:将Claude Code的默认Anthropic API请求全部转发至本地Ollama服务地址
http://host.docker.internal:11434 - 凭证自动适配:自动生成虚拟鉴权令牌,适配Ollama无需真实认证凭证的运行逻辑
- 模型别名映射:可将所有Claude系列模型别名(Opus、Sonnet、Haiku等子代理标识)统一映射到用户指定的本地Ollama模型
- 网络权限收缩:仅允许容器访问主机***端口,完全阻断对Anthropic官方API域名的访问,避免非必要外部网络请求
使用场景
- 无公网环境下的本地大模型开发调试
- 零成本调用私有本地大模型完成代码辅助工作流
- 基于自定义微调大模型验证Claude Code工作流的兼容性
- 大模型应用离线私有化部署的前期适配测试
配置说明
默认调用的本地Ollama模型为gemma4:e4b-it-q4_K_M,可通过修改环境变量CLAUDE_OLLAMA_MODEL指定其他已在Ollama中拉取的本地模型,也可修改镜像Dockerfile内的ENV配置修改默认值。
若需要在自有基础镜像上叠加该适配逻辑,可使用同仓库提供的claude-ollama-mixin分层扩展包。
部署示例
1. 直接运行镜像
consolesbx run "docker.io/sbx/claude-ollama:latest" ~/my-project
2. 从代码仓库直接运行
consolesbx run "git+https://github.com/docker/sbx-kits-contrib.git#dir=claude-ollama" ~/my-project
3. 从本地克隆的代码目录运行
consolesbx run ./claude-ollama/ ~/my-project
sbx 命名空间的其他可用镜像:
sbx/opencode
Opencode 容器镜像,适合 sbx 维护的 Opencode 工作负载部署
sbx/hermes-agent-image
Hermes Agent Image 容器镜像,适合 sbx 维护的 Hermes Agent Image 工作负载部署
sbx/pi-image
Pi Image 容器镜像,适合 sbx 维护的 Pi Image 工作负载部署
sbx/shell
Shell 容器镜像,适合 sbx 维护的 Shell 工作负载部署
sbx/claude
Claude 容器镜像,适合 sbx 维护的 Claude 工作负载部署
sbx/playwright
Playwright 容器镜像,适合 sbx 维护的 Playwright 工作负载部署
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 claude-ollama 镜像标签
docker pull docker.xuanyuan.run/sbx/claude-ollama:<标签>
DockerHub 原生拉取命令
docker pull sbx/claude-ollama:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务