Skip to main content
安装插件后还不能直接对话。CC GUI 通过本机 Node.js 拉起 AI 运行时：Claude 和 Codex 走 SDK，Grok / Kimi / OpenCode / Pi 走你已经装好的 CLI。 JetBrains 端没有单独的安装向导命令。打开右侧 CC GUI 工具窗口后，在设置里完成 Node、SDK 和供应商配置。
打开 设置 → SDK 依赖 可以检查 Node 与 SDK 状态。缺什么就装什么，再回到供应商页配凭证。

​
1. 准备 Node.js 18+

VS Code 端文档要求 Node 20+。JetBrains 端以本仓库代码检测为准，当前是 18+。
CC GUI JetBrains 端要求 Node.js 主版本 ≥ 18（代码检测阈值）。这条路径只给插件自己用，不会改你项目终端里的 Node。 项目可以继续用更低版本的 Node。单独装一份 Node 18+（推荐 LTS），再把可执行文件路径填进 CC GUI。
1

安装一份独立的 Node 18+

用官网安装包、nvm、fnm 或系统包管理器都可以。装完后在对应环境里运行：
把输出的完整路径记下来。Windows 必须指向 node.exe。
2

填到 CC GUI

打开 CC GUI → 设置 → 基础配置 → 环境，把路径贴到插件专用 Node.js 路径，点 保存。留空时，插件会尝试自动检测 PATH 上的 node。
设置里的 Node 路径 常见情况：

​
2. 安装 Claude / Codex SDK

Claude Code 和 Codex 需要对应 SDK。插件把它们装到用户目录（与 VS Code 端共用 ~/.codemoss/dependencies/ 一类路径）。 对应 npm 包：
  • Claude：@anthropic-ai/claude-agent-sdk
  • Codex：@openai/codex-sdk
1

打开 SDK 依赖

在 CC GUI 点 设置 → SDK 依赖。
2

安装缺失项

对未安装的 SDK 点 安装。
3

确认版本

安装完成后应能看到当前版本。Codex 还会检查 CLI 完整性；不完整时状态会显示为未安装。
SDK 依赖页
对话区如果提示「SDK 尚未安装」，点 前往安装 会跳到这一页。

​
3. 按需安装本机 CLI

Grok、Kimi、OpenCode、Pi 不会被插件自动安装。你要先在系统终端装好，并确认命令可用，再回到 设置 → 供应商管理 → CLI 点 重新检测。 各引擎的安装命令写在对应页面： 只想先跑通 Claude 或 Codex 时，可以跳过这一步。检测与 PATH 排障见 检测与安装。

​
4. 配供应商

环境就绪后，到侧栏配置 Claude 或 Codex 供应商。下一步：发出第一条消息。