🗺️一、Claude Code 形态全景

Claude Code 并非单一工具，而是一个覆盖终端、桌面、IDE 和浏览器的工具家族。理解它们的差异，是正确选择工作流的前提。

🖥️ CLI 终端版
原生命令行工具，Claude Code 的完整形态。支持所有 CLI 参数、headless 模式、多会话并行，可通过 screen / tmux 后台长期运行。
最佳场景：自动化脚本、CI/CD、服务器运维、批量任务
🖼️ Desktop 桌面客户端
官方 GUI 封装，在 CLI 基础上增加可视化面板（文件树、计划侧边栏、预览窗格）。支持 Side Chat 旁路对话，但关闭窗口即停止任务。
最佳场景：非终端用户、架构探索、需要可视化监督的复杂任务
🔌 VS Code 扩展
将 Claude Code 会话嵌入编辑器，保留代码上下文。功能更新通常滞后于 CLI，且缺少完整的 flag 控制和脚本能力。
最佳场景：轻度编辑、单文件修改、习惯 VS Code 快捷键生态
🌐 Web IDE (claude.ai/code)
浏览器端 IDE，无需安装。适合临时使用或受限环境，但依赖网络稳定性，无法处理本地文件系统（除非配合挂载）。
最佳场景：临时任务、跨设备快速接入、演示教学
💡 核心结论

四种形态共享同一底层引擎（Claude Opus/Sonnet），但交互载体决定了能力边界。对于需要后台长时间运行、自动化编排的任务（如视频渲染），CLI 是唯一可行形态；对于日常探索和轻量编辑，Desktop 或 Web IDE 体验更友好。

形态能力矩阵

能力维度 CLI Desktop VS Code 扩展 Web IDE
Headless / 自动化 原生支持 不支持 不支持 不支持
多 Agent 并行 screen/tmux 单会话 单会话 单会话
完整 CLI 参数 全部 部分隐藏 极少 无
可视化计划面板 无 原生 依赖 IDE 原生
实时预览窗格 无 内置 需插件 内置
后台长时间运行 守护会话 关闭即停 关闭即停 断网即停
本地文件系统访问 完整 完整 完整 受限
MCP 支持 原生 原生 有限 有限

⚔️二、Claude Code vs Cursor

2026 年 AI 编程工具的两大巨头。它们不是同一类产品的不同品牌，而是两种完全不同的工作哲学。

2.1 设计哲学差异

Claude Code 是 Agent-first（智能体优先）：你描述目标，AI 自主分解步骤、读取代码库、编辑文件、运行测试、提交 Git，你负责监督和验收。它更像雇佣了一位高级架构师，你下达指令，他独立完成任务。

Cursor 是 IDE-first（编辑器优先）：你在熟悉的 VS Code 界面中编写代码，AI 提供 Tab 补全、内联编辑、侧边聊天、Composer 多文件修改。它更像一位结对编程伙伴，你主导，AI 辅助。

⚠️ 重要澄清

Cursor 虽然底层可以调用 Claude 模型（Opus/Sonnet），但Cursor 的 Agent 不是 Claude Code。Cursor 的 Agent 模式、Composer、Tab 补全都是自研架构，只是使用了 Anthropic 的模型 API。二者的工具调用逻辑、上下文压缩策略、规划循环机制完全不同。

2.2 规格对比矩阵（2026.05 数据）

