开源的AI编码代理OpenCode

发表于 分类于 Waline： 阅读次数： 本文字数： 2.6k 阅读时长 ≈ 2 分钟
OpenCode 是一个开源、灵活、不受供应商限制的 AI 编码代理，能成为开发者的智能编程助手，支持 CLI 、 Web 和桌面等多种使用方式。

和之前 在Instantbox中安装OpenCode 在别的容器中安装 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) 交互模式

这种方式非常适合快速、一次性的交互任务。它会在您退出后自动清理容器，不留下任何残留。

打开您的终端，执行以下命令：

1
docker run -it --rm ghcr.io/anomalyco/opencode:latest

命令说明：

  • -it: 启动交互模式，允许您与容器内的 OpenCode 进程进行实时对话。

  • --rm: 容器停止后自动删除，保持系统整洁。

  • ghcr.io/anomalyco/opencode: OpenCode 的官方 Docker 镜像。

  • 对于 CLI 模式，执行命令后直接在终端中即可开始与 OpenCode 交互

2. 网页 (Web) 服务模式

这种方式会将 OpenCode 作为一个后台服务长期运行，并提供一个 Web 界面供您随时访问。非常适合部署在个人服务器或群晖 NAS 上。

第一步：准备目录

1
2
3
4
5
# 新建文件夹 opencode 和数据子目录
mkdir -p /volume1/docker/opencode/{data,workspace}

# 进入 opencode 目录
cd /volume1/docker/opencode

注意：/volume1/docker/opencode/data 是示例路径，您可以根据自己的实际情况修改。

第二步：运行容器

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
# 运行容器
docker run -d \
   --restart unless-stopped \
   --name opencode \
   -p 4096:4096 \
   -v $(pwd)/data:/home/opencode \
   -v $(pwd)/workspace:/home/opencode/workspace \
   -e HOME=/home/opencode \
   ghcr.io/anomalyco/opencode:latest \
   web --hostname 0.0.0.0 --port 4096
   
# 带自定义账号密码
docker run -d \
   --restart unless-stopped \
   --name opencode \
   -p 4096:4096 \
   -v $(pwd)/data:/home/opencode \
   -v $(pwd)/workspace:/home/opencode/workspace \
   -e HOME=/home/opencode \
   -e OPENCODE_SERVER_USERNAME=laosu \
   -e OPENCODE_SERVER_PASSWORD=123456 \
   ghcr.io/anomalyco/opencode:latest \
   web --hostname 0.0.0.0 --port 4096

参数说明：

  • 端口 (-p)

    • 本地端口 4096 映射到容器的 4096 端口。

  • 卷 (-v)

    • 将当前目录下的 data 文件夹（即您刚创建的 /volume1/docker/opencode/data）挂载到容器的 /home/opencode 目录，用于持久化存储 OpenCode 的数据。
    • 将当前目录下的 workspace 文件夹，挂载到容器的 /home/opencode/workspace 目录，作为项目文件夹。

  • 环境变量 (-e)

    • HOME=/home/opencode: 设置容器内的主目录。
    • OPENCODE_SERVER_USERNAME=laosu：设置自定义用户名，默认用户为 opencode 。
    • OPENCODE_SERVER_PASSWORD=123456：添加强密码的保护。

  • 容器执行命令

    • web --hostname 0.0.0.0 --port 4096: 这部分是容器启动后执行的命令，意为以 Web 模式启动，并监听在所有网络接口的 4096 端口上。

运行

  • 对于 Web 模式，执行命令后，在浏览器中输入 http://群晖IP:4096 即可看到 OpenCode 的网页界面。

如果设置了自定义账号密码，则需要先登录

用来跑代码还是不错的

手机上也能看到对话

参考文档

anomalyco/opencode: The open source coding agent.
地址：https://github.com/anomalyco/opencode/

OpenCode | 开源 AI 编程代理
地址：https://opencode.ai/

Package opencode
地址：https://ghcr.io/anomalyco/opencode