准备环境

安装扩展后还不能直接对话。CC GUI 通过本机 Node.js 拉起 AI 运行时：Claude 和 Codex 走 SDK，Grok / Kimi / OpenCode / Pi 走你已经装好的 CLI。

第一次打开时，命令面板运行 CC GUI: Run Setup Wizard。向导会检查 Node、提示安装缺失 SDK，并引导你打开侧栏去配供应商。

1. 准备 Node.js 20+

CC GUI 要求 Node.js 主版本 ≥ 20。这条路径只给扩展自己用，不会改你项目终端里的 Node。项目可以继续用 Node 16 或 18。单独装一份 Node 20+，再把可执行文件路径填进 CC GUI。

安装一份独立的 Node 20+

用官网安装包、nvm、fnm 或系统包管理器都可以。装完后在对应环境里运行：

node -p "process.execPath"

把输出的完整路径记下来。Windows 必须指向 node.exe。

填到 CC GUI

打开 CC GUI → 设置 → 基础配置 → 环境，把路径贴到 插件专用 Node.js 路径，点保存。也可以在 VS Code 设置里搜索 ccGui.nodePath。留空时，扩展会尝试自动检测 PATH 上的 node。

常见情况：

Claude Code 和 Codex 需要对应 SDK。扩展把它们装到用户目录：

~/.codemoss/dependencies/claude-sdk
~/.codemoss/dependencies/codex-sdk

对应 npm 包：

打开 SDK 依赖

在 CC GUI 点设置 → SDK 依赖。

安装缺失项

对未安装的 SDK 点安装。也可以在安装向导里勾选后让它代装。

确认版本

安装完成后应能看到当前版本。Codex 还会检查 CLI 完整性；不完整时状态会显示为未安装。

对话区如果提示「SDK 尚未安装」，点 前往安装 会跳到这一页。

Grok、Kimi、OpenCode、Pi 不会被扩展自动安装。你要先在系统终端装好，并确认命令可用，再回到 设置 → 供应商管理 → CLI 点 重新检测。各引擎的安装命令写在对应页面：

只想先跑通 Claude 或 Codex 时，可以跳过这一步。检测与 PATH 排障见检测与安装。

向导结束时会提示：到侧栏里配置 Claude 或 Codex 供应商。点 Open Side Panel，或自己打开 CC GUI。下一步：发出第一条消息。