> ## Documentation Index
> Fetch the complete documentation index at: https://labs.prompthon.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex Workshop Windows Setup

> Create or confirm your ChatGPT account, install the Codex app on Windows, and sign in before cloning a repository.

<div className="not-prose my-4 rounded-md border border-gray-200 bg-gray-50 p-2 text-sm dark:border-gray-800 dark:bg-gray-900/40">
  <div className="mb-2 px-1 text-xs font-semibold uppercase tracking-wide text-gray-500 dark:text-gray-400">Need help?</div>

  <div className="flex flex-wrap gap-2">
    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://discord.gg/sDE2HhGTg4" target="_blank" rel="noreferrer">
      <Icon icon="discord" iconType="brands" size={14} />

      <span>Ask in Discord</span>
    </a>

    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://github.com/Prompthon-IO/agent-systems-handbook/issues/new/choose" target="_blank" rel="noreferrer">
      <Icon icon="github" iconType="brands" size={14} />

      <span>Open a GitHub issue</span>
    </a>

    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/SUPPORT.md" target="_blank" rel="noreferrer">
      <Icon icon="life-ring" size={14} />

      <span>Support guide</span>
    </a>
  </div>
</div>

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

## Create Or Confirm Your ChatGPT Account

1. Open [ChatGPT pricing](https://chatgpt.com/pricing) or your ChatGPT account
   settings and confirm you have a plan that includes Codex.
2. Create or sign in to the ChatGPT account you want to use during the
   workshop.

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

## Install The Codex App

1. Open the [Codex app docs](https://developers.openai.com/codex/app) and
   download the Windows build.
2. Install the app and open Codex.
3. Sign in with your ChatGPT account.

## Choose A Local Projects Folder

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

```text theme={null}
C:\Users\your-name\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.
* If Windows prompts for permissions, review the request before approving it.

Then continue to
[GitHub And Repository Setup](/workshops/codex/github-and-repository).
