集合了 WorkBuddy 与 QClaw 的详细装机步骤、首次启动指引、常见错误码速查。 包含 Mac / Windows 双系统说明,以及现场最容易遇到的 5 个错误的处理方式。
整个过程 ≈ 3 分钟。建议使用 Wi-Fi 下载安装包。
访问官网:codebuddy.cn/work ↗
页面会根据你的系统自动推荐对应版本:
下载速度慢?现场已发的U盘里有离线安装包,直接拷贝使用。
Windows:
Mac:
启动后第一件事是登录:
登录后会让你授权一个工作目录。这是关键的安全设置:
桌面/AI工作区 这种专门的子目录。在对话框输入:
如果能正确返回文件列表,说明:
这就完成入门了,回去看 WorkBuddy QA →
整个过程 ≈ 3 分钟。两个产品可以同时安装、互不冲突。
Mac 用户跳过此步,可直接下载安装。
Windows 用户:
Windows:
Mac(关键步骤):
下列错误码出现频率最高,看说明 1 分钟自助解决。
| 错误码 | 含义 | 处理方法 |
|---|---|---|
| 14003 | 积分 / Token 不足 | ① 进 WorkBuddy 客户端首页签到送积分;② 切换免费模型重试;③ 简化任务(拆小,少消耗)。 |
| 11133 | 当前模型暂不可用 | ① 切换到其他模型(混元 / DeepSeek / Kimi 任一);② 等 5 分钟重试;③ 通常是高峰期网络波动。 |
| 6003 | 会话 / 鉴权超时 | ① 退出账号重新登录;② 重启客户端;③ 检查网络(公司内网时换热点)。 |
| 40003 | 文件路径不可访问 | ① 检查路径是否在授权目录内;② 文件名不要含特殊字符;③ 给 Mac QClaw 授予"完全磁盘访问权限"。 |
| 50001 | 服务端临时错误 | ① 等 1 分钟重试;② 切换模型;③ 持续出现请联系 codebuddy@tencent.com。 |
能同时装,不会冲突。它们用的是不同的进程、不同的服务器接口,互不干扰。
资源占用:闲置时合计内存 ≈ 600 MB;同时运行复杂任务时 ≈ 1.2 GB。建议电脑内存 8 GB 起。
这是企业 IT 把"安装新软件"权限锁了。处理方式:
WorkBuddy 和 QClaw 都是桌面端产品,手机上没有独立 App。
但你可以:
这其实就是它们最大的特色之一。
能装,但体验会受影响。建议:
3 种方式: