codebuddy在windows上的配置需分四步：先安装node.js（v18/v20 lts并勾选add to path），再选择安装ide或cli，接着配置models.json指定模型api，最后通过项目级.codebuddy文件夹实现多项目隔离。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy 在 Windows 上的配置不是单一步骤，而是分层、按需展开的过程：核心是装对工具链（Node.js + CodeBuddy 本体），再配好模型和项目环境。下面直接说清楚每一步该做什么、为什么这么做、容易卡在哪。
装好 Node.js（必须，且版本要对）
CodeBuddy CLI 和部分本地服务（比如 WireMCP）都依赖 Node.js 运行。Windows 下装错版本或漏配环境变量，后面命令根本跑不起来。
- 去 https://nodejs.org/zh-cn 下载 v18.x 或 v20.x 的 LTS 版本（别下最新测试版）
- 运行 .msi 安装包时，务必勾选 “Add to PATH” —— 这一步跳过，后续所有 npm、codebuddy 命令都会报“不是内部命令”
- 安装完，关掉所有旧终端，新开 PowerShell 或 CMD，执行：
node -v和npm -v
看到类似v20.11.1和10.2.4就算成功
安装 CodeBuddy IDE 或 CLI（二选一，或都装）
IDE 适合边聊边写、可视化操作；CLI 更适合自动化、脚本化任务（比如批量分析 PCAP）。新手建议先装 IDE，熟悉后再用 CLI。
-
IDE 安装：去官网下载
CodeBuddy-win32-x64-user-xxx.exe，双击运行 → 同意协议 → 建议把安装路径改成 D:CodeBuddy 等非系统盘（避免 C 盘爆满）→ 完成后启动，用腾讯云账号登录即可 -
CLI 安装：确保 Node.js 已就绪后，在 PowerShell 中执行：
npm install -g @codebuddy/cli
装完后输入codebuddy --version验证是否可用
配置模型（让 AI 真正能“说话”）
默认 CodeBuddy 不连任何大模型，必须手动指定 API 地址和密钥，否则聊天框只会返回“模型未就绪”。关键文件是 models.json。
- 在 Windows 上，路径为：
C:Users\.codebuddymodels.json - 如果该文件夹不存在，手动创建
.codebuddy文件夹，并新建models.json - 填入类似这样的内容（以天翼云 GLM-5.1 为例）：
{ "models": [{ "id": "glm-5.1", "name": "天翼云GLM", "vendor": "OpenAI", "url": "https://wishub-x6.ctyun.cn/v1/chat/completions", "apiKey": "your_actual_api_key_here", "supportsToolCall": false, "supportsReasoning": true }] } -
注意：apiKey 要替换成你实际购买的密钥；url 若用编程套餐，要在
/v1前加/coding；改完保存，重启 CodeBuddy 才生效
多项目配置隔离（避免 A 项目影响 B 项目）
如果你同时开发多个项目（比如一个用 Python，一个用 MCP 协议分析流量），语言、模型、路径设置混在一起会出问题。CodeBuddy 支持三层配置，推荐用项目级隔离。
- 在每个项目根目录下，新建文件夹：
.codebuddy - 在里面放两个文件：
•settings.json：存团队共用设置，如"model": "glm-5.1"
•settings.local.json：存个人敏感项，如本地路径、临时密钥（这个文件默认被 Git 忽略） - 切换项目时，在 CodeBuddy 输入框打：
/folder D:my-project-a
它会自动加载该项目下的.codebuddy配置
