Skip to main content
When you finish, you can ask Codex for a video clip, an image, a voiceover, music or a 3D model, and Voyager makes it.
Before you start
  • Codex installed, with a terminal you can type commands into.
  • A Voyager account. If you don’t have one, you can sign up during the steps below.
  • Cost: adding Voyager is free. What you make uses Voyager credits from your workspace; video and 3D need a paid Voyager plan. See Plans and credits.
  • This page is about using Voyager inside Codex. To run the Voyager desktop app on your ChatGPT plan through Codex instead, see Connect ChatGPT.

​
Add Voyager

1

Add Voyager in your terminal

Run these two commands:
The name voyager-cloud keeps this connection apart from anything else named Voyager in Codex.
2

Sign in

A browser window opens. On the Voyager page, choose Continue, then sign in with your Voyager account. If you belong to more than one workspace, choose the one whose plan and credits this connection should use.
3

Check it in Codex

Start Codex and type /mcp. voyager-cloud should be in the list. Then ask for a shot.

​
Check it worked

Ask: What’s my Voyager plan and how many credits do I have? Codex uses Voyager to answer with your workspace, plan and credit balance. Then try something small: Use Voyager to make a 5-second clip of hands pouring coffee in morning light. Video needs a paid Voyager plan; on Free, try an image instead. Voyager can also use a file on your computer as a reference. Name the file in your request, for example use ./photo.jpg as the start frame.

​
If something went wrong

Run codex mcp login voyager-cloud again and finish signing in in the browser window that opens.
Run codex mcp list in your terminal. If it isn’t there, run both commands from Add Voyager again, then restart Codex.
The workspace you chose has a Voyager plan, but no seat for you. Ask one of its admins to add you, then run codex mcp login voyager-cloud again. Or sign in again and choose your personal workspace.
Your workspace’s plan or credits don’t cover it. Owners and admins can upgrade or add credits at voyager.so/dashboard/billing. Then ask again.

​
Next

What Voyager can do in your chat

Everything you can ask for, and what Voyager needs from you.