- Get Started
- VS Code & Windsurf Users
Get Started
VS Code & Windsurf Users
Step-by-step guide to installing and using the Codapt extension in VS Code or Windsurf
Step 1: Install Codapt
Open the code editor
Launch the code editor you just installed.
Open the Extensions Marketplace
Click the Extensions icon in the left side panel. You can also press Ctrl + Shift + X (Windows) or Cmd + Shift + X (Mac) on your keyboard.

Install Codapt
Search for “Codapt” in the Marketplace and click install.
Step 2: Open Codapt
- Click the gray Codapt icon in the left menu.
Congratulations! You’ve successfully opened the Codapt extension. Now you can sign up with your email and start your Codapt journey.
Haven’t received your verification code after a few minutes? First, check your spam folder. If you still can’t find it, email us at hello@codapt.ai and we’ll help you out!
Step 3: Create a new Codapt project
Creating a new project in Codapt unlocks its full capabilities, including running your project in the cloud for instant preview.
There are two ways to create a new Codapt project. While the interface varies slightly between them, we’ll guide you through both methods!
When your code editor has no open folders
Click Create a new project to pick a location for your Codapt project.
When you have a folder already open in your code editor
Open the menu
Click the ⋮ (three dots) in the top-right corner.

Open Codapt
Click the Codapt icon on the side panel.

Create a new project
Click Create a New Project to pick a location for your Codapt project.

Nice job! Now you have created your first Codapt project.
Step 4: Run your Codapt project
The first time you create a Codapt project, it takes some time for the server to warm up so the Preview App button will load for a couple minutes. Codapt will refresh the app every time it completes a request, so you can also go straight and start working on your first prompt.
Wait for the server to warm up
The Preview App button will show a loading state while the server warms up.

Click Preview App
After it finishes loading, click the Preview App button.

Click Open
Click Open to launch your app in the browser.

View your app
Congrats! Now you should see a blank page with “Hello world!”, which means your Codapt app is running on the Cloud! Now you are all set to make your first request in the chat!
If you need some ideas to start with, check out our prompt examples.

Key points to remember
Important: Changes to your repository will appear after Codapt finishes processing your request.
Codapt can access your entire codebase, allowing you to reference any file or folder. However, Codapt does not retain chat history—it cannot see previous messages or its own replies. Be sure to include all necessary context in each message.
If you have more questions, check out the FAQ or Contact Us.