零成本搭建AI编程助手：openwork部署实战指南，替代Claude Cowork的完整方案

目标：30分钟内拥有一个终端AI编程助手

上一篇介绍了openwork这个项目——基于OpenCode的Claude Cowork开源替代品。这篇我们直接动手，从零开始部署openwork，让你在终端里拥有一个AI编程搭档。

前置要求：macOS或Linux系统，至少8GB RAM，安装了Node.js 20+和Git。

第一步：安装OpenCode引擎

openwork依赖OpenCode作为底层引擎。先安装OpenCode：

# macOS / Linux
curl -fsSL https://opencode.ai/install.sh | bash

# 验证安装
opencode --version

如果网络受限，也可以从GitHub Release页面下载二进制文件，然后放到`/usr/local/bin/`下。

第二步：克隆并安装openwork

git clone https://github.com/different-ai/openwork.git
cd openwork
npm install

安装过程大约2-3分钟。如果遇到`node-gyp`编译错误，确保已安装构建工具：

# Ubuntu/Debian
sudo apt install build-essential python3

# macOS
xcode-select --install

第三步：配置API Key

openwork支持接入任意兼容OpenAI API的模型。以DeepSeek为例（性价比最高）：

# 创建配置文件
mkdir -p ~/.openwork
cat > ~/.openwork/config.json << 'EOF'
{
  "provider": "openai-compatible",
  "base_url": "https://api.deepseek.com/v1",
  "api_key": "你的DeepSeek API Key",
  "model": "deepseek-chat",
  "max_tokens": 4096
}
EOF

也可以用Claude API：

cat > ~/.openwork/config.json << 'EOF'
{
  "provider": "anthropic",
  "api_key": "你的Anthropic API Key",
  "model": "claude-sonnet-4-20250514",
  "max_tokens": 4096
}
EOF

**安全提醒**：不要把API Key直接写在命令行里（会被shell历史记录保存）。建议用`export OPENWORK_API_KEY=”xxx”`环境变量方式，openwork会自动读取。

第四步：启动并验证

# 在项目目录下启动
npx openwork

# 或者全局安装后直接运行
npm install -g openwork
openwork

启动后你应该看到一个终端TUI界面，左侧是文件列表，右侧是对话区。输入`/help`查看所有可用命令。

第五步：验证AI能正确理解你的项目

在openwork的对话区输入：

请分析这个项目的整体结构，告诉我主要模块和依赖关系

openwork会自动索引当前目录下的代码，给出项目概览。如果这一步成功，说明配置正确。

为什么选择DeepSeek而不是Claude API？

说实话，如果你有Claude API的预算，直接用Claude Sonnet 4体验最好。但如果你在控制成本（尤其是个人开发者），DeepSeek是当前综合性价比最高的选择。一个对比：

| 指标 | DeepSeek Chat | Claude Sonnet 4 | GPT-5.6 Luna |

|——|:—:|:—:|:—:|

| 代码理解 | 很好 | 极好 | 很好 |

| 价格/百万token | ~¥1 | ~¥20 | ~¥1 |

| 最大上下文 | 128K | 200K | 128K |

| 中文支持 | 优秀 | 良好 | 良好 |

注意：用DeepSeek做复杂多步重构任务时，偶尔会出现”忘记前几轮对话内容”的情况——这是128K上下文窗口在实际表现中不如Claude 200K稳定。遇到这种情况，用`/clear`清空对话历史重新开始即可。

常见问题和解决

问题1：启动时报”OpenCode not found”

# 确认OpenCode在PATH中
which opencode
# 如果没有，手动指定路径
export OPENCODE_PATH=/usr/local/bin/opencode

问题2：AI响应很慢或超时

检查API provider是否可用。可以用curl快速测试：

curl -s https://api.deepseek.com/v1/models \
  -H "Authorization: Bearer $OPENWORK_API_KEY"

问题3：大项目索引时内存不足

修改配置文件限制索引范围：

{
  "index": {
    "max_files": 5000,
    "exclude_patterns": ["node_modules", ".git", "dist", "build"]
  }
}

openwork vs Claude Cowork：一分钱一分货？

说到选择，很多开发者会问：用了openwork之后，真的可以完全放弃Claude Cowork吗？答案是”看情况”。

测试发现，openwork在以下场景接近Cowork水平：

– 代码审查：分析代码质量、发现潜在bug的能力基本持平

– 项目理解：索引后对整个项目的把握不输Cowork

– 简单重构：重命名、提取函数、移动文件等日常操作

但在复杂多步任务上差距明显：

– 跨文件依赖重构：Cowork能理解A改了什么导致B需要跟着改，openwork偶尔会遗漏

– 自动生成测试：Cowork的测试生成更全面，边界情况覆盖更好

– 自主debug：Cowork能自己跑测试、看报错、修正、再跑——openwork目前还需要人工在中间介入

这是开源项目的正常成长曲线——功能可以追，但稳定性需要时间和用户量来积累。916颗星说明社区已经认可了方向，剩下的只是时间问题。

— END —
LC 智趣厅 · 科技与生活的交点
ihygg.cn