How To Set Up Codebox

Prerequisites

Before setting up Codebox, make sure you have the following ready:

• A Union Square account with an active subscription
• A GitHub account with access to the repositories you want to work on
• A modern web browser (Chrome, Firefox, Safari, or Edge)

Connect Your GitHub Account

Navigate to the Codebox section from your Union Square dashboard. Click “Connect GitHub” to authorize Union Square to access your repositories. You'll be redirected to GitHub to grant the necessary permissions.

Union Square requests read access to your repositories and write access for creating branches and pull requests. You can choose to grant access to all repositories or select specific ones.

Select a Repository

Once your GitHub account is connected, you'll see a list of your available repositories. Select the repository you want to work on. Codebox will clone the repository and set up the development environment automatically.

For larger repositories, the initial setup may take a few moments as dependencies are installed and the environment is configured.

Launch Your First Session

After selecting a repository, click “Launch Codebox” to start a new session. Each session provides a fully isolated cloud environment with your code, a running development server, and Claude Code ready to assist you.

1. Select your repository from the dashboard
2. Choose the branch you want to work on (defaults to main)
3. Click "Launch Codebox" to start your session
4. Wait for the environment to initialize — this typically takes 30–60 seconds
5. Start coding with Claude Code in your browser