一、背景与目标目标在 IntelliJ IDEA 中使用 Claude Code 风格的 AI 编程助手且希望免费、稳定、合规。最终方案IntelliJ IDEA CC GUI 插件 cc-switch 工具 智谱AI GLM 免费模型。二、完整过程与遇到的问题阶段 1想要安装 Claude Code遭遇网络限制问题描述访问 Claude Code 官网安装脚本时提示“Anthropic 保留不向其直接或间接多数所有权归属于我们支持地区政策中其他国家的实体提供其产品或服务的权利”。原因中国大陆不在 Anthropic 官方服务支持的地区列表中。解决方案放弃直连 Claude 官方改用国内可用的模型 APIDeepSeek / 智谱AI来驱动 Claude Code 的交互界面。阶段 2选择 DeepSeek发现免费额度政策变化问题描述原本计划使用 DeepSeek 的新用户免费额度此前有 500 万 Token 赠送但登录后找不到免费额度。原因DeepSeek 在 2026 年 7 月初调整了政策新用户免费额度从 500 万 Token 调整为 300 万 Token且展示位置不明显容易被忽略。解决方案转向智谱AI 的GLM-4-Flash模型该模型官方承诺永久免费无需担心额度耗尽。阶段 3CC GUI 插件报错“未找到 Node.js”问题描述安装 CC GUI 插件后点击CC GUI,提示找不到 Node.js 环境。原因电脑上根本没有安装 Node.js。解决方案从 nodejs.org 下载 LTS 版本安装包。安装完成后在 CMD 中执行node --version和npm --version验证。重启 IDEACC GUI 自动检测到 Node.js。阶段 4CC GUI 提示“Claude Code SDK 尚未安装”问题描述Node.js 装好了但 CC GUI 面板仍然报错“Claude Code SDK 尚未安装请先安装 SDK 才能开始对话”。原因CC GUI 只是界面层真正的“引擎”是 Claude Code SDK约 200MB需要单独安装。解决方案踩坑点点击 CC GUI 中的“前往安装”按钮自动安装卡在“安装中…”状态不动。手动解决在终端执行bashnpm install -g anthropic-ai/claude-code --registryhttps://registry.npmmirror.com安装完成后执行claude --version验证。重启 IDEASDK 提示消失面板可用.阶段 5找不到“导入 cc-switch 配置”按钮问题描述在 CC GUI 面板设置中找不到“导入 cc-switch 配置”选项。原因CC GUI 版本更新后界面布局调整该入口可能被移动或隐藏也可能是 SDK 未安装导致部分功能未加载。解决方案改为手动配置供应商在 CC GUI 设置 → 供应商管理中手动添加智谱AI 配置供应商名称智谱GLMAPI Key从智谱AI平台获取模型名称glm-4-flash或glm-4.7-flash阶段 6选择 GLM-5.1 模型但没有余额也能执行问题描述用户选择了付费模型GLM-5.1但账户没有余额请求仍能正常执行。原因分析可能原因之一新用户免费额度智谱AI新用户注册赠送 2000 万 Token 免费额度有效期 3 个月覆盖了 GLM-5.1 的使用。智能降级切换CC GUI / cc-switch 可能在检测到付费模型余额不足时自动切换到了免费模型如 GLM-4.7-Flash用户无感知。第三方平台活动如 Modal 等平台曾限时免费开放 GLM-5.1 API。三、最终成功配置清单组件版本/配置备注操作系统Windows 10 / 11已验证IntelliJ IDEA2024.2 及以上版本确保插件兼容Node.jsLTS 版本如 v22.x官网下载CC GUI 插件最新版IDEA 插件市场安装cc-switch最新版从 GitHub Releases 下载可视化配置模型Claude Code SDKv0.3.201需通过 npm 全局安装模型供应商智谱AI (Zhipu GLM)官网注册 实名认证模型名称glm-4.7-flash永久免费推荐使用四、经验教训与建议在国内使用 AI 工具优先考虑国产模型 API直连 Claude / OpenAI 存在网络和政策风险智谱AI、DeepSeek、通义千问等是更稳定的选择。不要盲目相信“免费额度”各平台免费政策变化频繁建议优先选择官方明确承诺“永久免费”的模型如 GLM-4-Flash。遇到 GUI 工具卡住及时切换到终端手动操作自动安装可能会因网络问题卡死手动命令 国内镜像源往往更可靠。配置完成后“能跑”是第一位的不需要追求最强的付费模型免费模型如 GLM-4.7-Flash在日常代码解释、补全、重构等任务中已经足够好用。环境依赖要先装好Node.js 是这类工具链的基础建议一开始就装好可以避免 80% 的报错。五、快速复盘图一图看懂text目标IDEA 中使用 AI 编程助手 │ ├── ❌ 直连 Claude → 地区限制不通 │ ├── ✅ 改用国产模型 API (智谱AI) │ │ │ ├── 注册智谱AI 获取 API Key │ └── 模型选择glm-4.7-flash (永久免费) │ ├── 安装依赖工具链 │ │ │ ├── Node.js (官网下载 LTS) │ ├── cc-switch (图形化配置模型) │ ├── Claude Code SDK (npm 全局安装用镜像源) │ └── CC GUI 插件 (IDEA 插件市场安装) │ └── ✅ 最终成果IDEA 右侧面板直接对话 AI完全免费稳定可用