Skip to main content

​
Agent won’t connect

Claude Code and Codex subscriptions require the Subframe desktop app.
  1. Open Agent chat, click the model name, then select Manage agents
  2. Click Sign in again or Try again for that provider
  3. If the problem continues, hover over the message under that provider to see what went wrong
You can use Subframe AI credits without connecting a subscription.

​
Codebase is unavailable

The connected folder may have moved, been renamed, or be on a drive that is not mounted. Restore the folder at its original path or change the connected folder.

​
A model is missing

Open the model menu and select Check connection or Manage agents. Reconnect the subscription if needed, then open the model menu again. Only the models available through your connected subscription or Subframe plan appear in the menu.

​
A message won’t send

Make sure you have selected an available model. If you attached images, wait for them to finish uploading before sending. If a codebase is connected, select either your subscription or Subframe Credits in the model menu.

​
A connected agent keeps retrying

If Claude Code or Codex keeps retrying, switch to a model under Subframe Credits and send the request again. If the request works with Subframe AI credits, your connected agent session probably needs a refresh. Open Manage agents, then click Sign in again or Try again for that provider.

​
The agent stops partway through a task

If the chat shows Agent reached its step limit, the agent used all the steps it can take in one turn. Send a follow-up message, like “Keep going”, to continue where it left off.

​
You hit your plan’s usage limit

When your Claude or ChatGPT plan reaches its usage limit, the chat shows when the limit resets. To keep going before then:
  • Click Continue with Subframe credits to resend your message using Subframe AI credits
  • Click Get Subframe credits if you have none left
  • Click Upgrade Claude plan or Upgrade ChatGPT plan to raise your plan’s limit

​
You run out of Subframe AI credits

When your Subframe AI credits run out, the chat shows when they reset. To keep going before then:
  • Click Use a subscription to switch to your Claude Code or Codex subscription in the desktop app. If you haven’t connected one, Subframe opens agent settings so you can connect it. Your message stays in the chat box, ready to send.
  • Click Upgrade to Pro on the Free plan, or Add credits on a paid plan, to get more credits

​
Requests fail behind a firewall

If agent requests fail on a restricted network, ask your network admin whether a firewall is blocking access to Subframe or your connected AI provider.
Last modified on October 23, 2026