no Codex credentials provisioned for managed home

Error message

no Codex credentials provisioned for managed home "${input.effectiveCodexHome}" (no usable auth.json, OPENAI_API_KEY is empty, and the sandbox has no Codex login). Use a sandbox image that is signed in to Codex, configure a per-agent OPENAI_API_KEY, or sign in to Codex on the host with a ChatGPT subscription.

What it means

Error "no Codex credentials provisioned for managed home "${input.effectiveCodexHome}" (no usable auth.json, OPENAI_API_KEY is empty, and the sandbox has no Codex login). Use a sandbox image that is signed in to Codex, configure a per-agent OPENAI_API_KEY, or sign in to Codex on the host with a ChatGPT subscription." thrown in paperclipai/paperclip.

Solutions

Use a sandbox image signed in to Codex.
Configure a per-agent OPENAI_API_KEY.
Sign in to Codex on the host with a ChatGPT subscription.

When it happens

Trigger: Thrown at packages/adapters/codex-local/src/server/execute.ts:423 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@3f1d897a7c (2026-08-18). Data as JSON: /api/errors/9318818a44831414. Report an issue: GitHub.

Appendix: source

Thrown at packages/adapters/codex-local/src/server/execute.ts:424

    });
    if (sandboxAuthJson === "present") {
      await input.onLog(
        "stdout",
        `Using the sandbox's own Codex login; managed home "${input.effectiveCodexHome}" has no host credentials.\n`,
      );
      return;
    }
    if (sandboxAuthJson === "unknown") {
      // The probe failing is an operational problem, not evidence that the
      // sandbox lacks a login — proceeding lets a genuinely credentialed
      // sandbox run, and a credential-less one still fails at Codex's first
      // request with the provider's own error.
      await input.onLog(
        "stderr",
        `Could not verify the sandbox's Codex login (probe failed); proceeding. ` +
          `If the sandbox has no credentials, Codex will fail at its first request.\n`,
      );
      return;
    }
    throw new Error(
      `no Codex credentials provisioned for managed home "${input.effectiveCodexHome}" ` +
        `(no usable auth.json, OPENAI_API_KEY is empty, and the sandbox has no Codex login). ` +
        `Use a sandbox image that is signed in to Codex, configure a per-agent OPENAI_API_KEY, ` +
        `or sign in to Codex on the host with a ChatGPT subscription.`,
    );
  }

  throw new Error(
    `no Codex credentials provisioned for managed home "${input.effectiveCodexHome}" ` +
      `(no usable auth.json and OPENAI_API_KEY is empty). ` +
      `Sign in to Codex on the host with a ChatGPT subscription, or configure a per-agent ` +
      `OPENAI_API_KEY.`,
  );
}

async function emitSandboxAuthPrecedenceWarningIfNeeded(input: {

View on GitHub (pinned to 3f1d897a7c)