维度 Claude Code Cursor
主要界面 终端 / CLI（Desktop/Web 为辅） VS Code 分支（GUI 为主，2026.01 新增 CLI）
上下文窗口 200K 标准 / 1M Max/企业版 ~272K 实用上限（依模型而异）
模型支持 仅 Claude 系列（Opus/Sonnet/Haiku） 33+ 模型（Claude/GPT/Gemini/Cursor 自研）
Agent 自主性 高 — 完整多步自主循环 中-高 — Composer/Agent 模式需人工确认 diff
Tab 补全 无 Supermaven 引擎，毫秒级
Token 效率 比 Cursor 高 5.5 倍（同任务） 消耗更多 Token（视觉 diff、索引开销）
CI/CD 集成 原生（GitHub Actions / Headless） BugBot PR 审查（$40/人/月）
MCP 支持 原生、深度集成 部分支持
定价（Pro） $20/月（Claude Pro 含 Code） $20/月
定价（Max/Ultra） $100–$200/月 $200/月（Ultra）
SWE-bench 得分 72.5% 约 65–68%
开发者满意度 46%（2026 调查第一） 19%
后台运行 screen/tmux 守护 关闭即停（CLI 版有限支持）
多模型切换 仅 Claude 会话内随时切换

2.3 场景选择建议

🎯 选 Claude Code
  • 跨 20+ 文件的大规模重构
  • 需要理解完整依赖图的复杂后端逻辑
  • 自动化流水线 / CI/CD 集成
  • 远程服务器 / Docker / SSH 环境开发
  • 长时间后台任务（视频渲染、数据分析）
  • 通过 MCP 连接内部工具链（数据库、K8s）
🎯 选 Cursor
  • 日常编码流中的 Tab 补全与快速编辑
  • 前端开发（需要实时视觉反馈）
  • 快速原型与绿场开发（Greenfield）
  • 需要多模型 A/B 测试（Claude vs GPT vs Gemini）
  • 团队已标准化 VS Code 生态
  • 偏好可视化 diff 与逐行确认
🏆 高阶策略：双持方案

2026 年专业开发者的主流实践是双订阅（$40/月）：用 Claude Code 担任"高级架构师"处理重构、架构设计与自动化；用 Cursor 担任"结对编程伙伴"处理日常编辑、补全与前端微调。二者互补，而非替代。

🇨🇳三、国内用户配置指南

Claude Code 官方服务对国内网络环境存在限制（OAuth 登录阻断、API 区域限制）。本章节提供无需官方账号、直接通过第三方中转 API 使用的完整方案。

3.1 绕过官方登录的原理

Claude Code CLI 原生支持通过环境变量替换 API 端点。当设置了 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 后，程序会认为你在使用"企业代理"或"兼容端点"，不再强制弹出官方 OAuth 登录窗口。

🔑 关键变量
  • ANTHROPIC_BASE_URL：第三方中转商的 API 基础地址（必须以 /v1 或兼容路径结尾）
  • ANTHROPIC_AUTH_TOKEN：中转商提供的 API Key（通常以 sk- 开头）
  • ANTHROPIC_MODEL（可选）：强制指定模型名称，避免 Claude Code 请求中转商不认识的官方模型 ID

3.2 各平台配置方法

macOS / Linux 终端（推荐）

bash临时环境变量（当前会话）
export ANTHROPIC_BASE_URL="https://你的中转商地址"
export ANTHROPIC_AUTH_TOKEN="sk-你的第三方APIKey"
export ANTHROPIC_MODEL="claude-sonnet-4.6"  # 根据中转商文档调整

# 直接启动，无需登录
claude
bash持久化配置（写入 ~/.zshrc 或 ~/.bashrc）
echo 'export ANTHROPIC_BASE_URL="https://你的中转商地址"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的第三方APIKey"' >> ~/.zshrc
source ~/.zshrc

Windows PowerShell

powershell
$env:ANTHROPIC_BASE_URL="https://你的中转商地址"
$env:ANTHROPIC_AUTH_TOKEN="sk-你的第三方APIKey"
claude

Desktop 客户端（开发者模式）

  1. 完全退出 Desktop（托盘图标 → Quit），确保进程结束
  2. 重新打开，保持未登录状态
  3. 顶部菜单：Help → Troubleshooting → Enable Developer Mode
  4. 重启后出现 Developer 菜单 → Configure third-party inference
  5. 填入 Base URL 和 API Key，点击 Apply locally

3.3 settings.json 配置文件（跨平台通用）

Claude Code 会在用户目录下创建 .claude/settings.json，这是最稳定的配置方式：

