CodeBuddy CLI支持终端自然语言编程:①交互模式用codebuddy进入,自动读取项目上下文;②单次执行用-p参数,加--dangerously-skip-permissions可改文件;③权限模式含auto/plan/manual三种,支持--add-dir扩展目录访问,--ide直连本地IDE。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想在终端里用自然语言让AI帮你写代码、改文件、跑命令,但每次敲命令都得翻文档查参数——CodeBuddy CLI 提供了几十个参数,不搞清核心用法,光靠试错根本没法高效干活。
启动交互式对话
这是最基础也最常用的入口。直接输入 codebuddy 就能进入聊天界面,AI 会自动读取当前目录结构、打开的文件、Git 历史等上下文信息。
如果当前目录没进对,AI 可能读不到你要改的 src/ 或 tests/ 文件夹——【务必先 cd 进项目根目录再运行】。
想换模型?加 --model 参数:codebuddy --model deepseek-v3.1。
单次执行并立刻退出
适合写脚本或 CI/CD 场景,不想要交互式等待。
方法一:用 -p(--print)参数codebuddy -p "生成一个 Python 的斐波那契函数"
这会直接输出结果后退出,方便管道处理(比如接 | grep 或重定向到文件)。
⚠️注意:如果任务需要操作文件或执行命令(比如“把 index.js 改成 ES6 模块”),-p 模式默认会拒绝——必须加 --dangerously-skip-permissions 才能通过权限检查。
方法二:用 -c(--continue)恢复最近一次对话,但只输出本轮响应codebuddy -c -p "补全刚才的函数测试用例"
精准控制 AI 行为的系统提示词
三种方式,适用场景完全不同,别混用。
方法一:完全替换默认指令(慎用)codebuddy --system-prompt "你是一个只输出 Markdown 表格的助手,不解释、不换行、不加空行"
这会丢掉所有 CodeBuddy 内置能力(比如文件编辑、命令执行),仅剩纯文本生成。
方法二:从文件加载提示词(团队协作首选)
先创建 team-prompt.txt,内容必须是纯文本,不能有 BOM 头;
再运行:codebuddy -p --system-prompt-file team-prompt.txt "设计用户登录接口"。
方法三:追加指令(推荐日常使用)codebuddy --append-system-prompt "所有生成的 SQL 必须带注释说明用途"
它保留 CodeBuddy 原有功能,只额外约束输出风格。
权限模式选择
第一步:明确你要什么安全级别。
DeepSeek
DeepSeek是一款由深度求索公司开发的免费AI助手,支持Web端和移动端使用。它拥有强大的自然语言处理能力,可进行文本对话、内容创作、代码编写、文件处理(支持图像、PDF、Word、Excel、PPT等格式)以及联网搜索。DeepSeek上下文长度达1M tokens,能一次性处理海量信息(如《三体》三部曲)。其核心优势在于完全免费、响应迅速、支持语音输入,并提供API服务,适合学习、办公和开发等多种场景。
下载
① 自动模式(auto):信任当前目录后,读文件、改配置、运行 npm test 都自动放行。
② 计划模式(plan):每次要改代码前,先给你展示 diff 和将执行的命令,确认后再动。
③ 手动模式(manual):每一步——包括读 package.json、写 .env、执行 git status——都要按 y/n 确认。
直接加参数启用:codebuddy --permission-mode plan。
想临时绕过所有检查?用 --dangerously-skip-permissions,但【仅限本地无网络的沙箱环境】,生产服务器上禁用。
访问项目外的文件或目录
默认情况下,CodeBuddy 只能读写当前目录及子目录。想让它读 /etc/nginx/conf.d/ 或 ~/Downloads/api-spec.yaml?必须显式授权。
用 --add-dir 参数,可多次叠加:codebuddy --add-dir /etc/nginx --add-dir ~/Downloads "根据 nginx 配置和 API 文档生成反向代理测试用例"。
路径必须是绝对路径,相对路径如 ../config 会被忽略。
连接本地 IDE
如果你正在 VS Code 或 JetBrains 系列 IDE 中编码,且已安装 CodeBuddy 插件,可用此参数直连上下文。
codebuddy --ide
它会自动发现已运行的 IDE 实例,并同步当前打开的文件、光标位置、选中文本——比单纯传文件内容更精准。
失败时检查:IDE 插件是否已启用、是否登录同一账号、IDE 是否处于前台运行状态。