摘要
习惯了 Claude Code 的命令行体验?WorkBuddy CLI 几乎是一比一的替代------同样的 Claude 能力,不怕封号。
一、为什么需要 CLI 形态?
有些开发者就是喜欢在终端里工作:
- 不需要打开笨重的 IDE
- 一句话完成复杂操作
- 适合远程服务器上的开发
- 和 git、docker 等工具无缝衔接
Claude Code 的命令行体验很棒------但封号风险太大。WorkBuddy CLI 提供同样的体验,用的也是 Claude,但走合规通道。
二、安装
bash
# 全局安装
npm install -g @tencent-ai/codebuddy-code
# 验证安装
codebuddy --version
三、首次登录
codebuddy
选择登录方式:
- International Site(选这个!国际站才有 Claude)
- 浏览器会自动打开,Google/GitHub 授权
- 回到终端,显示登录成功
四、基本用法
自然语言下达任务
shell
$ codebuddy
> 帮我在当前项目中添加 JWT 认证中间件,支持 token 刷新
WorkBuddy CLI 会:
- 分析项目结构
- 找到相关文件
- 生成修改方案
- 征求确认后执行
常用命令
| 命令 | 作用 |
|---|---|
/model default |
切换到 Claude 模型 |
/model fast |
切换到快速模型 |
/plan |
查看执行计划 |
/cost |
查看当前积分消耗 |
/clear |
清理上下文 |
/compact |
压缩对话历史 |
/resume |
恢复上次对话 |
五、实战场景
场景 1:项目初始化
shell
$ cd ~/projects
$ mkdir my-saas && cd my-saas
$ codebuddy
> 初始化一个 Next.js 14 SaaS 项目,包含:
> - Supabase 作为数据库和认证
> - TailwindCSS + shadcn/ui
> - Stripe 支付集成
> - 基本的 Dashboard 布局
Claude 会自动执行 npx create-next-app、安装依赖、创建文件结构、写好基础代码。
场景 2:代码重构
shell
$ cd existing-project
$ codebuddy
> 把 src/utils/ 下所有的工具函数从 CommonJS 改成 ESM,
> 更新所有 import 语句,确保测试全部通过
场景 3:调试部署问题
shell
$ codebuddy
> Docker build 报错:"Cannot find module '@prisma/client'"
> 帮我排查 Dockerfile 和 .dockerignore 的问题
场景 4:批量文件操作
markdown
> 把所有 .js 文件改成 .ts,添加基本的类型注解,
> 创建 tsconfig.json,确保 tsc 不报错
六、和 Claude Code 的体验对比
| 对比 | Claude Code | WorkBuddy CLI |
|---|---|---|
| 模型 | Claude | Claude(同源) |
| 安装 | npm install -g @anthropic-ai/claude-code |
npm install -g @tencent-ai/codebuddy-code |
| 登录 | 需要 Anthropic 账号 | Google/GitHub |
| 翻墙 | 全程需要 | 仅首次登录 |
| 封号风险 | 高 | 无 |
| 价格 | $20/月(Pro) | $10/月(Pro) |
| 额度透明度 | 不透明(周限制不公布) | 积分制(清楚知道消耗) |
| 中文支持 | 一般 | 优秀 |
七、进阶技巧
1. 结合 git 使用
markdown
> 看一下最近 3 次提交改了什么,分析有没有潜在的 bug
2. 自动化脚本
shell
> 写一个 GitHub Actions workflow,实现:
> - push 到 main 时自动部署到 Vercel
> - PR 时运行 lint + test
> - 失败时发 Slack 通知
3. 代码审查
shell
> 审查 src/api/ 目录下所有的接口,找出:
> - 缺少错误处理的地方
> - 没有输入验证的端点
> - 潜在的 SQL 注入风险
4. 文档生成
shell
> 为 src/lib/ 下所有导出函数生成 JSDoc 注释和 README
八、常见问题
Q:和 IDE 版本共享积分吗?
A:是的,同一账号积分通用。
Q:能在远程服务器上用吗?
A:可以,SSH 到服务器后执行 codebuddy 即可。
Q:支持 Windows 吗?
A:支持 Windows、macOS、Linux。
Q:可以指定工作目录吗?
A:codebuddy /path/to/project 或在目标目录下直接启动。
九、总结
如果你是 Claude Code 用户,WorkBuddy CLI 就是你的"无痛替代":
- 同样的 Claude 模型
- 同样的命令行体验
- 不用翻墙、不怕封号
- 价格还更便宜