Codex Workshop Mac Setup - Agent Systems Handbook by Prompthon

Need help?

Ask in Discord Open a GitHub issue Support guide

This setup path is for macOS users who want Codex ready as a desktop coding agent before they connect GitHub Desktop and clone the handbook.

Create Or Confirm Your ChatGPT Account

Open ChatGPT pricing or your ChatGPT account settings and confirm you have a plan that includes Codex.
Create or sign in to the ChatGPT account you want to use during the workshop.

Current OpenAI help docs describe ChatGPT sign-in as the normal starting point for the Codex app.

Install The Codex App

Open the Codex app docs and download the macOS build.
Install the app and open Codex.
Sign in with your ChatGPT account.

Choose A Local Projects Folder

Pick a parent folder where your handbook clone will live, for example:

~/Projects

You will choose the actual handbook repo after you finish the GitHub Desktop page.

First-Run Checks

Keep Local selected when you want Codex working on your own machine.
Do not paste passwords, API keys, or 2FA codes into Codex messages.
Review any permission prompt before approving it.

Then continue to GitHub And Repository Setup.