json~/.claude/settings.json（macOS/Linux）
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://你的中转商地址",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的第三方APIKey",
    "ANTHROPIC_MODEL": "claude-sonnet-4.6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.6",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6"
  },
  "hasCompletedOnboarding": true
}
jsonC:\Users\<用户名>\.claude\settings.json（Windows）
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "your-api-key",
    "ANTHROPIC_MODEL": "glm-5"
  },
  "hasCompletedOnboarding": true
}
⚠️ 配置后验证

保存配置后，在终端运行 claude，进入对话后输入 /model 查看当前使用的模型。如果显示你配置的模型名称（而非官方默认模型），说明配置生效。

3.4 注意事项与排错

问题原因解决方案
提示 "You are not logged in" Desktop 客户端未正确进入开发者模式 使用 CLI 版，或确保 Developer Mode 已开启并重启
模型不可用 / 区域限制 中转商未正确映射 Claude 模型，或 IP 被识别 更换支持 Claude 协议的中转商；检查 ANTHROPIC_MODEL 名称是否匹配
高级功能缺失（prompt caching、extended thinking） 廉价中转商仅做了基础 /v1/messages 转发 选择支持完整 Anthropic Messages API 的中转商（如 TokenMix、魔芋、ClawSocket）
渲染中途 API 超时 视频渲染耗时 10 分钟~数小时，长连接不稳定 使用 screen 或 tmux 保持会话；选择 SLA 较高的中转商
无法执行 shell 命令 权限模式设置过于严格 启动时加 --permission-mode unrestricted 或在设置中调整

📚四、核心概念词典

AI 工具链中高频出现的概念，按从底层协议到上层界面的层级梳理。配合 ComfyUI 节点系统类比，便于教程讲解。

4.1 CLI / GUI / IDE

💻 CLI（Command Line Interface）

一句话：纯文字输入输出的操作方式，没有按钮和鼠标。

类比：给机器人发文字短信——指令必须精确，机器人逐条执行后文字回复。

例子：python main.py --listen 0.0.0.0、ffmpeg -i input.mp4 output.mp4

🖱️ GUI（Graphical User Interface）

一句话：用鼠标、按钮、拖拽、可视化元素操作软件。

类比：面对面用手指菜单——指着说"我要这个"，对方立刻明白。

例子：ComfyUI 节点拖拽、Cursor 编辑器界面、Desktop 客户端

🛠️ IDE（Integrated Development Environment）

一句话：程序员的专业厨房——写代码、调试、运行、Git 全整合。

关系：IDE ⊂ GUI。所有 IDE 都有 GUI，但不是所有 GUI 都是 IDE。

例子：VS Code、Cursor、PyCharm、JetBrains 系列

4.2 API / SDK

🔌 API（Application Programming Interface）

一句话：两个软件系统之间打电话的规范。

类比：餐厅服务员——你点菜（Request），厨房做菜（Server），服务员上菜（Response）。

例子：调用 Kling 3.0 视频生成 API、RunningHub 无限画布 API、ComfyUI /prompt 端点

📦 SDK（Software Development Kit）

一句话：API 的"精装便利包"。

类比：API 是食谱，SDK 是预制菜包——微波炉叮 3 分钟搞定。

例子：OpenAI Python SDK、Remotion Node.js SDK、Anthropic TypeScript SDK

💡 API vs SDK 核心区别

API 是远程通信协议（跨网络、跨语言）；SDK 是本地代码库（封装了 API，让你少写样板代码）。没有 SDK 时，你需要用 requests 手动拼 HTTP 报文；有了 SDK，直接 client.chat.completions.create(...)。

4.3 MCP（Model Context Protocol）

一句话：Anthropic 提出的 "USB-C 接口标准"，让大模型能统一插拔各种外部工具（文件系统、数据库、浏览器、GitHub）。

类比：以前每个电器插头形状不同（三角、圆、扁），MCP 强制大家都改成 USB-C——只要支持这个口，任何 AI 都能直接插上用。

