codebuddy cli在macos上需确保node.js≥18.20，并推荐用homebrew安装：先执行brew tap tencent-codebuddy/tap，再运行brew install codebuddy-code，自动注入path；若用npm安装则需手动将~/.npm-global/bin加入~/.zshrc并source生效，最后用which codebuddy和codebuddy --version验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想在 macOS 上装好 CodeBuddy 并让它在终端里直接敲 codebuddy 就能运行，不是只靠双击安装包完事——必须让系统知道这个命令在哪，否则终端会报 command not found。这一步漏掉，CLI 功能就彻底瘫痪。
确认 Node.js 版本是否达标
CodeBuddy CLI 要求 Node.js ≥ 18.20。打开终端，执行：
node --version
如果输出是 v16.20.0 或更低，必须升级。老版本会导致 CLI 启动失败或模型调用中断，且错误提示不明确。
用 Homebrew 安装 CodeBuddy（推荐）
这是 macOS 上最干净的方式，全程自动处理 PATH 注入，无需手动改配置文件。
先添加官方源：
brew tap Tencent-CodeBuddy/tap
再执行安装：
brew install codebuddy-code
Homebrew 会把二进制文件放到 /opt/homebrew/bin/codebuddy（Apple Silicon）或 /usr/local/bin/codebuddy（Intel），并自动注册到 /etc/paths.d/codebuddy-code。这意味着所有新终端窗口都能立即识别该命令，【无需重启终端或 source 任何文件】。
手动配置 PATH（仅当 Homebrew 不可用时）
如果你没装 Homebrew，或因权限限制无法使用，才走这条路。注意：此方式易出错，且需手动维护。
第一步：找到 CodeBuddy CLI 的实际位置。若用 npm 安装，通常在：
~/.npm-global/bin/codebuddy
第二步：将该路径加入 shell 配置文件。macOS 默认 shell 是 zsh，编辑 ~/.zshrc：
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
第三步：立即生效配置：
source ~/.zshrc
⚠️关键提醒：不要写成 export PATH="$PATH:$HOME/.npm-global/bin"——把自定义路径放末尾，会导致系统命令被覆盖，可能破坏 ls、git 等基础命令。
验证环境变量是否生效
关闭当前终端，新开一个窗口，执行：
which codebuddy
应返回完整路径，例如 /opt/homebrew/bin/codebuddy。
再运行：
codebuddy --version
看到版本号（如 v1.12.0）即表示 CLI 已就绪，可进入下一步配置模型。
