Claude Code Provider

Monitor and analyze your Claude Code sessions with GuideMode.

What is Claude Code?

Claude Code is Anthropic’s AI coding assistant that runs directly in your terminal. It provides:

• Conversational coding - Chat with Claude about your code
• File operations - Read, write, and edit files
• Command execution - Run terminal commands
• Project understanding - Claude analyzes your entire codebase

Requirements

Install Claude Code

Before configuring GuideMode, ensure Claude Code is installed:

# Install Claude Code CLI
npm install -g @anthropics/claude-code

# Or using homebrew (macOS)
brew install claude-code

# Verify installation
claude --version

Create Your First Project

GuideMode monitors Claude Code project sessions. Create a project first:

# Navigate to your code directory
cd ~/my-project

# Start a Claude Code session
claude code

# Work with Claude...
# Exit when done

This creates a project directory at ~/.claude/projects/my-project/.

File Locations

Claude Code stores session data in platform-specific locations:

macOS & Linux

~/.claude/
└── projects/
    ├── project-name-1/
    │   └── sessions/
    │       └── session-id.jsonl
    └── project-name-2/
        └── sessions/
            └── session-id.jsonl

Windows (WSL Required)

Claude Code requires Windows Subsystem for Linux (WSL) on Windows:

~/.claude/  (WSL Linux path)

Important: On Windows, use WSL paths (e.g., ~/.claude), not Windows paths.

Setting up capture

Install the CLI and run setup:

npm install -g guidemode
guidemode setup

Setup installs a hook into Claude Code, so sessions are captured as you work. It also installs the GuideMode Claude Code skill, which lets you control syncing by asking — “stop syncing this repo”, “where is this going?” — instead of remembering commands.

Choosing what syncs

By default, new repositories sync. To opt in explicitly instead:

guidemode setup --default-policy deny
guidemode enable           # run inside a repository you do want to sync

Check what applies where you are with guidemode status. See Controlling what syncs.

Session Detection

GuideMode automatically detects Claude Code sessions:

What Gets Captured

For each Claude Code session:

• Conversation: Full dialogue with Claude (if transcript sync enabled)
• Commands: Shell commands executed
• Files: Files read, written, or modified
• Duration: Start and end time
• Tokens: Token usage and costs
• Project: Associated project name

Session Processing

Sessions are processed when:

1. Claude Code exits - Session file is complete
2. File is modified - GuideMode detects the change
3. Processing occurs - Metrics extracted and stored locally

Viewing Sessions

Access your Claude Code sessions:

1. Navigate to Sessions page
2. Filter by provider: “Claude Code”
3. Click a session to view details

Historical Sessions

Sync sessions created before GuideMode was configured are synced to the server after you enable either metrics or full sync. If you do not want this, you need to remove the old sessions from the .claude folder first.