ComfyUI 类比：ComfyUI 的节点系统也是一种"协议"——只要按规范写节点，任何模型/功能都能接入工作流。MCP 就是大模型世界的 ComfyUI 节点接口标准。

mermaidMCP 架构示意
┌─────────────┐         ┌─────────────┐         ┌─────────────┐
│   Claude    │◄───────►│  MCP Host   │◄───────►│ MCP Server  │
│   Code      │  协议   │  (Claude)   │  stdio  │ (文件系统)   │
└─────────────┘         └─────────────┘         └─────────────┘
                               │
                               ▼
                        ┌─────────────┐
                        │ MCP Server  │
                        │  (浏览器)    │
                        └─────────────┘

4.4 Agent / Plugin

🤖 Agent（智能体）

一句话：能自主规划并执行多步任务的 AI。你说目标，它自己分解、调用工具、纠错直到完成。

类比：API 是每次亲自打电话叫外卖；Agent 是雇了管家——你说"今晚请朋友吃饭"，管家自己订餐厅、查路线、叫车。

例子：Claude Code（终端 Agent）、Cursor Composer、Manus

🔌 Plugin / Extension（插件/扩展）

一句话：给主软件加装外挂的能力，不改变主程序，但能扩展功能。

类比：汽车原厂没有行车记录仪，你自己装一个——即插即用，不影响发动机。

例子：ComfyUI 自定义节点、VS Code 扩展、Claude Code MCP Server

🔗 MCP 与 Plugin 的关系

MCP 是一种特定类型的插件协议标准；Plugin 是更宽泛的说法。就像"USB-C 设备"是插件的一种，但插件也可以是蓝牙、Wi-Fi 等其他形式。

4.5 层级关系总图

text从底层协议到上层界面
┌─────────────────────────────────────────┐  用户看到的界面层
│  GUI (ComfyUI节点) / IDE (Cursor/VSCode)│  ← 鼠标、按钮、拖拽
├─────────────────────────────────────────┤
│  CLI (claude, ffmpeg, python main.py)   │  ← 键盘输入命令
├─────────────────────────────────────────┤
│  SDK (OpenAI Python包, Remotion npm包)   │  ← 程序员调用的代码库
├─────────────────────────────────────────┤
│  API (HTTP接口, RESTful)                │  ← 系统间通信规范
├─────────────────────────────────────────┤
│  MCP (Model Context Protocol)            │  ← AI 专属扩展协议
├─────────────────────────────────────────┤
│  Agent (Claude Code, Cursor Composer)   │  ← 自主决策执行
└─────────────────────────────────────────┘

关系对照速查表

概念本质使用层级一句话区分
CLI交互方式终端/命令行纯文字，键盘操作
GUI交互方式鼠标/可视化界面有按钮能点，所见即所得
IDE软件类型代码开发场景程序员的专用 GUI
API通信协议代码里发网络请求软件 A 呼叫软件 B 的"电话规范"
SDK代码工具包项目依赖/引入库API 的精装便利包，省手写代码
MCPAI 扩展协议给大模型接外部工具AI 世界的"USB-C 统一接口"
AgentAI 应用形态自动执行复杂任务能自己分解步骤、调工具的 AI
Plugin功能扩展方式安装附加组件给主程序打外挂

🎬五、AI 视频剪辑实战

结合 Remotion / FFmpeg 的自动化视频剪辑流水线，解释为什么必须用 CLI + 第三方 API，以及完整工作流设计。

5.1 为什么视频渲染必须用 CLI

卡点对视频任务的影响
关闭即停 视频渲染动辄 10 分钟~几小时，Desktop 窗口误关或电脑休眠 = 任务中断，前功尽弃
单会话限制 无法同时跑多个渲染队列（如批量生成 10 条切片视频），只能排队等待
无 Headless 能力 无法接入自动化流程（如 ComfyUI 输出图片后自动触发剪辑合成）
网络波动 Web IDE 断网即停，不适合长时间后台任务
⛔ 错误示范

