ArchVibe

A guide from ArchVibe, the software architecture course for people who build apps with AI and cannot code.

Codex for people who can't code: what it is, how to install it, and how it compares to Claude Code

Tamir Magnezi, founder of ArchVibe
Tamir Magnezi · Founder of ArchVibe ·

Codex is OpenAI’s AI builder. You describe what you want in plain language, and it reads the files in a folder on your computer, edits them, runs the commands a developer would run, and shows you what changed. It is the same kind of tool as Claude Code, from the company behind ChatGPT. It comes with every ChatGPT plan, including the free one, which makes it the no-card way to try this way of working. It is not a website builder like Lovable or Base44, and it does not host anything.

What “Codex” means inside ChatGPT

The name confuses people because OpenAI has used it twice. Years ago, Codex was a model that turned English into code, the one under the first GitHub Copilot. Since 2025 it has meant the agent: the thing that acts in your files rather than the thing that suggests a line.

Today it shows up in four places, all tied to one ChatGPT account. The ChatGPT desktop app has two modes, which OpenAI’s docs describe as ChatGPT for “Create, learn, and explore” and Codex for “Build, debug, and ship.” Codex cloud runs in the browser on a copy of your code kept on GitHub or GitLab and hands back changes for you to review. Codex CLI is the terminal version. And the Codex extension sits inside code editors like VS Code and Cursor. For someone who cannot code, the desktop app is the friendly one: a window, a folder, a conversation.

How to install it on a Mac or on Windows

The desktop app needs no terminal, and every step below is from OpenAI’s own pages as of today.

On a Mac:

  1. Download the ChatGPT desktop app from chatgpt.com/download and open it.
  2. Sign in with your ChatGPT account. A free account works.
  3. Open a folder. Pick an empty one on your Desktop.
  4. Switch the mode from ChatGPT to Codex and describe what you want built.

On Windows:

  1. Install the ChatGPT app from the Microsoft Store, or from chatgpt.com/download.
  2. Install Git for Windows from git-scm.com, accepting every default. OpenAI’s docs say Git “powers the review panel” that lets you inspect and undo changes.
  3. Open the app, sign in with your ChatGPT account, open a folder, and switch the mode to Codex.

You do not need WSL, the Linux layer some forum posts mention. The app uses the Windows-native agent by default.

If you would rather have the terminal version, OpenAI gives one line per system. On a Mac, open Terminal and paste curl -fsSL https://chatgpt.com/codex/install.sh | sh. On Windows, open PowerShell and paste powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex". Then type codex while inside your project folder and choose Sign in with ChatGPT. If you want nothing installed, Codex cloud runs in the browser, but it needs your code on GitHub or GitLab first.

What it costs in shape, and what it does not do

Codex is included in the ChatGPT Free plan and in every paid plan. What changes with the plan is how much you can do before you hit a limit. OpenAI meters it in time windows: an allowance per five-hour window, and a weekly one on top, shared between the desktop app and the cloud version and with ChatGPT’s other agent features. On the free plan the allowance is small, and OpenAI describes it as enough to “explore Codex capabilities on quick coding tasks.” When you hit a limit you wait for the reset, upgrade, or on some paid plans add credits. None of this is per-message credits in the Lovable sense: a wasted message is a slice of a window that comes back, not money gone.

One trap: some tutorials have you sign in with an OpenAI API key instead of your ChatGPT account. OpenAI’s docs say that bills your platform account at API rates, separate from any subscription, and some features are unavailable that way. If you paste a key, you have switched from an allowance to a meter.

Codex also does not do the things a browser builder did for you. It does not host your app, and it comes with no database, no login, no preview pane and no Publish button. You run the app on your computer while you build it, and putting it on the internet is a separate service and a separate step.

Codex vs Claude Code: the differences, not a winner

The shape is the same. Both read, edit and run in a folder on your computer. Both take a goal in plain language. Both keep risky actions in check, Codex with a sandbox and Claude Code with a permission mode that can ask before every change. Both have a cloud version, a terminal version and an editor extension. Both makers’ docs point you to Git, the tool that keeps saved versions of your project. The instructions you type are the same words in either one.

CodexClaude Code
Who makes itOpenAIAnthropic
How you get itIncluded in every ChatGPT plan, free includedIncluded in paid Claude plans; no free tier
The desktop appThe ChatGPT desktop app, switched to Codex modeThe Claude desktop app, on its Code tab
How usage is meteredFive-hour windows plus a weekly limit, shared with ChatGPT’s other agent featuresTime windows shared with the Claude chat app
When you hit the limitWait, upgrade, or add credits on some paid plansWait, or switch on usage credits on a paid plan
Paying with an API key insteadBills your OpenAI platform account at API ratesBills the key at usage rates instead of the subscription

For a non-coder, three things decide it. First, free entry: Codex has one and Claude Code does not. Second, each tool comes with its maker’s chat subscription, so most people already own one of them. Third, the models: each runs its maker’s, both change every few weeks, and anyone naming a winner today is describing last month. Pick the one you can open tonight.

You can learn more, and get the full prompts and the decision tables, in our course: Lesson 1, How to Direct Your AI Builder. The first lesson is free, no card, and every prompt in it works in Codex too.

In the next ten minutes, if you pay for ChatGPT or for nothing, install the desktop app, sign in, and point it at an empty folder on your Desktop. If you pay for Claude, install Claude Code instead. Either way, decide on the smallest thing you actually want, and describe what should happen when it works.

Build a real app first, then learn why it breaks

The first lesson of the course is free and ends with an app that runs.

Start the free lesson

No card. No account needed to read it.

Related guides