Get started with AI TokenScope
From workspace creation to your first governed Claude Code session — ten steps, no code changes.
Prerequisites
- A supported Windows machine (Windows 10 version 1903 or later)
- Claude Code installed (latest version recommended)
- Outbound HTTPS access from the developer's machine
- An AI TokenScope account (or sign up at aitokenscope.com/signup)
Typical setup time
In a standard self-service environment with Claude Code already installed on Windows, a developer can connect in under a minute. Enterprise rollout, SSO configuration, or security review requirements may take longer.
Setup steps
Create your workspace
- Sign up at aitokenscope.com/signup
- Choose a plan — the free plan requires no credit card
- Name your workspace (usually your company or team name)
Define teams and projects
- Create a project — matches a team, codebase, or use case
- Add developers to the project
- Optionally create cost centres for department-level reporting
Configure storage and policy mode
- Default: full prompt storage + Observe mode
- Recommended: start in Observe mode and review usage before enabling enforcement
- Storage mode: full content (default) or metadata-only — Team plan and above
- Set retention period in workspace settings
Invite developers
- Send invite emails from the team settings page
- Developers receive a sign-up link and instructions
- Developers join and are associated with your workspace automatically
Download and install the launcher (Windows)
- Download tokenscope.exe from the dashboard
- Run: tokenscope.exe install (adds to PATH automatically)
- No runtime, .NET, or additional prerequisites required
Authenticate
- Run: tokenscope in any terminal
- Browser opens for sign-in (Google, Microsoft, or email/password)
- Session is cached for 5 days — no repeated logins needed
Launch Claude Code with governance active
- Run: tokenscope in any terminal
- Claude Code opens with proxy routing and governance active
- No application code changes are required
Send a test request
- Use Claude Code normally — ask any question
- The request is classified, attributed, and logged automatically
Confirm attribution
- Open the dashboard
- Confirm the test request appears attributed to the developer and project
- Verify cost estimate and classification result are shown
Review usage and configure policies
- Review classification results in Observe mode
- Configure budget limits once you understand baseline usage
- Enable Warn or Enforce mode when you are ready
Developer install reference
# Step 1 — install once (Windows)
tokenscope.exe install
→ added to PATH automatically
# Step 2 — start any Claude session
tokenscope
→ browser opens for sign-in
→ Claude Code launches, governed
The launcher adds two proxy environment variables for the current terminal session. No changes are made to application code or Claude Code configuration files.
Need help with setup?
If you run into issues during installation, authentication, or first connection, our team can help.