Quick Start

Quick Start Guide

Get up and running with ClaudeLoop in under 5 minutes! This guide will walk you through your first automated Claude Code workflow.

Before You Begin

Ensure you have:

• ✅ VS Code 1.74.0 or later
• ✅ Claude Code CLI installed and accessible
• ✅ Python 3.8 or later
• ✅ ClaudeLoop extension installed

Need help with installation? See the Installation Guide.

Step 1: Open Your Workspace

1. Open VS Code
2. Open a folder/workspace where you want to use ClaudeLoop
3. Ensure you have some files to work with (code files, documents, etc.)

Step 2: Start ClaudeLoop

Method 1: Command Palette

1. Press Cmd/Ctrl + Shift + P to open Command Palette
2. Type "Claude: Start ClaudeLoop"
3. Press Enter

Method 2: Quick Access

• Look for the ClaudeLoop icon in the VS Code sidebar
• Click to open the ClaudeLoop panel

Step 3: First Dependency Check

When ClaudeLoop starts, it automatically checks your dependencies:

• 🟢 Green checkmarks: Everything is ready
• 🟡 Yellow warnings: Minor issues (often safe to ignore)
• 🔴 Red errors: Must be fixed before proceeding

If you see red errors, check the Troubleshooting Guide.

Step 4: Add Your First Message

1. In the ClaudeLoop panel, click "Add Message"
2. Enter a simple task, for example:

   Please analyze the current directory structure and create a brief summary of the main files and their purposes.
   

3. Click "Add to Queue"

Step 5: Start Processing

1. Click the "Start Processing" button
2. Watch as ClaudeLoop:
   • Sends your message to Claude Code
   • Processes the response
   • Shows results in real-time

Step 6: View Results

1. Real-time Output: Watch the processing in the main panel
2. History Tab: Click "History" to see completed tasks
3. Queue Tab: Monitor pending and completed messages

Example Workflows

Workflow 1: Code Analysis

Perfect for understanding a new codebase:

Message 1: "Analyze the package.json file and summarize the project dependencies and scripts."

Message 2: "Look at the src/ directory structure and explain the main components."

Message 3: "Review the README.md and identify any missing documentation."

Workflow 2: Code Generation

Great for repetitive tasks:

Message 1: "Create a TypeScript interface for a User object with id, name, email, and createdAt fields."

Message 2: "Generate a React component that uses the User interface to display user information."

Message 3: "Create unit tests for the User component using Jest."

Workflow 3: Refactoring

Ideal for code improvements:

Message 1: "Review all .js files in the src/ directory and identify opportunities to convert to TypeScript."

Message 2: "Convert the utils/helpers.js file to TypeScript with proper type definitions."

Message 3: "Update import statements in files that use the converted helpers."

Understanding the Interface

Main Panel Sections

1. Status Bar: Shows current processing status
2. Queue Section: Lists pending and processing messages
3. Output Section: Displays real-time results
4. Controls: Start/stop processing, add messages

Queue Operations

• ➕ Add: Add new messages
• ✏️ Edit: Modify existing messages
• 🗑️ Delete: Remove messages
• 📋 Duplicate: Copy messages
• ↕️ Reorder: Change message order

Status Indicators

• 🟢 Ready: System ready for processing
• 🟡 Processing: Currently working on tasks
• 🔴 Error: Issue requires attention
• ⏸️ Paused: Processing paused (manual or auto-resume)

Best Practices for Beginners

1. Start Small

• Begin with simple, single-task messages
• Gradually increase complexity as you learn

2. Use Clear Instructions

✅ Good: "Add error handling to the login function in src/auth.js"
❌ Vague: "Fix the authentication stuff"

3. Break Down Complex Tasks

Instead of:

"Refactor the entire application to use TypeScript and add comprehensive testing"

Try:

Message 1: "Convert src/utils/helpers.js to TypeScript"
Message 2: "Add type definitions for the main User interface"
Message 3: "Create Jest tests for the helpers module"

4. Monitor Progress

• Keep an eye on the processing status
• Review outputs before adding dependent tasks
• Use the history feature to track what's been completed

Configuration for Beginners

Start with these essential settings:

{
  "claudeLoop.session.skipPermissions": true,
  "claudeLoop.sleepPrevention.enabled": true,
  "claudeLoop.queue.autoMaintenance": true,
  "claudeLoop.developmentMode": false
}

Common First-Time Issues

Issue: "Claude not found"

Solution: Ensure Claude Code is installed and in your PATH

claude --version  # Should show version number

Issue: Queue won't start processing

Solution: Check the dependency status indicators

Issue: No output appears

Solution: Wait a moment - Claude Code responses can take time

Issue: Permission errors

Solution: Enable claudeLoop.session.skipPermissions in settings

Next Steps

Now that you have ClaudeLoop running:

1. Explore Configuration: Customize settings in Configuration Guide
2. Learn Advanced Features: Check out Use Cases for inspiration
3. Optimize Your Workflow: Read Best Practices
4. Join the Community: Visit GitHub Discussions

Quick Reference Commands

Action	Command
Start ClaudeLoop	Claude: Start ClaudeLoop
Stop ClaudeLoop	Claude: Stop ClaudeLoop
Add Message	Claude: Add Message to Queue
Open Settings	Cmd/Ctrl + , → Search "ClaudeLoop"

Getting Help

If you run into issues:

1. Check the status indicators in the ClaudeLoop panel
2. Review the Troubleshooting Guide
3. Enable debug logging and check for error messages
4. Ask for help in GitHub Discussions

---

Congratulations! You've completed your first ClaudeLoop workflow. You're now ready to automate your Claude Code tasks efficiently.

Quick start guide last updated: July 2025