一、背景与目标
目标：在 IntelliJ IDEA 中使用 Claude Code 风格的 AI 编程助手，且希望免费、稳定、合规。
最终方案：IntelliJ IDEA + CC GUI 插件 + cc-switch 工具 + 智谱AI GLM 免费模型。
二、完整过程与遇到的问题
阶段 1：想要安装 Claude Code，遭遇网络限制
问题描述：访问 Claude Code 官网安装脚本时，提示“Anthropic 保留不向其直接或间接多数所有权归属于我们支持地区政策中其他国家的实体提供其产品或服务的权利”。
原因：中国大陆不在 Anthropic 官方服务支持的地区列表中。
解决方案：放弃直连 Claude 官方，改用国内可用的模型 API（DeepSeek / 智谱AI）来驱动 Claude Code 的交互界面。
阶段 2：选择 DeepSeek，发现免费额度政策变化
问题描述：原本计划使用 DeepSeek 的新用户免费额度（此前有 500 万 Token 赠送），但登录后找不到免费额度。
原因：DeepSeek 在 2026 年 7 月初调整了政策，新用户免费额度从 500 万 Token 调整为 300 万 Token，且展示位置不明显，容易被忽略。
解决方案：转向智谱AI 的GLM-4-Flash模型，该模型官方承诺永久免费，无需担心额度耗尽。
阶段 3：CC GUI 插件报错“未找到 Node.js”
问题描述：安装 CC GUI 插件后，点击CC GUI,提示找不到 Node.js 环境。
原因：电脑上根本没有安装 Node.js。
解决方案：
从 nodejs.org 下载 LTS 版本安装包。
安装完成后，在 CMD 中执行
node --version和npm --version验证。重启 IDEA，CC GUI 自动检测到 Node.js。
阶段 4：CC GUI 提示“Claude Code SDK 尚未安装”
问题描述：Node.js 装好了，但 CC GUI 面板仍然报错“Claude Code SDK 尚未安装，请先安装 SDK 才能开始对话”。
原因：CC GUI 只是界面层，真正的“引擎”是 Claude Code SDK（约 200MB），需要单独安装。
解决方案（踩坑点）：
点击 CC GUI 中的“前往安装”按钮，自动安装卡在“安装中…”状态不动。
手动解决：在终端执行：
bash
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
安装完成后执行
claude --version验证。重启 IDEA，SDK 提示消失，面板可用.
阶段 5：找不到“导入 cc-switch 配置”按钮
问题描述：在 CC GUI 面板设置中找不到“导入 cc-switch 配置”选项。
原因：CC GUI 版本更新后，界面布局调整，该入口可能被移动或隐藏；也可能是 SDK 未安装导致部分功能未加载。
解决方案：改为手动配置供应商：
在 CC GUI 设置 → 供应商管理中，手动添加智谱AI 配置：
供应商名称：智谱GLM
API 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 IDEA | 2024.2 及以上版本 | 确保插件兼容 |
| Node.js | LTS 版本（如 v22.x） | 官网下载 |
| CC GUI 插件 | 最新版 | IDEA 插件市场安装 |
| cc-switch | 最新版 | 从 GitHub Releases 下载，可视化配置模型 |
| Claude Code SDK | v0.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，完全免费，稳定可用
