1. GitHub 直连超时#

问题：Failed to connect to github.com port 447 after 75013 ms

排查：

• git config --global --get http.proxy → 无代理配置
• 测试常见端口（7890, 1080, 7891, 8080, 20170）→ 均未监听

解决：

• 检测发现端口 7897 开放（用户启动了代理软件）
• 配置代理：git config --global http.proxy http://127.0.0.1:7897

2. API Key 验证 401#

问题：curl 返回 401，Key 看似无效

排查：

• 第一个 Key 确实过期/复制不完整
• 换了新 Key 后返回 401，但详细响应显示：

  1
  {
  2
    "detail": {
  3
      "status": "missing_permissions",
  4
      "message": "missing permission user_read"
  5
    }
  6
  }

原因：

• ElevenLabs API Key 的 Speech to Text 端点设成了 “No Access”
• /v1/user 端点需要 user_read 权限，但 video-use 实际只需要 Scribe 转录

解决：

• 在 ElevenLabs 后台将 Speech to Text 端点改为 “Access”
• 直接测试 Scribe API 返回 200 → 功能正常
• user_read 权限缺失不影响 video-use 核心功能

3. 安装位置调整#

原始路径：~/Developer/video-use（install.md 推荐）

调整后：~/claudecode/projects/video-use（统一工作区管理）

原因：用户要求所有项目集中在 ~/claudecode/ 下