Troubleshooting

Short answers to keep you moving.

Can’t find Atom after installing?

Restart Premiere, then check Window → Extensions → Atom.
Reinstall the .zxp with ZXP Installer if it’s still missing.
Make sure you’re on Premiere Pro 2025 (v25.0) or newer.

Manual ZXP installation

If ZXP Installer isn’t working, you can install Atom manually:

Rename the .zxp file to .zip and unzip it to get the extension folder.
Copy the folder to your user extensions directory: ~/Library/Application Support/Adobe/CEP/extensions/
Restart Premiere and check Window → Extensions → Atom.

No sign-in email? Check spam, wait a minute, then resend or try another inbox.
Seat limit hit? Open Settings → Account → Deactivate device, then tap Refresh access.

Browser did not open: Click Sign in with OpenAI again, or copy the link if Atom shows one.
Signed in but Atom still asks: Return to the panel and tap Refresh.
Authentication error or missing_required_parameter: This is usually the OpenAI/Codex browser sign-in page failing before Atom receives a result. Try Codex CLI sign-in.
Wrong account: Sign out in Atom settings or your local Codex setup, then sign in with the OpenAI account you want to use.
Team-managed setup: Confirm Codex, Claude Code, or OpenCode works outside Atom, then restart the Adobe app. See Team & Enterprise AI Setup.

Use this when Atom opens the OpenAI sign-in page, but the browser shows an authentication error.

Install Codex globally, then sign in from your terminal:

npm install -g @openai/codex
codex login

Complete the OpenAI sign-in in your browser, then restart the Adobe app and open Atom again.

Atom can install its own private Codex runtime, but that private runtime is not added to your terminal path. Installing Codex globally gives you a normal codex command and lets Codex handle the sign-in outside Atom.

Anthropic issues

Claude Code is stuck on your personal account: Open Settings → Account → AI accounts, click Change Account beside Claude Code, then select your work, Team, or Enterprise plan in Anthropic’s sign-in window. See Switch Claude Code accounts.
Work organization is missing: Confirm your administrator assigned you a Claude Code-enabled seat, then retry Change Account.
Anthropic authentication error: Reopen the Claude Code sign-in from Settings → Account and complete authorization in the browser.

OpenCode issues

OpenCode not found: Install OpenCode, choose OpenCode in Atom, then click Check again.
Models are missing or requests fail: Configure a model provider in OpenCode and confirm it works outside Atom, then restart the Adobe app.
Team-managed setup: Follow your organization’s local OpenCode and provider configuration. See Team & Enterprise AI Setup.

Automations not landing

Read the response cards. Atom explains what it found or why it stopped.
Tighten the scope: name the sequence, clips, tracks, or say “selected clips only”.
Undo, adjust the wording, and rerun in the same chat to build on context.

Feeling slow or stuck

Large sequences, transcript work, and broad media scans take time. Let Atom finish before stacking prompts.
Focus your request to speed things up and keep results tidy.
If requests fail, check that you are signed in and your AI provider account has available credits or an active plan.

File attachment issues

Unsupported file type: Atom supports images, PDFs, documents (Word, Excel, PowerPoint), text files, and audio (WAV, MP3). Video is not currently supported.
File too large: Images max out at 12 MB, audio/PDFs/documents at 10 MB, text files at 1 MB. Compress or trim before attaching.
Attachment not processing: Try a different format. Some exotic image formats may not work. Convert to PNG or JPEG.

Need to report an issue?

- Tap **Share feedback** beneath the conversation. It bundles logs with your note. - Tell us what you asked for, what you saw, and any message in the thread. That's enough to help fast.