Getting Started
Quick Start
Set up your API key, add a workspace, and create your first AI-powered coding session.
1. Configure Your API Key
ChatML needs an Anthropic API key to access Claude.
- Go to Settings (
Cmd+,) > Account - Enter your Anthropic API key (starts with
sk-ant-api03-...) - The key is validated automatically and stored encrypted (AES-256-GCM)
Don't have an API key? Get one from Anthropic Console.
2. Add a Workspace
A workspace is a git repository you want to work with.
- Click the + button in the sidebar or use
Cmd+K> "Add Workspace" - Browse to your repository folder
- ChatML detects the git configuration (default branch, remotes)
- Your repository appears in the sidebar
3. Create a Session
Sessions are isolated environments for AI tasks.
- Click New Session (
Cmd+N) - Select your workspace
- Choose a name or accept the auto-generated one
- ChatML creates a git worktree and branch for this session
Each session gets its own working copy of your code, so you can run multiple tasks in parallel without conflicts.
4. Start a Conversation
- Type your request in the message input
- Press Enter to send
- Watch Claude work in real time — you'll see file reads, edits, and command execution as they happen
Example Prompts
Try these to get started:
- "Add a health check endpoint to the API"
- "Write unit tests for the authentication module"
- "Refactor the database queries to use prepared statements"
- "Review the code in this session and suggest improvements"
5. Review and Create a PR
When you're happy with the changes:
- Start a Review conversation to get structured code feedback
- Ask Claude to create a pull request
- Track PR status directly in ChatML
Next Steps
- Learn about Workspaces and Sessions in depth
- Explore Skills to augment Claude's capabilities
- Set up GitHub integration for PR and CI features
- Configure budget controls to manage costs