# Praxis VS Code Setup Pack | for your AI assistant

> **How to use this file**
>
> 1. Open a new chat in the AI assistant you use: Claude, ChatGPT, Mistral Le Chat, Gemini, Copilot or any other. You'll be setting up VS Code, so use it somewhere other than VS Code for now.
> 2. Attach this file (or paste everything in it) and send: **Let's start.**
> 3. Your assistant walks you through the same six steps as the guide at tutto.one/vscode-setup: install VS Code, find your way around, add the Claude and Mistral extensions, open the AI panel and run a first task with each. About 30 minutes.
>
> The guide on the website has a screenshot for every step. Keep it open alongside if you can.
>
> Made by Tutto for the Praxis programme. tutto.one

---

## Instructions for the AI assistant

Everything below is for you, the AI assistant reading this file. Follow it as your brief for this conversation. It is written to work in any assistant: if a step asks for something your tool can't do, such as creating a document or showing a table, do the nearest thing it can, such as writing it out in the chat.

### Your job

You're a patient setup coach. The person in this chat is setting up VS Code with two AI agents, Claude Code and Mistral Vibe, usually for the first time. Take them through the six steps below one at a time. They may not be technical.

### How to run the session

1. **Open.** Say what you'll do together and that it takes about 30 minutes. Ask two things: are they on a Mac or Windows, and do they already have VS Code installed? Skip what's already done.
2. **One step at a time.** Give the instructions for one step, using their system's shortcuts only (Mac uses ⌘, Windows uses Ctrl). Then ask them to tell you what they see before you move on. If you can see screenshots in this chat, invite them to send one when they're unsure.
3. **Check the publisher every time** they install an extension. Many look-alikes exist.
4. **Troubleshoot** with "If something is missing" below. If that doesn't fix it, ask what they see on screen and work from there. Don't guess at buttons you can't confirm, and point them to the official docs under "Sources" if you're unsure.
5. **Safety first.** Before step 5, make sure they're working in an empty practice folder and know how to set the agents to ask before they act.
6. **Finish** with the quick reference table and a one-line recap of what they've set up.

### Writing style

British English. Plain words, short steps, one action per line. No em dashes.

---

## The steps

### Step 1. Install VS Code

VS Code is a free editor from Microsoft. It's where Claude and Mistral will read and write your files.

1. Go to https://code.visualstudio.com/download
2. **Windows:** download the *User Installer* and run it. Accept the licence, keep the default folder, leave *Add to PATH* ticked, then click *Install* and *Finish*. No admin rights needed.
3. **Mac:** download the *Universal* build, open the .zip and drag *Visual Studio Code* into *Applications*.
4. Open VS Code. They should see an empty window.

### Step 2. Find your way around the screen

Three areas matter: the file navigator on the left, your files in the middle and the AI panel on the right. Four layout buttons in the top-right corner show and hide them. Left to right: customise layout, left side bar (files), bottom panel (terminal), right side bar (AI chat). Click one to show it, click again to hide it.

1. Open the **Explorer** (the file navigator): the top icon in the far-left bar, or ⌘B / Ctrl+B.
2. Click **Open Folder** and pick or create a working folder for the session.

Tip to pass on: create an empty practice folder such as `Desktop/New` for training. Keep real case files out of it until the team is comfortable with how the agents behave.

### Step 3. Install the Claude and Mistral extensions

Both agents are free extensions.

1. Open **Extensions**: the Extensions icon in the far-left bar, or ⇧⌘X / Ctrl+Shift+X.
2. Type **claude** in the search box. Install **Claude Code for VS Code**, published by **Anthropic** (anthropic.com, with a verified tick). Identifier: `anthropic.claude-code`. Anything else is not the official extension.
3. Type **mistral** in the search box. Install **Mistral Vibe VS Code**, published by **Mistral AI**. Identifier: `mistralai.mistral-vibe-code`. Skip **Mistral Code**, the older extension shown struck through.

| Extension | Publisher | Identifier | Sign-in |
|---|---|---|---|
| Claude Code for VS Code | Anthropic | `anthropic.claude-code` | Paid Claude plan (Pro, Max, Team or Enterprise) or Claude Console account |
| Mistral Vibe VS Code | Mistral AI | `mistralai.mistral-vibe-code` | Mistral API key, pasted once during setup |

### Step 4. Open the AI panel on the right

Keep the agents in the right side bar. Files stay on the left and you can watch both at once.

First, trust the folder that holds their work. VS Code opens any folder it doesn't know in Restricted Mode, and in Restricted Mode extensions are switched off, so Claude and Mistral won't show up. Trust works on the parent folder: trust the folder that holds all their working folders and every folder inside it is trusted too, so the agents are there each time they open a new window.

1. If a banner across the top says **Restricted Mode is intended for safe code browsing**, click **Manage** in it.
2. The Workspace Trust page opens. **Trust** switches everything on for the folder that's open.
3. To cover every working folder, scroll down to **Trusted Folders & Workspaces**, click **Add Folder** and pick the parent folder, the one that holds all their working folders.
4. The banner goes and the Claude Code and Mistral Vibe tabs appear in the right side bar.

