第 2 卷

最佳实践：

# 第一次使用项目时 > /init

# 项目结构发生重大变化时（如添加新模块、重构等）

> /clear# 开启全新对话 > /init# 重新初始化

4.尝试第一个对话

> 帮我分析这个项目的结构

CodeBuddy 会自动扫描您的项目文件，并提供详细的结构分析。

💡核心使用模式

交互式对话模式

最自然的使用方式，适合探索性开发：

bash

codebuddy

典型对话示例：

> 我想给这个 React 组件添加一个加载状态 > 帮我重构这个函数，让它更易读 > 这段代码有什么潜在的性能问题？

> 为这个 API 接口写单元测试

单次命令模式

适合脚本化和自动化场景：

bash

# 直接提问 codebuddy -p "优化这个 SQL 查询的性能"

# 管道输入 cat error.log | codebuddy -p "分析这些错误日志"

# 文件分析（需要授权时必须添加 -y 或 --dangerously-skip-permissions）

codebuddy -p "审查 src/utils.js 的代码质量" -y

重要提示：使用 -p/--print 参数进行单次执行时,如果操作需要访问文件、执行命令等授权操

作,必须添加 -y（或 --dangerously-skip-permissions ) 参数。

项目级操作

处理复杂的跨文件任务：

bash

# 项目重构（需要文件操作授权）

codebuddy -p "将所有组件从 class 组件迁移到函数组件" -y

# 代码规范（需要文件读取授权）

codebuddy -p "检查整个项目的 TypeScript 类型定义" -y

# 测试覆盖（需要文件操作授权）

codebuddy -p "为 services 目录下的所有文件添加单元测试" -y

快捷键

基础导航

快捷键功能

↑/↓浏览命令历史

↓查看后台任务（当有运行中任务时）

Tab命令自动补全

Esc清空输入（按两次） / 返回上级菜单

Ctrl+C退出程序

Ctrl+D退出程序（输入框为空且无进行中对话时，连按两次）

权限和模式

快捷键功能

Shift+Tab (macOS/Linux) 或 Alt+M切换权限模式（default → bypass → accept →

(Windows)plan）

编辑功能

快捷键功能

Ctrl+R展开/收起详细输出（在对话中）

Ctrl+G使用外部编辑器编辑提示词

Enter发送消息

Shift+Enter换行（多行输入）

\Enter换行（反斜杠转义）

Ctrl+J插入换行（多行输入）

面板操作

快捷键功能

↑/↓在面板中导航选项

Enter选择当前项

Space切换选择（多选面板）

k终止选中的后台任务

专用功能

快捷键功能

j/kVim风格的上下导航（部分面板支持）

Ctrl+O查看思考详情面板

当终端显示“Thinking”指示时，可用 Ctrl+O 打开完整推理内容,再按 Ctrl+O 退出。

🎓进阶学习

恭喜您完成快速入门！接下来推荐阅读：

常见工作流 -学习扩展思考、图片分析等高级功能

IDE集成 -在 VS Code、JetBrains中使用

斜杠命令 -掌握所有内置命令

MCP集成 -扩展自定义工具