OpenCode Cowork

在 AI 编程助手普遍停留在“问答模式”的当下，OpenCodeCowork 提出了一种更进一步的协作范式：让 AI 像真实同事一样，主动完成整项任务——从理解需求、制定计划，到编辑文件、运行命令、验证结果，全程无需人工干预。

作为 Claude Cowork 理念的开源实现，OpenCode Cowork 深度集成于 OpenCode 开发环境，不依赖外部 API 密钥，仅需一个 Markdown 文件即可运行。

它不是聊天机器人，而是执行者

当你输入：

/cowork 重组 src 文件夹，将工具函数分离到独立模块

Cowork 会自动执行以下步骤：

1. 探索代码库：扫描目录结构，分析依赖关系
2. 制定计划：生成清晰的重构方案（如“创建 utils/ 目录，迁移 format.js、validate.js 等”）
3. 执行操作：移动文件、修改 import 路径、更新配置
4. 验证结果：运行测试或检查语法，确保无破坏性变更
5. 输出总结：列出所有变更，说明完成情况

整个过程透明、可追溯，每一步都会实时反馈进度。

核心特性

• 自主代理：不只回答“怎么做”，而是直接“去做”
• 任务规划：将模糊指令分解为可执行子任务
• 进度透明：每步操作均有日志输出，避免“黑箱”
• 安全可控：依托 OpenCode 内置权限系统，所有文件操作需用户授权（可配置）
• 零依赖部署：仅需一个 cowork.md 文件，无额外服务或 API 密钥
• 模型无关：使用你在 OpenCode 中已配置的任何本地或远程大模型（如 Ollama、LM Studio、OpenRouter 等）

快速安装（目前 Cowork 仅支持 macOS/Linux）

推荐方式（一键安装）：

curl -fsSL https://raw.githubusercontent.com/Lucifer1H/open-cowork/main/install.sh | bash

或手动安装：

mkdir -p ~/.config/opencode/command
curl -fsSL https://raw.githubusercontent.com/Lucifer1H/open-cowork/main/command/cowork.md \
  -o ~/.config/opencode/command/cowork.md

前提：已安装并配置好 OpenCode

使用示例

在 OpenCode 终端中，直接使用 /cowork 命令：

/cowork 重构认证模块，提取验证逻辑
/cowork 按功能重新组织 components 文件夹
/cowork 分析代码库并生成完整的 API 文档
/cowork 找出登录间歇性失败的原因并修复
/cowork 将所有类组件转换为带 hooks 的函数式组件

AI 代理将根据项目上下文，自主完成从诊断到实施的全过程。

自定义行为

所有逻辑定义在 ~/.config/opencode/command/cowork.md 中。你可以：

• 修改 AI 的角色设定（如“你是一名资深前端工程师”）
• 添加项目特定规范（如“所有工具函数必须带 JSDoc 注释”）
• 调整执行策略（如是否自动运行测试、是否允许删除文件等）

由于基于 Markdown，修改即时生效，无需重启或编译。

隐私与安全

• 完全本地运行：若你的 OpenCode 配置为本地模型（如 Llama 3、Qwen），所有代码处理均在本机完成
• 无数据上传：不收集代码、不发送请求到第三方服务器
• 操作可审计：所有文件变更通过 OpenCode 的沙箱机制记录，支持回滚