CodeBuddy Code（终端版）

概述

CodeBuddy Code 是 CloudStudio 内置的智能编码工具，可在终端中通过自然语言完成常见开发任务（解释/优化/修复代码、生成测试、代码审查等）。

重要

CloudStudio 里面的 CodeBuddy 配额是每月 500 credit。

一、快速开始

1）进入交互模式（默认）

在任意项目目录运行：

codebuddy

启动后在输入框直接输入需求即可。

2）执行单次任务（非交互）

codebuddy "修复这个 bug"

二、常用场景（示例）

1）日常开发

codebuddy "帮我优化这个函数的性能"
codebuddy "为这个组件添加错误处理"
codebuddy "生成这个 API 的单元测试"

2）代码审查

codebuddy "检查这次提交的代码质量"
codebuddy "分析潜在的安全问题"
codebuddy "建议代码改进方案"

3）学习与探索

codebuddy "解释这个算法的实现原理"
codebuddy "这个设计模式在项目中如何使用"
codebuddy "推荐适合的第三方库"

三、命令速查

1）基本用法

codebuddy [选项] [命令] [提示词]

2）常用选项

备注

下面只保留高频选项；更多参数可使用 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