This guide assumes you've never used Codex before and you're not a developer. You just want to type a sentence and get a video. We'll do it together, step by step. Plan for about 15–20 minutes the first time, then under 2 minutes per video after that.
What you'll need before we start
- A Mac or Windows computer (this guide covers both).
- An internet connection.
- A Golpo account with API access enabled. See how to get Golpo API access for plan options and how to enable API on your account.
- An OpenAI account (a free ChatGPT account works fine).
That's it. No coding experience required.
Step 1 — Download and install Codex
Codex is OpenAI's coding assistant. We're going to use it to talk to Golpo.
On a Mac
- Open Safari or your usual browser.
- Go to chatgpt.com/codex.
- Click the Download for macOS button.
- A file called something like Codex.dmg will download.
- Open your Downloads folder, double-click the .dmg file.
- A window opens showing the Codex icon. Drag the Codex icon into the Applications folder shown in the same window.
- Open your Applications folder, find Codex, and double-click it.
- The first time you open it, Mac will ask: "Codex was downloaded from the Internet. Are you sure you want to open it?" Click Open.
On Windows
- Open your browser.
- Go to chatgpt.com/codex.
- Click the Download for Windows button.
- Open the file that downloaded (usually Codex-Setup.exe).
- Windows may say "Windows protected your PC." Click More info, then Run anyway.
- Follow the installer (just click Next through the defaults).
- When done, find Codex in your Start menu and open it.
✅ What you should see: The Codex app opens. You'll see a sign-in screen.
Step 2 — Sign in to Codex
- Click Sign in with OpenAI.
- Your browser opens. Sign in with your ChatGPT account (the email and password you use for chatgpt.com). If you don't have one, sign up at chatgpt.com first — it's free.
- After signing in, you'll see a "Codex authorized successfully" message. Close the browser tab.
- Switch back to the Codex app. You should now see the main Codex window with a chat prompt at the bottom.
✅ What you should see: A window that looks like a chat — there's a big text box at the bottom where you can type things, and the rest of the window is mostly empty (because you haven't started yet).
Step 3 — Get your Golpo API key
The plugin needs to know who you are when it talks to Golpo. That "ID badge" is called an API key.
Before you grab a key, make sure your Golpo account has API access enabled. The fastest path is the full walkthrough at How to Get Golpo API Access — it covers plan options, how to turn API access on, and where the key lives. Once that's set up, come back here.
Then, in your Golpo dashboard:
- Sign in at video.golpoai.com.
- Open your account menu (top right with your initials or photo).
- Find the API or API Keys section (usually under Settings → API).
- Click Create API Key (or Generate New Key).
- A long string appears, starting with letters and numbers. It looks like:
sk-golpo-1234abcd5678efgh...
- Copy this entire string. (Click the copy button next to it, or select and ⌘C / Ctrl+C.)
- Paste it into a safe place temporarily — open the Notes app or a sticky note. You'll need it in a minute.
⚠️ Important: Treat this key like a password. Don't paste it into chats, emails, or share it with anyone. Anyone who has the key can use your Golpo account.
✅ What you should see: A long alphanumeric key copied somewhere safe, and API access enabled on your Golpo account.
Step 4 — Open a terminal (just briefly)
Now we need to tell Codex about the Golpo plugin. We do this once, with one command.
On a Mac
- Press ⌘ + Space to open Spotlight.
- Type Terminal and press Enter.
- A small window opens with a blinking cursor. That's the terminal. You can type into it.
On Windows
- Press the Windows key.
- Type PowerShell and press Enter.
- A blue window opens with a blinking cursor. That's PowerShell. It works like the Mac terminal for our purposes.
✅ What you should see: A black or blue window with a blinking cursor. Don't be intimidated — we're only going to type 2 commands in here, total.
Step 5 — Add the Golpo marketplace
In the terminal, copy and paste this exact line, then press Enter:
codex plugin marketplace add Golpo-AI/golpo-claude-skill
(On Mac: ⌘C to copy, ⌘V to paste. On Windows: Ctrl+C / Ctrl+V.)
✅ What you should see: After a few seconds, a message like:
Added marketplace `GolpoSkill` from https://github.com/Golpo-AI/golpo-claude-skill.git
⚠️ If you see an error:
- codex: command not found — Codex isn't installed yet, or your terminal can't find it. Try closing and reopening the terminal. If that doesn't help, reinstall Codex from Step 1.
- could not resolve host github.com — Your internet is down or behind a strict firewall. Try a different network.
- unknown variant ON_FIRST_USE — You're getting an older cached version. Try codex plugin marketplace upgrade to refresh, then retry. If still broken, run codex plugin marketplace remove GolpoSkill first, then re-add.
Step 6 — Install the plugin
Still in the terminal, paste this and press Enter:
codex plugin add golpo@GolpoSkill
✅ What you should see: A message like:
Added plugin `golpo` from marketplace `GolpoSkill`.
Installed plugin root: /Users/yourname/.codex/plugins/cache/GolpoSkill/golpo/0.2.1
The plugin is now installed. You can close the terminal — we won't need it again.
Step 7 — Make your first video
- Open the Codex app (still running from Step 2, or reopen it).
- Click New conversation (or open a new thread — usually a + button somewhere visible).
- In the text box at the bottom, type:
Make a 15-second video about why the ocean is salty.
Press Enter (or click the send button).
What happens next
Codex will respond, doing things one at a time. You'll see it:
- Recognize the plugin — it'll mention "Golpo" or just start running.
- Check the environment — runs a quick test to make sure everything is set up.
- Ask for your API key (first time only) — it'll say something like: "I need your Golpo API key. Please paste it here." Paste the key you saved in Step 3 and press Enter.
- Submit the video job — you'll see JOB_ID=abc123....
- Stream progress — every few seconds:
progress=10% status=generating
progress=35% status=generating
progress=60% status=generating
progress=90% status=generating
- Download the finished video automatically to your computer.
- Show you the result — two clickable things:
VIDEO_FILE=/Users/yourname/Golpo/videos/20260603-130522_why-is-the-ocean-salty_a1b2c3d4.mp4
VIDEO_URL=https://...mp4
⚠️ How long does it take? A 15-second video takes about 1–2 minutes to generate. Longer videos take longer. While it's running, you can do other things — just don't close Codex.
✅ Success check: You see VIDEO_FILE=... and VIDEO_URL=.... Both should point to a video file. Click the local file path — it should open in your video player (QuickTime on Mac, Movies & TV on Windows).
Step 8 — Find your video on your computer
By default, every video you make is saved here:
- Mac: /Users/yourname/Golpo/videos/ (Open Finder, press ⌘+Shift+G, type ~/Golpo/videos/, press Enter)
- Windows: C:\Users\yourname\Golpo\videos\ (Open File Explorer, paste %USERPROFILE%\Golpo\videos in the address bar)
You'll see files named like:
20260603-130522_why-is-the-ocean-salty_a1b2c3d4.mp4
The format is: date-time_topic_uniqueID.mp4. Most recent files are at the bottom (or sortable by date). Double-click to play.
Step 9 — Try variations to get comfortable
Now that it works, try changing things to see how it responds. In Codex, type any of these:
- "Make it a vertical short instead." — Same topic, 9:16 format for phones.
- "Try a male voice." — Same video, different narrator.
- "Translate it to Spanish." — Same video, Spanish narration.
- "Make it 1 minute long." — Longer video.
- "Use a more colorful style." — Switches to Golpo Canvas style.
- "Add background music." — Adds music behind the narration.
- "Save the next one to my Desktop." — Changes save location.
You don't need to remember command syntax — just describe what you want in plain English.
Step 10 — Make a video from your own content
The plugin can also work with files you have:
From a PDF
- Drag a PDF onto the Codex window (or note its path, like ~/Documents/report.pdf).
- Type:
Summarize this PDF as a 1-minute video: ~/Documents/report.pdf
Codex uploads it to Golpo, then generates the video.
From your own narration audio
- Have an MP3 ready (under 15 MB).
- Type:
Use this audio as the narration: ~/Desktop/myvoice.mp3
The video animates around your audio.
From a script you wrote
Make a video using this exact script: "Welcome to our company! Today we're going to talk about..."
Troubleshooting — when things don't work
- Codex doesn't seem to know what Golpo is. Be more specific: "Use the Golpo plugin to make a video about X."
- "API key invalid." Your key is wrong or expired. Go back to video.golpoai.com, make a new one, and tell Codex "My API key changed, please update it."
- requests_ok=false — Codex needs a Python library. It'll tell you the exact command — usually pip3 install --user requests. Copy-paste that into your terminal.
- Video never finishes. Long videos can take up to 90 minutes. Be patient. If still stuck, ask Codex "What's the status of the video?"
- "403 Forbidden." Your Golpo plan doesn't include the feature you tried. See How to Get Golpo API Access or check current plan availability at video.golpoai.com.
- "429 Rate limited." You're making videos too fast. Wait a minute and try again. Don't run more than 3 jobs at once.
- Codex feels stuck. Press Ctrl+C in Codex to cancel, then try again with a simpler prompt.
- You hate where videos save. Tell Codex: "Save videos to ~/Desktop instead."
How to check what you've made
Ask Codex any of these:
List my last 10 videos.
Show me my Golpo usage.
Re-download video [paste video ID here].
How to remove Golpo later
If you don't want the plugin anymore:
- Open a terminal (Step 4 again).
- Type:
codex plugin remove golpo@GolpoSkill
Press Enter. Your existing videos in ~/Golpo/videos/ stay on your computer. You can also delete those manually if you want.
To remove the marketplace too:
codex plugin marketplace remove GolpoSkill
Quick reference card
Save this for later:
INSTALL ONCE:
codex plugin marketplace add Golpo-AI/golpo-claude-skill
codex plugin add golpo@GolpoSkill
USE (in Codex chat):
Make a 30-second video about [topic].
FIND VIDEOS:
Mac: ~/Golpo/videos/
Windows: C:\Users\you\Golpo\videos\
UPGRADE THE PLUGIN:
codex plugin marketplace upgrade
REMOVE THE PLUGIN:
codex plugin remove golpo@GolpoSkill
What's next
Once you're comfortable, try:
- Long-form content — paste a 500-word script and let Golpo voice it.
- Multilingual — make the same video in 5 languages by changing one word.
- Branded videos — Codex can add your logo to videos.
- PDFs to explainers — turn research papers, reports, even legal docs into watchable summaries. See How to Convert a PDF into an AI Explainer Video.
Everything you can do via the CLI helper (golpo.py generate --flag value), you can also do by just asking Codex in plain English. The plugin handles the translation for you.
Need help?
- Plugin issues: open an issue at github.com/Golpo-AI/golpo-claude-skill/issues.
- Golpo account or billing: support at video.golpoai.com.
- Codex itself: OpenAI Help Center.
- Want to talk to us? Book a 15-minute call.
Further Reading
- How to Get Golpo API Access — plan options, enabling API on your account, and where to find your key.
- The Golpo Claude Code Skill — same idea, but for Claude Code instead of Codex.
- The Golpo MCP Server — the broader plugin that works across Cursor, Claude Code, VS Code, and Codex.
- Golpo Prompt Cheatsheet — copy-paste prompts for the most common video styles.
- Golpo Video API Payload Examples — for when you outgrow plain-English prompts and want to script directly.
Have fun making videos. The first one feels like magic — every one after that is just one sentence away.



