← Back to learning path
Chapter · Published

Complete your first task with Codex

A hands-on first task for the ChatGPT desktop app: choose a workspace, write a request, inspect the result, and verify the change.

Source: start/06-first-task.md快速上手 (original language)
Chapter progress 0%Learning path progress 0% · 0/46 chapters completedContinue learning path →

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.

Create a local workspace folder

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.

Project creation dialog

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

Choose a local folder

Confirm the project folder

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.

Enter a task

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

Review the result

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.

Preview the generated page

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.

Continue the task

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.

Keep the task focused

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.

Further reading

KnowledgeAI Agents: From Core Concepts to ProductionKnowledgeStructured Outputs and Tool Contracts for Safe AgentsKnowledgeAI Coding Workflows: From Completion to Reviewable Delivery
Product Hub Demo · V0.3