Vibe coding with Claude Code course Β· Module 1: Claude Code and Cursor

Ahoy! Claude Code, vibe coding and your ship

10 min read Β·
In this lesson13

Welcome aboard! I'm Captain Redbeard and I'll guide you through the whole voyage. Before we raise the anchor, let's agree who does what on this ship, because every later lesson depends on it.

What you will learn

  • what Claude Code is and how an agent differs from an ordinary chat,
  • what vibe coding is and which kind we practise in this course,
  • who writes the code on the ship and who shows what was created,
  • what you need to start and how to install Cursor,
  • where the file tree, editor, terminal and changes view are in Cursor.

The problem: you have an idea, but you don't know the syntax yet

You want to build a page or an app, but you don't know how to write it line by line. Today you don't have to start by memorising tags: you can describe the goal to an AI agent and it writes the code. Still, someone has to set the course, check the map and shout "stop" when the crew sails toward the rocks. That someone is you. This course teaches exactly that: how to command an agent and how to check its work.

What is Claude Code

Claude Code is an agentic coding tool from Anthropic. It works in the terminal, in code editors, in the desktop app and in the browser. In the course we run it in the terminal, because that is where you can see its every step.

The difference between a chat and an agent is crucial. A chat answers with text: you get a piece of code that you must paste into a file yourself. An agent works directly in your project folder. The Claude Code documentation describes its work as a loop of three phases:

  1. Gathers context: reads project files and command output to understand what is already there.
  2. Acts: creates and changes files, runs commands in the terminal.
  3. Checks the result: for example runs the program or tests and fixes what does not work.

The loop keeps turning until the task is done, and you can interrupt it at any moment. Think of a crew: it carries out orders efficiently, but it does not know where you are heading until you say so. And one more thing: when Claude reports "done", that is a report, not proof. A model can confidently write something untrue, so you always check the result yourself.

What is vibe coding

Vibe coding is building apps by talking to an agent: you describe what should be created, the agent writes the code, and you look at the result and keep steering. In the "go with the flow" version someone accepts everything without reading. That style is fine for play, but not for an app that holds passwords, payments or other people's data.

We practise vibe coding with open eyes: after every change you read what Claude wrote and understand it well enough to judge whether it is right. That is why the next lessons explain code piece by piece. You don't have to write it yourself, but you must be able to read it.

Who does what on the ship

In the course we use two tools and each has one role:

WhoRoleWhat it does
Claude Codethe crewreads the project, writes and changes files, runs commands
Cursorspyglass and mapshows the file tree, opens and searches files, shows changes, gives you the terminal in which Claude Code runs
Youthe captaingive orders, read changes, decide what stays

One round of work always looks the same: you describe the goal in a request, Claude Code reads the project and writes files, you read the change in Cursor, and then you approve it or ask for a correction. You will repeat this rhythm in every location, from the first HTML page to clones of big apps.

Why we don't use Cursor's AI

Cursor is a code editor built on top of the popular VS Code editor. It also has its own AI features: the Agent panel and grey code suggestions that appear as you type. You will see them on screen, but we don't use them in the course, for three reasons:

  • One agent, one way of working. Two agents changing the same files is two helmsmen at one wheel.
  • Skills you take everywhere. Claude Code works the same in the terminal of any editor, in the desktop app and in the cloud.
  • Different models. On the free plan Cursor uses only its own models, while the course teaches working with Claude.

Cursor's Agent panel is opened by the shortcuts Cmd+I, Cmd+L and Cmd+K on a Mac (Ctrl+I, Ctrl+L and Ctrl+K on Windows and Linux), but we don't use these features in the course: if you open the panel by accident, close it with the same shortcut. A grey suggestion that appears while typing can be dismissed with Esc or by simply typing on.

What you need

  • A computer: macOS 13 or newer, Windows 10 version 1809 or newer, or Linux (for example Ubuntu 20.04 or Debian 10 and newer), at least 4 GB of RAM.
  • Access to Claude Code: a paid Claude plan (Pro, Max, Ultra, Team or Enterprise) or a Claude Console account with pay-as-you-go billing. The free claude.ai plan does not include Claude Code. The cheapest is Pro: as of November 2026 it costs 20 USD a month, or 17 USD a month when billed annually (check current prices at claude.com/pricing).
  • A Cursor account: a free one is enough, because we don't use Cursor's AI features.

Captain's tip: if you are only checking whether working with an agent is for you, start with the Pro plan billed monthly. Higher plans give more usage, but you don't need them at the start. You can solve the tasks on the platform without a subscription, but the practice in the lessons requires a working Claude Code.

Installing Cursor

  1. Go to cursor.com/download.
  2. Download the installer for your system: Cursor has versions for Windows (x64 and ARM64), macOS and Linux (.deb and RPM packages or AppImage).
  3. Run the installer. On a Mac drag Cursor to the Applications folder, on Windows click through the installer screens, and on Linux install the package with your package manager or run the AppImage file.
  4. Open Cursor and sign in with your Cursor account when the program asks. You can create an account for free at cursor.com.

