Quick Start

Note

Prerequisites: Python 3.10+, Docker Desktop 4.50+, Git 2.30+. See Installation for details.

30-Second Setup

1. Install SCC CLI

   uv (recommended)

   uv tool install scc-cli

   pipx

   pipx install scc-cli

   pip

   pip install scc-cli

2. Configure your organization (if you have an org config URL)

   scc setup

   When prompted, paste your organization’s config URL. If you don’t have one, use --standalone mode:

   scc setup --standalone

3. Launch Claude Code in your project

   cd ~/your-project
   scc

   Or specify the path directly:

   scc start ~/your-project

Tip

If you install plugins inside the container, run scc profile save afterward to capture your personal setup. SCC will detect sandbox-only plugin changes and can import them into .claude/settings.local.json before saving.

What Happens When You Run scc

1. If no org config exists, SCC asks whether to run setup or standalone mode
2. Auto-detects workspace from git repository root or .scc.yaml location
3. If no workspace is detected, SCC opens the Dashboard so you can start a session
4. Shows Quick Resume (always includes “New session” as the default)
5. Prints brief context (workspace root, entry directory, team) before launching
6. Starts Docker container with your team’s configuration

Tip

Safety guard: SCC won’t auto-launch from suspicious directories (home, /tmp). If you try scc start ~/, it will prompt for confirmation.

Keyboard Shortcuts

When in interactive mode:

Key	Action
Enter	Select / resume / start
n	Start new session
a	Show all teams (toggle)
t	Switch team
Esc	Go back
q	Quit

Verify Your Setup

Run the diagnostic command to ensure everything is configured correctly:

scc doctor

Expected output:

✓ Docker: OK (version 27.0.0)
✓ Git: OK (version 2.45.0)
✓ Python: OK (version 3.12.0)
✓ Config: OK
✓ Organization: Connected to "My Org"
✓ Team: backend

Common First-Time Issues

Problem	Solution
”Cannot connect to Docker”	Start Docker Desktop and wait for it to initialize
”Docker version too old”	Update to Docker Desktop 4.50+
“Organization config fetch failed”	Check your org URL is correct and accessible

See Troubleshooting for more solutions.

Next Steps

Core Concepts

Understand sessions, worktrees, and profiles. Learn more →

Personal Profiles

Save your personal setup per project and sync across machines. Read guide →

Developer Onboarding

Joining a team? See what you get automatically. Read guide →

Team Setup

Managing a team? Configure plugins and profiles. Set up →