在 Desktop 客户端里让 Claude Code "帮我渲染这 50 张图成视频"，然后合上笔记本去睡觉——醒来发现任务在 5 分钟后就停了。

5.2 Remotion + FFmpeg 流水线示例

bashClaude Code 终端指令示例
# 1. 进入项目目录
cd /path/to/remotion-project

# 2. 启动 Claude Code（已配置第三方 API）
claude

# 3. 在 Claude Code 中下达任务：
# "读取 outputs/comfyui/ 目录下今天生成的所有 PNG，
#  按文件名排序，用 Remotion 模板合成 15 秒视频，
#  添加淡入淡出转场，输出到 exports/，
#  然后用 FFmpeg 提取音频波形图作为封面"

# 4. 挂后台（Ctrl+A+D detach）
screen -S video-render
claude
# ... 任务完成后自动退出 ...

5.3 推荐工作流（可落地）

阶段工具做什么
开发/调试 Desktop 或 VS Code 扩展 让 Claude Code 生成 Remotion 组件、调试动画逻辑、预览效果
生产执行 CLI（必用） 通过 screen / tmux 挂后台，跑 npx remotion render 或 FFmpeg 批量剪辑
自动化衔接 CLI（必用） 编写 shell/python 脚本，让 ComfyUI 输出完成后自动触发剪辑 Pipeline
监控/日志 CLI + MCP 通过 MCP Server 连接日志系统，渲染完成后自动发送通知（钉钉/飞书/邮件）
✅ 一句话总结

开发阶段可以随便选形态，但生产级执行层只能落在原生 CLI 上。这不是"能不能用"的问题，是"任务会不会中途断掉"的问题。配合第三方 API，国内用户完全可以搭建完整的自动化视频工作流。

❓六、常见问题 FAQ

Q1：Claude Code 和 Cursor 的 CLI 有什么区别？

Cursor 在 2026 年 1 月新增了 CLI 功能，但它本质上是把 IDE 里的 Agent 能力暴露到终端，依然无法脱离 Cursor 生态独立运行，也不支持 headless 自动化。Claude Code 的 CLI 是原生设计，支持完整的脚本化、CI/CD 集成和后台守护。

Q2：第三方 API 安全吗？我的代码会不会泄露？

风险取决于中转商。建议：① 选择有口碑的中转商（避免来路不明的低价渠道）；② 敏感代码使用本地模型或官方直连；③ 通过环境变量注入密钥，不要硬编码在仓库中。Claude Code 的 CLAUDE.md 可以配置忽略敏感文件。

Q3：Claude Code 能写 ComfyUI 自定义节点吗？

完全可以。Claude Code 的 1M 上下文足以容纳 ComfyUI 核心源码 + 你的节点逻辑。最佳实践：在 CLAUDE.md 中放入 ComfyUI 节点开发规范，Claude Code 即可自动生成符合规范的节点代码、注册逻辑和前端界面。

Q4：Desktop 客户端接了第三方 API，能跑视频渲染吗？

技术上可以，但强烈不建议。Desktop 关闭即停的特性意味着渲染任务随时可能中断。即使接了第三方 API，形态本身的限制没有改变。视频渲染请始终使用 CLI + screen/tmux。

Q5：Claude Code 的 MCP 和 ComfyUI 的节点系统有什么共同点？

二者都是协议化的扩展接口。ComfyUI 节点通过输入/输出类型定义（STRING、IMAGE、LATENT 等）实现任意功能的插拔；MCP 通过 Tools/Resources/Prompts 规范实现 AI 与外部世界的插拔。理解 ComfyUI 节点的开发者，理解 MCP 几乎没有门槛。

Q6：国内网络下，Claude Code 更新会受影响吗？

Claude Code 本身通过 npm 安装（npm install -g @anthropic-ai/claude-code），更新包下载通常不受限。但官方文档和版本发布页面可能需要代理访问。建议关注 GitHub Release 或社区镜像获取更新日志。