开源 AI 编码代理 OpenCode 本地部署指南

不同于在特定容器中安装,本次直接使用官方原生的 Docker 镜像进行部署。
简介
什么是 OpenCode?
OpenCode 是一个开源的 AI 编码代理(AI Coding Agent),通过大语言模型(LLM)自动化编程任务,从任务理解、代码生成到执行测试和自我修正,形成闭环。它支持终端、桌面应用和 IDE 集成,让开发者用自然语言描述需求,代理就能独立完成编码工作。
主要特点
- 完全开源:采用 MIT 许可证,您可以自由使用、修改和分发。
- 模型无锁定:灵活配置并使用任何您喜欢的 AI 模型,无论是云端 API 还是本地模型。
- 多种代理模式:
- build 代理:拥有完全的系统访问权限,专为编码、调试和测试等开发工作设计。
- plan 代理:只读模式,用于安全地分析和探索代码库,执行敏感操作前会请求许可。
- 多样的使用方式:支持交互式命令行(CLI)、Web 浏览器界面,甚至还有跨平台的桌面应用。
- 客户端/服务器架构:允许您将核心服务部署在远程服务器上,然后在本地通过客户端连接进行远程开发。
应用场景
- 日常软件开发:使用 build 代理进行编码、调试、编写测试。
- 学习新项目:使用 plan 代理安全地分析和理解一个陌生的代码库。
- 项目规划与重构:在进行大型重构前,进行分析和计划制定。
- 远程开发:将 OpenCode 服务部署在云服务器上,随时随地在本地进行高效编程。

OpenCode 不受任何特定 AI 模型供应商的限制,允许您自由选择使用 Claude、OpenAI、Google 或是本地部署的 AI 模型。注重终端体验,但同样提供了 Web 界面和桌面应用,以满足不同开发者的使用偏好。
安装
OpenCode 提供了多种灵活的部署方式,以下重点介绍通过 Docker 安装与运行的两种模式。
写作时,latest 版本对应为 1.2.15;

1. 命令行 (CLI) 交互模式
这种方式非常适合快速、一次性的交互任务。它会在您退出后自动清理容器,不留下任何残留。
打开您的终端,执行以下命令:
docker run -it -- ghcr.io/anomalyco/opencode:latest







