安装
1 常用命令
1.1 /model
选择模型，为当前对话及未来会话选择一个模型。
- MiniMax-M2.5 (x0.17 credits)
- GLM-5.0 (x0.34 credits)
- GLM-4.7 (x0.20 credits)
- GLM-4.6 (x0.20 credits)
- GLM-4.6V (x0.10 credits)
- DeepSeek-V3.2 (x0.26 credits)
- Kimi-K2.5 (x0.42 credits)
- Kimi-K2-Thinking (x0.46 credits)
简单应用场景选择： - 日常高频写代码、补全、改小 bug：优先用MiniMax-M2.5，便宜够用，无压力 - 从 0 学编程、需要有人讲原理、避坑：日常用GLM-4.7/4.6，性价比最高 - 遇到搞不定的报错、搭新项目、理复杂逻辑：偶尔用一次GLM-5.0，时间比那点 token 钱贵多了 - 只会截图报错、看图写代码：刚需场景用GLM-4.6V，用完就切回去 - 读完整项目、开源源码：用DeepSeek-V3.2 - 看图用 Kimi-K2.5 - 啃整本书、全量文档、超复杂逻辑：偶尔用Kimi-K2-Thinking
2 常用快捷键
- alt+v: 粘贴图片
- Esc: 按一次，退出当前任务；按两次，清空输入
- ctrl+c: 退出整个 CLI
- ctrl+y: 复制最近的ai回复
3 CLI 版本安装
# 安装
npm install -g @tencent-ai/codebuddy-code
# 查看是否安装成功
npm list -g @tencent-ai/codebuddy-code
# 查看 codebuddy 的名称
npm view @tencent-ai/codebuddy-code bin
# 查看版本
codebuddy -v
3.1 开启
- 进入项目目录:
cd /path/to/your/project - 启动交互模式:
codebuddy
Open: Pasted image 20260220153917.png
Open: Pasted image 20260220154043.png
Open: Pasted image 20260220154241.png
3.2 初始化
/init
为什么 /init 如此重要？
📊 效果提升：
- ✅ 理解更准确：预先构建项目知识图谱，AI 能更准确理解代码结构和业务逻辑
- ✅ 响应更快速：避免重复扫描文件，后续对话响应速度显著提升
- ✅ 建议更精准：基于全局视图提供更符合项目架构的建议
- ✅ 减少误判：了解项目依赖关系，避免提出不兼容的修改方案
💰 成本优化：
- ✅ Token 消耗更少：一次性建立上下文，避免每次对话都重新分析
- ✅ 减少重复请求：预加载关键信息，减少 30-50% 的上下文 Token 开销
- ✅ 更高效的对话：每轮对话携带更少的冗余信息，整体成本更低
4 基础命令
- Press Esc twice to reset the input box.
- Press Ctrl + V to paste URLs, file paths, or images.
- Run /init to create a CODEBUDDY.md or AGENTS.md file with instruction…
- ! for bash mode
- double tap esc to clear input
- ctrl + _ to undo
- / for commands
- alt+m to auto-accept edits
- ctrl + z to suspend
- @ for file paths
- ctrl + r for verbose output
- tab to autocomplete
- to memorize
- shift + ⏎ for newline
- ctrl + a/e line nav
- Enhanced editing
- ctrl + k/u kill line
- ctrl + y copy response
5 快捷键
5.1 基础导航
| 快捷键 | 功能 |
|---|---|
↑/↓ |
浏览命令历史 |
↓ |
查看后台任务（当有运行中任务时） |
Tab |
命令自动补全 |
Esc |
清空输入（按两次） / 返回上级菜单 |
Ctrl+C |
退出程序 |
5.2 权限和模式
| 快捷键 | 功能 |
|---|---|
Shift+Tab (macOS/Linux) 或 Alt+M (Windows) |
切换权限模式（default → bypass → accept → plan） |
5.3 编辑功能
| 快捷键 | 功能 |
|---|---|
Ctrl+R |
展开/收起详细输出（在对话中） |
Ctrl+G |
使用外部编辑器编辑提示词 |
Enter |
发送消息 |
Shift+Enter |
换行（多行输入） |
\Enter |
换行（反斜杠转义） |
Ctrl+J |
插入换行（多行输入） |
5.4 面板操作
| 快捷键 | 功能 |
|---|---|
↑/↓ |
在面板中导航选项 |
Enter |
选择当前项 |
Space |
切换选择（多选面板） |
k |
终止选中的后台任务 |
5.5 专用功能
| 快捷键 | 功能 |
|---|---|
j/k |
Vim风格的上下导航（部分面板支持） |
Ctrl+O |
查看思考详情面板 |
当终端显示“Thinking”指示时，可用 Ctrl+O 打开完整推理内容,再按 Ctrl+O 退出。
6 设置
6.1 特定语言回复（如简体中文）
/config
6.2 全自动化
6.2.1 命令白名单
命令: /permissions
当 CodeBuddy 尝试运行白名单里的命令时，会直接执行，不再弹窗询问
git commit -m "*"
6.2.2 沙箱模式
命令: /sandbox
它只能访问当前项目目录，且无法随意访问网络。
适用场景： - 复杂重构或大规模代码迁移 - 探索性任务，如分析整个项目的依赖关系 - 需要频繁修改文件和运行命令的自动化流程
6.2.3 跳过检查（含使用风险提示）
命令: codebuddy --dangerously-skip-permissions
这相当于给了它 “管理员权限”，可能会误删文件或搞乱环境，仅限绝对信任的封闭环境使用。 适用场景：
- CI/CD 流水线中的代码生成任务
- 封闭容器内的批量处理作业
- 可信环境下的样板代码生成
6.2.4 临时切换
快捷键动态切换权限模式，无需退出即可临时获得全局权限 操作方法:
- macOS / Linux: 按
Shift + Tab - Windows: 按
Alt + M
6.3 配置目录
C:\Users\你的用户名.codebuddy\settings.json
# powershell 中运行：
explorer "$env:USERPROFILE\.codebuddy"
7 问题经验
7.1 Git 出错
> 我手动执行是没问题，但是为什么你启动 bash 就不行呢？
⎿ aborted
用户说手动执行 Git 是没问题的，但为什么我启动 Bash 就不行。这是一个好问题。
让我分析一下可能的原因：
1. **编码问题**：Git Bash 在 Windows 上默认使用 GBK 编码，而项目文件可能包含 UTF-8 编码的中文字符
... 4 more lines (press Ctrl+O to expand)
● 这是个好问题。让我分析一下可能的原因：
1. 编码不匹配 - Git Bash 默认使用系统编码（GBK），而你的项目是 UTF-8 中文
2. 环境变量缺失 - 我的 Bash 会话环境可能缺少某些关键变量
3. PWD 问题 - 当前工作目录状态可能不一致
让我尝试设置正确的环境变量后再试一次：
● Bash(export LANG=zh_CN.UTF-8 && export LC_ALL=zh_CN.UTF-8 && export GIT_TERMINAL_PROMPT=1 && cd /d/product/AIasMe && git status)
⎿ �l g鑜孮{|
曪嬨Nx: Bash/CallMsi/Install/REGDB_E_CLASSNOTREG
问题依旧。错误代码 `REGD_B_E_CLASSNOTREG` 看起来是 Windows 注册表相关的错误，表示某个 COM 组件没有注册。这可能与 Git Bash 的某些组件有关。
让我看看是否可以通过其他方式解决，比如使用 Windows 原生命令或者检查配置文件。
- 系统可能安装了额 WSL ，把 WSL 完全删除掉。重新安装 Git bash 和 codebuddy，在 PATH 中设定 git 就好。
- codebuddy 在安装时，它如果发现 WSL，默认的 bash 会用 WSL 的 bash，如果 WSL 出现问题，codebuddy 也会有问题。