文章

容器中首次启动 Claude Code 的三个阻碍与解决方案

2026年7月25日

全新容器中的 Claude Code 不会自动开始工作：它会依次停在新手引导、目录信任确认和 API Key 确认这三个提示前。在无人交互的终端中，这些问题会导致进程无限挂起，必须在启动前将正确配置预写入代理配置文件中。

一个启动后输出横幅然后静止不动的代理依然在产生字节。在日志中，产生字节看起来就像正常运行。在全新容器中，Claude Code 在开始任何实际工作前会停顿三次，每一次都是在向一个空无一人的终端发问。

代理按序遇到的三道关卡

第一道和第三道关卡是机器全局性的。第二道关卡按目录记录。只解决其中一两道关卡只会让代理前进相应步数，依然无法真正开始工作。

实测对比矩阵

下表每行数据均基于 claude 2.1.220 在真实 pty 和全新 HOME 目录下实测得出：

目录信任路径中的解析陷阱

信任记录保存在 ~/.claude.json 的 projects[path] 下，且路径必须为符号链接解析后的真实路径。在 macOS 上 mkdtempSync 返回 /var/folders/…，而真实路径为 /private/var/folders/…。写入未解析的路径会导致配置失效，提示框依然弹出。

export function trustKeyFor(root: string): string {
  try {
    return realpathSync(root);
  } catch {
    return root;
  }
}

密钥确认中的暗坑

API Key 确认提示最容易出错，因为其默认选项是 2. No (recommended)。CLI 记录的并不是完整密钥，而是密钥后 20 个字符的批准令牌。

export function approvalTokenFor(apiKey: string): string {
  return apiKey.slice(-20);
}

两条无效的捷径

命令行参数 --permission-mode bypassPermissions 无法跳过目录信任对话框，它只影响工具执行权限。预置未解析路径同样无效。

主题只是外观偏好，删除文件则是严肃决策。

预置配置消除了环境启动的冗余交互，但绝不能破坏关键的安全判断。我们不会跳过敏感工具调用时的必要确认。

const trust: ProjectTrust = {
  hasTrustDialogAccepted: true,
  hasCompletedProjectOnboarding: true,
  projectOnboardingSeenCount: 0,
  allowedTools: [],
};

关于云端运行环境的解析请参阅 在云端运行 Claude Code，连接控制细节请参阅 观察不属于你的终端。

直接回答