Algoritmi AI SandboxPractice environment with sample data. Nothing here reaches the production platform.

Setup (Mac)

Install the Claude desktop app and let Claude do the rest of the preparation. You do this once.

Using Windows? See Setup (Windows).

What you need from an administrator

Before you start, you need two things:

  • A Claude account — on a plan that includes Claude Code
  • A GitHub account — invited to this platform's repository, the place where the apps' code is kept
If you do not have them yet

Ask an administrator for "an account that can use Claude Code" and "an invitation to the GitHub repository". If you already have a GitHub account, tell the administrator your username.

Step 1: Install the Claude desktop app

  1. Open claude.com/download and download the app for Mac.
  2. Open the downloaded file and move Claude into the Applications folder.
  3. Start Claude and log in with the account you were given.

Step 2: Choose a working folder in the Code tab

  1. Open the Code tab at the top of the app. This is Claude Code.
  2. Choose Local. Claude can now work with the files on your Mac.
  3. With Select folder, choose your home folder. It is the folder with the house icon, named after you. In the folder picker, press Command + Shift + H to open it.
Do not choose Documents or Desktop

Documents and Desktop are often synced with iCloud. A project stored inside them can behave unreliably.

Step 3: Ask Claude to do all the preparation at once

One request covers everything: checking and installing what is needed, logging in to GitHub, and getting the project. Copy the request below, paste it into Claude Code, and send it. It is fine to paste it as it is, even if some words are unfamiliar.

Ask for all the preparation
Claude prompt
I want to finish preparing this Mac for development. I have no programming experience. Please work in this order. 1. Check whether the following are installed, and install only what is missing: Git, Git LFS, the GitHub CLI (gh), Node.js (an LTS release, version 20 or later), and pnpm. Make sure Git LFS is ready before cloning 2. Check whether the GitHub CLI is logged in to GitHub, and help me log in if it is not. Please use the HTTPS and web browser method 3. Check whether Git has a name and an email address set for commits. For anything that is not set, set it from the account that is logged in to GitHub now, without asking me. Use the name on the GitHub profile, or the username if there is none. For the email address, use the private address GitHub provides ([email protected]). Apply the setting to this whole computer. Do not change anything that is already set 4. Clone https://github.com/algoritmi-tech/algoritmi-sandbox-vibe-coding-platform into the folder that is open now 5. Make the pnpm version match the one named in packageManager in the root package.json of the cloned folder 6. Install the project's dependencies from the root of the cloned folder. There is no need to start an app on my computer 7. Finally, tell me whether everything is ready and where the cloned folder is Before installing anything, explain in one sentence what it is and why it is needed. When something only I can do is required, such as typing a password or acting in the browser, walk me through it one step at a time.

While Claude works, it may ask you to do things like these:

What you are askedWhat to do
A confirmation such as "May I run this?"Read it and allow it if it is part of the preparation. If unsure, ask "What does this do?"
A window offering to install the "command line developer tools"Press Install and wait until it finishes. It takes several minutes
Logging in to GitHubYour browser opens. Enter the code Claude shows you and press the button that grants access
Typing your Mac passwordType it yourself on the screen Claude points you to. Never type a password into your conversation with Claude
Pasting into TerminalClaude may ask you to open the Terminal app and paste one line. Follow its explanation
Restarting ClaudeQuit Claude, start it again, go back to the same conversation, and send "Please continue"

Installing can take a while. When Claude answers that everything is ready and tells you where the folder is, go to the next step.

Step 4: Reopen with the project folder

The folder named algoritmi-sandbox-vibe-coding-platform that Claude told you about is the project folder.

  1. Start a new conversation in the Code tab.
  2. With Select folder, choose the algoritmi-sandbox-vibe-coding-platform folder.
From now on, always choose this folder

This folder contains the instructions Claude follows to work by this platform's rules. If you ask while another folder is selected, Claude works without knowing those rules.

Setup is now complete.

If something goes wrong

What happenedWhat to do
You cannot find or use the Code tabAsk an administrator whether your plan includes Claude Code
Claude stopped partwaySend "Please continue"
You cannot log in to GitHub, or the repository is "not found"Ask an administrator whether you have been invited. If you received an invitation email, accept it
You do not understand what is happeningSend "Explain what you are doing right now, without technical terms"

Quiz

Quiz

After setup, which folder should be selected when you ask Claude to do something?

Next step

Go to The Basic Flow.