Tip · Last checked
Official sources were last checked on 2026-10-12. For current project, chat, folder, permission, and task entry points, use ChatGPT desktop app, Projects and chats, Settings, and Agent approvals and security. The interface may change; follow the client you are using.
Complete your first task with Codex
This chapter uses a small web page about the history of AI as an example. You will complete one task loop in the ChatGPT desktop app and build a safe habit for using Codex.
Step 1: Create a local workspace folder
Create an empty folder for the Codex workspace. Files generated by Codex will be saved there.
Warning
Prefer a path without non-ASCII characters when possible. Some tools and scripts have better compatibility with simple paths.

Step 2: Choose a workspace and chat mode
Open the ChatGPT desktop app, switch to Codex, and create a chat, create a project, or open a local folder.
- Regular chat or Quick chat: for a focused task that can finish in one pass.
- Local project: connects one or more folders on your computer. Chats in the project can access the same files while keeping separate histories.
- ChatGPT project: groups chats, uploaded files, project instructions, and connected sources. It is not the same thing as a local workspace and does not automatically access local folders.
Prefer a local project when a task will take time, produce several results, or use the same files from more than one chat. A short one-off task can use a new chat.
Step 3: Add the workspace folder
After choosing a project, click the + button next to it to open the project creation dialog.

Choose Add a folder on this computer, then select the folder from step one.


When the project is ready, the current workspace appears in the lower-left corner of the dialog. Verify the path before entering a task.
Step 4: Describe the task and run it
Enter a concrete request in the chat and send it. Ask for the target, constraints, and verification steps when the change has risk.

When the task finishes, Codex shows the result and writes generated files into the workspace.

For a generated web page, use the file preview or open it in a browser. The exact entry point depends on the current client and permissions.

Step 5: Iterate in the same workspace
If the result needs changes, describe the next adjustment in the same chat. Codex can use the files and context that already exist in the workspace.

Info · What is the context window?
The context window limits how much conversation, file content, and tool output can be handled in one task. For independent goals, a new chat in the same project keeps access to the workspace without inheriting the entire history.

When using a regular chat rather than a project, a new conversation may need the workspace to be selected again. Projects make it easier to keep related work together.
Next step
Next: Task design.
