Getting Started
Get started with CodePilot — a desktop workspace for Claude Code.
Getting Started
CodePilot is a desktop workspace for Claude Code that brings conversations, providers, MCP, Skills, Bridge, and Assistant Workspace together in one interface.
Prerequisites
Before using CodePilot, you need:
- Node.js 18+ — CodePilot depends on Node.js to run the Claude Code CLI
- Claude Code CLI — Anthropic's official command-line tool (can be installed automatically on first launch)
- At least one API key — From Anthropic, OpenRouter, or another supported provider (see Providers for details on obtaining and configuring keys)
Installation & First Launch
- Download the installer for your platform from GitHub Releases (detailed installation guide)
- Install and launch CodePilot
- On first launch, a Setup Wizard will guide you through:
- Detecting and installing Node.js (if not found)
- Detecting and installing the Claude Code CLI (if not found)
- Configuring at least one API provider
Interface Overview
The CodePilot interface consists of a left sidebar and a main workspace area:
| Navigation | Description |
|---|---|
| Chat | Converse with Claude in Code / Plan / Ask modes |
| MCP | Manage MCP servers to give Claude access to external tools |
| Skills | Browse and manage skills (local + marketplace) |
| Bridge | Bridge conversations to Telegram, Discord, Feishu, QQ |
| Gallery | View images generated by Claude |
| Settings | Providers, CLI config, usage stats, Assistant Workspace |
Starting Your First Conversation
- Click Chat in the sidebar to open the chat page
- Type your request in the input box and press Enter
- Claude will stream its response, showing tool calls and file operations as they happen
- Use the mode switcher above the input box to change the conversation mode:
- Code — Default mode. Claude can read/write files and run commands
- Plan — Planning mode. Claude analyzes and proposes a plan without executing anything
- Ask — Q&A mode. Claude answers questions without using any tools
Next Steps
- Installation — Detailed installation and setup steps
- Providers — Configure multiple LLM providers
- MCP — Extend Claude's capabilities with MCP plugins
- Skills — Use and manage skills
- Bridge — Continue Claude conversations on your phone
- Assistant Workspace — Manage project context and Claude's behavior