> ## 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 工作坊 Windows 设置

> 创建或确认你的 ChatGPT 账号，在 Windows 上安装 Codex app，并在克隆仓库前完成登录。

<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">需要帮助？</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>在 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>提交 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/zh-Hans/SUPPORT.md" target="_blank" rel="noreferrer">
      <Icon icon="life-ring" size={14} />

      <span>支持指南</span>
    </a>
  </div>
</div>

这条设置路线面向想先把 Codex 作为桌面编码智能体跑起来、再连接 GitHub
Desktop 和克隆 handbook 的 Windows 用户。

## 创建或确认你的 ChatGPT 账号

1. 打开 [ChatGPT pricing](https://chatgpt.com/pricing) 或你的 ChatGPT 账
   号设置，确认你使用的方案包含 Codex。
2. 创建或登录你要在工作坊中使用的 ChatGPT 账号。

<Note>
  目前 OpenAI 的帮助文档把 ChatGPT 登录描述为 Codex app 的标准起点。
</Note>

## 安装 Codex App

1. 打开 [Codex app 文档](https://developers.openai.com/codex/app)，下载
   Windows 版本。
2. 安装并打开 Codex。
3. 使用你的 ChatGPT 账号登录。

## 选择本地项目父目录

先选一个用于存放 handbook clone 的父目录，例如：

```text theme={null}
C:\Users\your-name\Projects
```

等你完成 GitHub Desktop 页面后，再选择具体的 handbook 仓库目录。

## 首次运行检查

* 当你希望 Codex 在自己机器上工作时，保持 `Local` 选中。
* 不要把密码、API key 或 2FA 验证码粘贴进 Codex 消息。
* 如果 Windows 弹出权限请求，先看清楚再批准。

然后继续阅读
[GitHub 与仓库设置](/zh-Hans/workshops/codex/github-and-repository)。