乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > AI学习搭子创造营第二阶段动手实践任务|智谱官方教程 + 火山方舟Coding Plan双方案完整对比实操笔记

AI学习搭子创造营第二阶段动手实践任务|智谱官方教程 + 火山方舟Coding Plan双方案完整对比实操笔记

当前时间： 2026-08-17 17:53:11 分类：办公文件 评论(0)
AI学习搭子创造营第二阶段动手实践任务|智谱官方教程 + 火山方舟Coding Plan双方案完整对比实操笔记

本次完成AI学习搭子创造营第二阶段动手实践任务，课程核心是掌握MaaS（模型即服务）环境部署，官方示例基于智谱开放平台GLM模型，使用Cline、Claude Code两款AI编程插件；我结合自身需求拓展了火山方舟Coding Plan对接DeepSeek-V4系列代码模型的完整落地方案。

本文整合课程标准流程、Windows/macOS双系统部署步骤，同时记录我实操踩坑、自研的火山方舟完整配置方案，零基础同学可直接复制配置文件使用。

一、阶段学习目标复盘

  1. 1. 理解技术演进：SaaS软件服务 → MaaS模型即服务，无需自建GPU、不用训练模型，线上API直接调用大模型；
  2. 2. 掌握核心基础概念：API Key（调用密钥）、Token（计费/上下文单位）、OpenAI兼容接口、专属Coding编程接口；
  3. 3. 双平台实操落地：
    • 官方方案：智谱BigModel平台 + Cline（Windows）/Claude Code（macOS）+ GLM-4.6
    • 自研拓展方案：火山方舟Coding Plan + Cline/Claude Code + DeepSeek-V4-Flash（锁定单代码模型）
  4. 4. 完整闭环实验：账号注册→获取密钥→工具安装→接口配置→代码调用测试，解决配置404、登录卡死、计费异常等全部报错。

二、课程标准部署流程（智谱官方教程）

2.1 前置：智谱开放平台注册与算力领取

  1. 1. 平台入口：https://bigmodel.cn/ ，手机号注册，在校师生完成「高校X计划」认证，免费领取专属Token算力包；
  2. 2. 获取API Key：头像下拉栏进入API Key页面，新建密钥并立刻复制保存，禁止对外泄露；
  3. 3. 核心优势：零门槛、教学适配、多模态模型全覆盖，适合课程实验、学生练习。

2.2 Windows系统：VS Code + Cline插件（官方标准方案）

步骤1：安装VS Code

官网下载安装，务必勾选「添加到PATH（重启生效）」选项。

步骤2：安装Cline插件

VS Code扩展市场搜索Cline一键安装。

步骤3：API配置面板填写（智谱参数）

进入插件点击Use your own API key，选择OpenAI Compatible：

配置项填写内容
Base URLhttps://open.bigmodel.cn/api/coding/paas/v4
API Key智谱平台生成的ak密钥
Model IDglm-4.6
Context Window Size204800
Supports Images取消勾选

2.3 macOS系统：Node.js + Claude Code终端全局工具

  1. 1. 安装Node.js（版本≥22），配置国内镜像加速： npm config set registry https://registry.npmmirror.com
  2. 2. 全局安装Claude Code命令行工具： sudo npm install -g @anthropic-ai/claude-code 然后用 claude --version 校验
  3. 3. 一键配置智谱环境变量脚本，绑定GLM模型；
  4. 4. 两种使用方式：终端输入claude对话 / VS Code安装Claude Code插件可视化操作。

三、拓展方案：火山方舟Coding Plan对接DeepSeek V4（我的实操落地版）

3.1 方案选择原因

  1. 1. 火山方舟Coding Plan是代码模型专属套餐，配套专属coding接口，不会产生通用推理接口额外扣费；
  2. 2. DeepSeek-V4-Flash/V4-Pro代码能力强，适合复杂项目重构、脚本开发；
  3. 3. 同时兼容Cline（OpenAI兼容协议）、Claude Code（Anthropic协议）两套工具，一套密钥双工具通用。

3.2 前置准备（火山方舟后台）

  1. 1. 登录火山方舟控制台，开通Coding Plan套餐；
  2. 2. 创建ARK类型API Key（ak开头），妥善保存；
  3. 3. 无需手动创建推理接入点，coding专属接口可直接填写官方模型名称。

3.3 方案A：VS Code Cline插件配置（OpenAI兼容接口，对应课程Windows工具）

关键区分（踩坑重点）

官方明确两条接口地址，禁止混用通用推理地址 https://ark.cn-beijing.volces.com/api/v3 ，会404报错+额外收费

✅ 正确Coding专属Base URL： https://ark.cn-beijing.volces.com/api/coding/v3

完整面板填写参数：

