CodeBuddy Code（终端版）
概述
CodeBuddy Code 是 CloudStudio 内置的智能编码工具，可在终端中通过自然语言完成常见开发任务（解释/优化/修复代码、生成测试、代码审查等）。
一、快速开始
1）进入交互模式（默认）
在任意项目目录运行：
codebuddy
启动后在输入框直接输入需求即可。
2）执行单次任务（非交互）
codebuddy "修复这个 bug"
二、常用场景（示例）
1）日常开发
codebuddy "帮我优化这个函数的性能"
codebuddy "为这个组件添加错误处理"
codebuddy "生成这个 API 的单元测试"
2）代码审查
codebuddy "检查这次提交的代码质量"
codebuddy "分析潜在的安全问题"
codebuddy "建议代码改进方案"
3）学习与探索
codebuddy "解释这个算法的实现原理"
codebuddy "这个设计模式在项目中如何使用"
codebuddy "推荐适合的第三方库"
三、命令速查
1）基本用法
codebuddy [选项] [命令] [提示词]
2）常用选项
note
下面只保留高频选项；更多参数可使用 codebuddy -h 查看。
| 选项 | 作用 | 示例 |
|---|---|---|
codebuddy | 启动交互式会话（默认） | codebuddy |
codebuddy "..." | 执行单次任务 | codebuddy "解释这个函数" |
-p, --print | 打印响应并退出（非交互） | codebuddy -p "总结这段代码" |
-c, --continue | 继续最近的对话 | codebuddy -c |
-r, --resume [会话ID] | 恢复指定对话 | codebuddy -r 12345 |
--model <模型> | 指定使用的模型 | codebuddy --model sonnet |
--ide | 启动时自动连接 IDE | codebuddy --ide |
-d, --debug | 开启调试输出 | codebuddy -d |
-h, --help | 显示帮助信息 | codebuddy -h |
-V, --version | 显示版本信息 | codebuddy -V |
四、交互式会话指令（以 / 开头）
在交互模式输入 / 可看到可用指令，例如 /model 用于切换模型。
| 指令 | 用途 |
|---|---|
/add-dir | 添加新的工作目录 |
/agents | 管理 Agent 配置 |
/bashes | 列出和管理后台任务 |
/clear | 清除对话历史并释放上下文 |
/compact | 清理历史但保留摘要（可选：/compact [摘要指令]） |
/config | 打开配置面板 |
/cost | 显示当前会话的总成本和持续时间 |
/doctor | 诊断并验证安装与设置 |
/exit | 退出 CodeBuddy |
/export | 导出当前对话到文件或剪贴板 |
五、子命令
| 子命令 | 用途 | 示例 |
|---|---|---|
config | 管理配置 | codebuddy config set -g theme dark |
mcp | 配置与管理 MCP 服务器 | codebuddy mcp |
doctor | 检查系统健康状态 | codebuddy doctor |
update | 检查并安装更新 | codebuddy update |
install | 安装原生构建版本 | codebuddy install stable |