AE Agent
故障排除
大多数问题通常是因为 After Effects 未重启、安装了错误的工具或供应商响应缓慢。以下是常见问题及其解决方法。
面板未出现
安装扩展后，面板仅在启动时加载。请完全退出 After Effects（而不仅仅是关闭项目）并重新打开，然后检查：
Window → Extensions → AE Agent
如果仍然没有显示，请确认您的 After Effects 版本支持 CEP 扩展（CC 2021 或更高版本），且
.zxp 已无错误地安装。如有需要，请使用 ZXP Installer 重新安装。After Effects 未连接（红色圆点）
顶部栏显示一个状态圆点。绿色 表示 AE Agent 已连接到 After Effects；红色 表示未连接。红色圆点几乎总是意味着 After Effects 未打开或尚未完全准备就绪 —— 请确保 AE 正在运行且已打开项目，如果圆点没有变为绿色，请重启面板。
未检测到 CLI（订阅用户）
如果 AE Agent 无法找到您的订阅 CLI，最常见的原因是 已安装桌面应用但未安装 CLI。
桌面应用 ≠ CLI。 Claude / ChatGPT 桌面应用并非命令行工具。请通过
npm 安装实际的 CLI（例如 npm install -g @anthropic-ai/claude-code），通过浏览器 OAuth 流程登录一次，然后重新打开模型选择器。请参阅 连接提供商 以获取完整的安装步骤。
模型响应超时
CLI 订阅的响应速度慢于直接 API 调用，尤其是在执行长且多步骤的 Agent 任务时使用 Gemini 订阅。如果请求超时，请点击 重试，或针对该任务切换到 API 密钥模型 —— 对于繁重的 Agent 工作，API 密钥通常是最快的方式。
重新加载后模型消失
之前在重新加载面板后，检测到的本地模型或订阅模型有时会消失。此问题已在最新版本中修复。请更新扩展，如果列表仍然为空，请点击模型选择器中的 重新检测 以重新检测。
许可证问题
如果许可证无法验证，请确认密钥输入完全正确（无多余空格）、方案处于激活状态，且未超过设备数量限制。您可以在 synthetic.com.ar/dashboard/licenses 查看并管理密钥。详情请参阅 激活您的许可证。