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 行为的系统提示词
三种方式，适用场景完全不同，别混用。
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
方法一：完全替换默认指令（慎用）codebuddy --system-prompt "你是一个只输出 Markdown 表格的助手，不解释、不换行、不加空行"
这会丢掉所有 CodeBuddy 内置能力（比如文件编辑、命令执行），仅剩纯文本生成。
方法二：从文件加载提示词（团队协作首选）
先创建 team-prompt.txt，内容必须是纯文本，不能有 BOM 头；
再运行：codebuddy -p --system-prompt-file team-prompt.txt "设计用户登录接口"。
方法三：追加指令（推荐日常使用）codebuddy --append-system-prompt "所有生成的 SQL 必须带注释说明用途"
它保留 CodeBuddy 原有功能，只额外约束输出风格。
权限模式选择
第一步：明确你要什么安全级别。
① 自动模式（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 是否处于前台运行状态。