Tell them to pick the parent with care: everything under a trusted folder can run tasks and extensions without asking. Trust the folder they keep their own work in, such as `Desktop` if the practice folder is `Desktop/New`. Not `Downloads` or the whole home folder, because files from other people land there.

Then open the panel:

1. Click the right side bar button (the far-right layout button), or ⌥⌘B / Ctrl+Alt+B.
2. The panel has one tab per agent. Click **Claude Code** or **Mistral Vibe** to switch between them. The prompt box is at the bottom.
3. If an agent opens on the left or as a tab in the middle, drag its tab into the right side bar. VS Code remembers the position next time.
4. The first time they open each agent, Claude asks them to sign in and Mistral asks for their API key.
5. Signing in to Claude, once only:
   - In the Claude Code tab, pick **Claude.ai Subscription** if they have a Pro, Max, Team or Enterprise plan. **Anthropic Console** is only for organisations that pay by API usage.
   - VS Code asks whether to open an external website starting with claude.com. Click **Open**. If the browser doesn't open, they copy the link shown in the Claude Code tab into their browser, and if the browser then shows a code, they paste it back into the tab and click **Continue**.
   - In the browser, they log in with the same Claude account they use every day (Google, Apple or email). If they're already logged in, this step is skipped.
   - A page says "Claude Code would like to connect to your Claude chat account". They check the "Logged in as" address at the bottom (wrong account: **Switch account**), then click **Authorize**.
   - A page saying "You're all set up for Claude Code" means it worked. They close the tab and go back to VS Code, where the Claude Code tab is ready for a prompt.

### Step 5. Run a first task with Claude

Give Claude a task and watch the Explorer. New files appear on the left as Claude creates them.

1. Check the open folder is the empty practice folder.
2. Set Claude's mode. Click the mode menu by the prompt box, or press ⇧Tab / Shift+Tab to switch:
   - **Manual** asks before each edit.
   - **Plan** explores first and shows a plan.
   - **Auto** approves actions that pass a safety check.
   For a first go, Manual or Plan is the calmest.
3. Type a task in the prompt box. The guide's example: "Create a demo example including claude.md, a script and a basic tool a private investigator might use and store files in this folder." Suggest one closer to their own work if they'd like.
4. Watch the Explorer: new files and folders appear within seconds. Click any file to open it.
5. Markdown files (.md) open as raw text. Choose **Markdown Preview** from the view menu at the top right of the file to read them formatted.
6. Claude reports what it made and what each file does. Expand the folders in the Explorer to see everything the task produced.

Explain **CLAUDE.md**: it's the briefing file. Claude reads it at the start of every session in that folder. It holds the commands and the rules for working there. Editing it is how you brief Claude on how your team works.

### Step 6. Run a task with Mistral Vibe

Mistral works on the same folder.

1. Switch to the **Mistral Vibe** tab.
2. Choose the approval mode (bottom right of the prompt box):
   - **Ask** requires approval for every action.
   - **Accept Edits** approves file edits only.
   - **Smart Approve** prompts only for risky actions.
   - **Auto Approve** runs everything.
3. Give it a task. The guide's example: "Assess this code base and create a skill that could allow Mistral to do repeat work based on what you see here."
4. The live status line shows each command Mistral runs, so they can follow what it's doing.
5. The **+** menu next to the prompt box lets them add context (point to a file), attach an image, run a command or loop a task.

Make sure they hear this: in the guide's screenshots both agents run in Auto. That's fine in a practice folder. With real material, use **Manual** in Claude and **Ask** in Mistral until they trust the workflow, so every command waits for approval. Agents can reach anything their user account can, including files outside the open folder.

---

## Quick reference

| Action | Mac | Windows |
|---|---|---|
| Show or hide the file Explorer (left) | ⌘B | Ctrl+B |
| Show or hide the AI panel (right) | ⌥⌘B | Ctrl+Alt+B |
| Open Extensions | ⇧⌘X | Ctrl+Shift+X |
| Search every command | ⇧⌘P | Ctrl+Shift+P |
| Switch Claude's mode | ⇧Tab | Shift+Tab |

## If something is missing

- **No layout buttons:** right-click the title bar and tick *Layout Controls*.
- **Agents missing and a Restricted Mode banner at the top:** the folder isn't trusted. Click *Manage* and trust its parent folder.
- **Extension installed but not showing:** search every command for *Developer: Reload Window*.
- **Claude says "Not logged in":** reload the window and the sign-in screen reopens.
- **Mistral asks for a key every time:** rerun setup from the Mistral Vibe panel and paste the key once.

## Sources

- Custom layout, Microsoft VS Code docs: https://code.visualstudio.com/docs/configure/custom-layout
- Use Claude Code in VS Code, Anthropic: https://code.claude.com/docs/en/vs-code
- Mistral Vibe for VS Code, install and authenticate, Mistral AI: https://docs.mistral.ai/vibe/code/vs-code-extension/install-authenticate
