Codex guide

Get started with Codex: complete your first task with one file

5 min readSkillshop operator and creator of the Maker Evan YouTube channel

Translated from Korean. View original

If you are opening Codex for the first time, start with a short note. Reading a file, organizing it in the format you want and saving the result will help you learn the workflow. This guide prepares a working folder and organizes meeting notes, then compares the result with the original.

Illustration of a person working with documents on a laptop
Start with one small task and open the resulting file. This is an AI-generated illustration.

What can I try without knowing how to code?

Choose a small task whose result you can check, such as extracting action items from meeting notes, finding common points across several texts, or renaming files consistently. Start with one familiar task instead of trying to complete a large report at once.

This guide uses a short note called meeting.txt. The filename is an example; substitute the name you actually prepared. A text file works well for a first exercise because you can inspect it without special conversion tools.

Where do I start in the app?

OpenAI's current documentation describes selecting ChatGPT or Codex in the ChatGPT desktop app. Install the app for your operating system using the official download instructions, sign in and select Codex. If your existing installation looks different, compare it with the official guide below.

This exercise uses a desktop environment with a folder on your computer. You can also work with files using the Codex CLI in a terminal or an editor extension, but where you start and view the results will differ.

Prepare a practice folder

Create a folder on your computer, such as codex-practice, and put a copy of the notes you want to practice with inside. Connect that folder to a local project in the app. A project brings related work and materials together; connecting a local folder lets you work with its files.

A short note without personal information is enough. For example: ‘Prepare a draft event announcement by Friday. Decide who is responsible at the next meeting.’ There is no need to add unrelated folders for this exercise.

Start with: ‘Tell me the current working folder and the names of the files inside it. Do not change any files yet.’ Once you can see the note you added, move on to the next task.

  • codex-practice/Folder for this exercise
  • meeting.txtMeeting note to read
  • output/Where to ask Codex to save the result
Keeping the output separate from the original makes comparison easier. These names are examples.

Try the first request

Example request: ‘Read meeting.txt and organize the decisions and action items separately. Include an owner and due date for each action item. Mark information absent from the note as undecided. Keep the original and save the result as output/meeting-summary.txt.’

This explains which material to use, what to create and where to save it. You do not need to specify the order of file reads or internal commands. Instead, explain how to handle details that would be troublesome to get wrong, such as names or deadlines.

If Codex asks for confirmation, read which file or action it concerns and check that it matches your request. If it unexpectedly needs an external account connection just to organize a document, ask why.

Open the file when the task is complete

Open the result link or find meeting-summary.txt where it was saved. Confirm that the file exists and read it beside the original note. For example, check that ‘decide who is responsible at the next meeting’ was not turned into an action item for a specific person.

If something needs changing, continue in the same task. Identify the mismatch: ‘Keep the deadline wording from the note. Do not turn Friday into an arbitrary date.’

Finally, ask: ‘Tell me the paths of the files you created and anything you could not verify.’ Check both the quality of the summary and that the file was saved correctly.

How do I move on to another task?

You can continue in the same task to change the format of the same note. For a different deliverable, a new task can be easier to find later. Give it a descriptive name such as ‘Organize September event meeting notes.’

After repeating a process a few times, you can turn instructions you keep adding into a skill. There is no need to install several skills and plugins at the outset. Become comfortable reading files and checking results first, then add what you need.

Frequently asked questions

Do I need terminal commands to use Codex?

You can make requests in natural language in the desktop app. This first exercise does not require entering terminal commands yourself. Start by learning which files will be read or changed and how to check the result.

Do I need to install a skill for my first task?

You can try reading and organizing a short text note without a separate skill. If you later need a specific document format or external service, check the available tools and installation requirements.

What if Codex cannot find the file I added?

First ask it to check the current working folder and file names. The file may be in a different folder or have a different name. Also check that the required folder is connected to the local project.

Sources