Making Code Changes

Now that you know what Codex is and how it fits into your workflow, let's focus on the basics of making code changes using natural language prompts. This lesson will guide you through the process step by step, with clear formatting and practical advice.

Codex is powered by a specialized AI model that reads your instructions in plain English and analyzes your codebase to generate suggestions. When you type a prompt, Codex scans the relevant files, understands the structure and logic of your code, and proposes a change. You always see a preview before anything is applied, so you remain in control.

Codex can work with a wide range of programming languages and file types. It's designed to help with everyday development tasks, from small edits to more involved refactoring. However, its effectiveness depends on the clarity of your instructions and the complexity of the task.

Codex is a powerful assistant, but it has its strengths and limitations.

What Codex Can Do:

• Make code changes based on your natural language instructions (add, remove, rename, refactor, etc.).
• Update code across multiple files if your prompt is clear.
• Help automate repetitive or tedious edits.
• Suggest improvements or modernizations to your code.
• Show you a preview of every change before you approve it.

What Codex Cannot Do:

• Make changes without your explicit approval.
• Understand highly ambiguous or incomplete prompts.
• Replace thorough code reviews or complex architectural decisions.
• Run or test your code automatically.
• Guarantee perfect results for very complex or project-specific tasks.

For best results, use Codex for well-defined, actionable changes and always review its suggestions.

The quality of your prompt directly affects the quality of Codex's suggestions. Here are some practical examples to help you get started:

Suppose you want to add a console log statement to the beginning of a file. You could type:

Add a console.log statement that says "Hello from Codex" at the start of main.ts

This is a very basic example. In real projects, you'll often want to use Codex for tasks that are more repetitive or tedious to do by hand.

For instance, if you need to rename a function throughout a file, you might write:

Rename the function fetchData to loadData in dataUtils.ts

Codex will find the function definition and update all references in the specified file. This is a common task that can be error-prone if done manually, especially in larger files.

Or, if you want to clean up your code before sharing it, you could ask:

Remove all console.log statements from utils.ts

Codex will scan the file and suggest removing every console.log statement, saving you time and reducing the chance of missing one.

After you enter your prompt, Codex will show you a preview of the proposed changes. You can approve the change if it looks correct, ask for an explanation, edit the suggestion, or decline it. Always review the preview carefully, especially as you start using Codex. This helps you build trust in the tool and ensures your code stays safe.

If you are new to Codex or to AI-powered coding assistants in general, here are some tips to help you get the most out of your experience:

• Start with simple, clear requests. For your first few prompts, try making small changes in a single file. This will help you get comfortable with how Codex interprets your instructions and how the review process works.
• Be as specific as possible. The more detail you provide in your prompt, the better Codex can understand your intent. If you mention the file name, function name, or describe exactly what you want changed, you'll get more accurate results.
• Don't be afraid to experiment. Try different ways of phrasing your requests. If Codex doesn't do what you expect, reword your prompt or add more context. You can always decline a suggestion if it's not what you wanted.
• Review every suggestion carefully. Even for simple changes, always check the preview before approving. This is especially important as you learn how Codex interprets your instructions.
• Use Codex for repetitive or tedious tasks. As you get more comfortable, try using Codex to automate changes that would be time-consuming by hand, like renaming variables across multiple files or cleaning up debug statements.
• Remember that you are always in control. Codex will never change your files without your explicit approval. You can ask for explanations, edit suggestions, or simply decline any change you don't like.
• Learn from the feedback loop. Each time you review and approve or reject a suggestion, you'll get a better sense of how to communicate with Codex. Over time, you'll develop a feel for writing prompts that get the results you want.

Getting started with Codex is all about building confidence and understanding how the tool responds to your instructions. With practice, you'll find that Codex can become a valuable assistant for both simple edits and more complex code changes.

In this lesson, you learned how Codex understands your instructions, what it can and cannot do, and how to write clear prompts for code changes. You saw how to review suggestions and safely approve or reject changes. In the next unit, you'll explore more advanced ways to interact with Codex and manage your session.