配置项填写内容说明
API ProviderOpenAI Compatible和智谱配置逻辑统一
Base URLhttps://ark.cn-beijing.volces.com/api/coding/v3coding专属接口
API Key火山方舟ak开头密钥后台复制
Model IDdeepseek-v4-flash锁定单一代码模型
Context Window Size1024000适配DeepSeek V4超大上下文
Temperature0代码生成降低随机性

全部勾选框统一规则（全部不打勾）

  1. 1. Azure相关选项：取消；
  2. 2. Supports Images：取消（代码模型不支持图片，开启会报错）；
  3. 3. Enable R1 messages format：取消（V4非R1推理模型）；
  4. 4. 双模型规划模式：取消，固定单模型运行。

持久化VS Code settings.json配置（一键复制）

{

"cline.apiProvider": "openai-compatible",

"cline.openAiCompatible.baseUrl": "https://ark.cn-beijing.volces.com/api/coding/v3",

"cline.openAiCompatible.apiKey": "ak-替换成你的火山方舟密钥",

"cline.openAiCompatible.modelId": "deepseek-v4-flash",

"cline.contextWindowSize": 1024000,

"cline.supportImages": false

}

3.4 方案B：Claude Code全局终端配置（Anthropic协议，对应课程macOS工具）

两套必备配置文件，终端、VS Code插件共用一套配置：

文件1：全局参数 settings.json（Windows路径 C:\Users\用户名.claude\settings.json ，Mac路径 ~/.claude/settings.json ）

{

"env": {

"ANTHROPIC_AUTH_TOKEN": "ak-替换火山方舟API密钥",

"ANTHROPIC_BASE_URL": "https://ark.cn-beijing.volces.com/api/coding",

"ANTHROPIC_MODEL": "deepseek-v4-flash",

"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",

"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro",

"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro",

"CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash"

}

}

文件2：放行开关 .claude.json（解决海外登录弹窗卡死）

放在用户根目录，缺少此文件会无限转圈、强制登录境外账号：

{

"hasCompletedOnboarding": true

}

校验命令： claude /status 查看当前接口、模型是否为deepseek-v4-flash

四、两大平台方案横向对比

对比维度课程官方：智谱GLM方案拓展：火山方舟DeepSeek方案
适用工具Windows：Cline；Mac：Claude CodeCline + Claude Code全平台兼容
专属接口/api/coding/paas/v4/api/coding/v3（代码专属套餐）
模型选择固定glm-4.6可选deepseek-v4-flash / deepseek-v4-pro
计费规则新人+师生免费TokenCoding Plan打包计费，通用接口会额外扣费
部署难度极低，教学配套文档完善中等，需区分两套接口，避免404报错
适配场景课堂实验、新手入门、轻量化代码商业项目、长文件重构、大规模开发

五、实操踩坑排错总结（本次学习核心收获）

问题1：404 InvalidEndpointOrModel.NotFound 模型不存在

  • 智谱侧：核对Base URL是否为官方coding地址、模型名glm-4.6拼写无误；
  • 火山方舟侧：90%原因是接口地址用错，不能填通用/api/v3，必须切换/api/coding/v3；通用接口只识别ep-接入点ID，coding接口可直接填写模型名。

问题2：Claude Code打开一直转圈、弹出海外登录页面

缺失.claude.json放行文件，写入 hasCompletedOnboarding: true 即可跳过境外账号校验。

问题3：配置保存后模型不生效

修改配置后完全重启VS Code/终端，缓存不会自动刷新；Cline编辑器配置优先级高于全局Claude配置文件。

问题4：产生额外扣费

火山方舟禁止使用通用推理接口调用代码模型，必须使用Coding Plan专属coding接口。

六、阶段学习总结与心得

  1. 1. 知识层面：完整理解MaaS模型即服务模式，区分OpenAI兼容、Anthropic两套主流API协议，吃透API Key、上下文窗口、专属接口等核心实操概念；
  2. 2. 实操层面：掌握两套主流AI编程工具（Cline可视化插件、Claude Code终端全局工具），同时吃透智谱、火山方舟两大国内大模型平台完整部署流程；
  3. 3. 拓展思考：课程提供的智谱方案也有coding plan，而火山方舟Coding Plan搭配DeepSeek-V4也适合真实项目开发，两套配置逻辑相通，学会一套即可快速迁移到其他国产大模型平台；
  4. 4. 实操感悟：AI工具配置核心是区分接口路由，不同套餐、不同协议对应独立地址，混用极易出现鉴权、404、计费异常问题，部署前务必查阅平台官方coding专属文档。

文末实操提示

  1. 1. 配置复用：文中所有JSON配置可直接复制，仅替换对应平台的API Key即可一键部署；
  2. 2. 模型切换：火山方舟方案中，Flash适合日常快速编码，Pro适合大型项目重构，仅需修改Model ID字段，其余参数无需改动。