If you used VS Code before, you can move your settings over: Settings, General, Account, VS Code Import. If after launch you see the Agents Window instead of the editor, open the command palette with Cmd+Shift+P on a Mac or Ctrl+Shift+P on Windows and Linux, and then choose Open IDE. A project folder is opened with File, Open Folder: you will do that in the next lesson.

Right after this lesson a video about installing Cursor awaits you. If you see Cursor's AI chat in it, skip that part: in the course, Claude Code writes the code.

Map of the ship

After you open a project folder, Cursor looks roughly like this. Remember which part of the window holds what, because in every lesson you will jump between the file tree, the editor and the terminal:

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  File  Edit  View  ...                                       β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ EXPLORER β”‚  EDITOR                          β”‚  Cursor Agent  β”‚
β”‚ (file    β”‚  (read the files that            β”‚  panel         β”‚
β”‚  tree)   β”‚   Claude Code wrote here)        β”‚  (closed)      β”‚
β”‚          β”‚                                  β”‚                β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚  TERMINAL: this is where you run claude                      β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

The diagram shows roles, not every button: your version of Cursor may have different icons, but you will always find these four places. Let's go through them one by one:

  • Explorer (left panel) shows the project's file tree. When Claude Code creates a file, you see it here right away, and a click opens it in the editor.
  • Editor (centre) is where you read code. In this course you read more often than you write. You can open a file by name quickly with Cmd+P on a Mac or Ctrl+P on Windows and Linux: type a few letters of the name and press Enter.
  • Terminal (bottom) is opened with Control+` on a Mac (Control, not Cmd!) or Ctrl+` on Windows and Linux. The second key is the backtick, which usually sits below the Esc key. You open another terminal with Control+Shift+` on a Mac or Ctrl+Shift+` on Windows and Linux.
  • Source Control is the view that shows which files changed and exactly what changed in them, when the project uses Git. We will come back to it in the Git lesson.
  • Agent panel (right) keep it closed.

What a good request looks like

A bad order is "make me a page". Claude doesn't know which page, about what, in which file, or what not to touch, so it will invent all the missing details its own way. A good order says what should be created, where and under what constraints. This is the request you will give in the next lesson:

Request for Claude Code:

Create a file pirate.html in this folder: a page with the heading "Ahoj Piraci!"
in red and one welcome paragraph. Put the styles in a <style> tag
in the same file. Do not create any other files.

This request has three parts: the goal (a page with a red heading and a paragraph), the place (the file pirate.html in the current folder) and the constraints (styles in the same file, no other files). What does not help is CAPITAL LETTERS, the word "IMPORTANT" on every sentence or pleas like "don't be lazy": the official Claude Code best practices explicitly discourage such phrases. Specifics help.

Plan B: if the terminal feels intimidating

Claude Code also works in the Claude desktop app, in the Code tab. It is a graphical interface: you pick the project folder with a button, type the request in a box and review changes in a diff view, with no terminal and no separate Claude Code installation. The app runs on macOS and Windows, and on Linux in beta, and it requires a paid Claude plan (Pro, Max, Ultra, Team or Enterprise). Cursor then remains only for reading files.

Captain's tip: do try the terminal, though. In the next two lessons I will walk you through it step by step, and I show the commands throughout the course in the terminal.

Captain's review before the next lesson

  • Cursor starts and you are signed in.
  • The terminal opens with the shortcut from the map of the ship.
  • You have an active paid Claude plan or a Claude Console account.
  • Cursor's Agent panel is closed.

Next step

In lesson 0_2 you will sign on the crew: you will install Claude Code in Cursor's terminal, start your first session and give the request from this lesson.

Remember: Claude Code is your crew, Cursor is your spyglass and map, and you set the course.

Code for this lesson: index.html
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Ahoy Pirates!</title>
    <style>
        body {
            background-color: #000;
            color: #fff;
            font-family: Arial, sans-serif;
            padding: 20px;
        }
        h1 {
            color: #dc2626;
            border: 2px solid #f59e0b;
            padding: 10px;
        }
    </style>
</head>
<body>
    <h1>Ahoy Pirates!</h1>
    <p>Welcome aboard the Black Pearl of Code!</p>
    <p>Experiment with this code - change the text, colors, add something of your own!</p>
</body>
</html>

Spotted a mistake in this lesson?

  1. VideoVideo: How to install Cursor
  2. QuestionQuiz: What is Claude Code
  3. QuestionQuiz: The role of Cursor in the course
  4. QuestionQuiz: What is vibe coding
  5. Put in orderSorting: Installing Cursor
  6. QuestionQuiz: What Claude Code requires
  7. QuestionQuiz: Where you read code
  8. Put in orderSorting: A round of work with Claude Code
  9. QuestionQuiz: The file list panel
  10. QuestionQuiz: A good request for Claude Code
  11. Put in orderAssemble: The open-files shortcut
  12. QuestionQuiz: What a good request contains
  13. QuestionQuiz: The terminal shortcut on macOS

Useful articles