Codepilot
A multi-model AI agent desktop client — connect any AI provider, extend with MCP & skills, control from your phone. Built with Electron + Next.js.
Last verified:
What is Codepilot?
CodePilot is a desktop workspace for Claude Code that provides a graphical interface on top of the Claude Code CLI. Built with Electron + Next.js, it brings conversations, providers, MCP plugins, skills, message bridging, and the Assistant Workspace together in one interface. The tool allows developers to converse with Claude in three modes: Code (default, can read/write files and run commands), Plan (analyzes and proposes plans without executing), and Ask (Q&A mode without tool usage) [web:1][web:7].
Key features include multi-provider management (Anthropic, OpenRouter, AWS Bedrock, Google Vertex, Custom API), MCP server management for external tools, a Skills marketplace for local and marketplace skills, Message Bridge for connecting to Telegram/Discord/Feishu/QQ, an image Gallery for Claude-generated images, and the ability to import CLI conversation history. The Setup Wizard automatically detects and installs Node.js and Claude Code CLI on first launch [web:1][web:5].
CodePilot is designed for developers and coding professionals who want a GUI for Claude Code CLI. It supports macOS 12+ (Apple Silicon and Intel) and Windows 10+ (64-bit). Users need their own API key from supported providers, and the software itself is open source and free to use [web:1][web:7].
Codepilot pricing
Pricing model: Freemium
CodePilot is open source and free to use. You need your own API key from a supported provider (Anthropic, OpenRouter, GLM/Zhipu, Kimi/Moonshot, Volcengine, Alibaba Cloud Bailian, AWS Bedrock, Google Vertex, or Custom API). API usage fees are charged by the provider, not by CodePilot. Multiple providers can be configured and switched between in Settings [web:5][web:7].
Codepilot pros
- Open source and free to use
- Graphical interface for Claude Code CLI
- Multi-provider support (Anthropic, OpenRouter, AWS Bedrock, Google Vertex)
- Three conversation modes: Code, Plan, and Ask
- Automatic Node.js and Claude Code CLI installation via Setup Wizard
- Message Bridge to Telegram, Discord, Feishu, and QQ
- MCP plugins for extending Claude's capabilities
- Skills marketplace with local and marketplace skills
- Image Gallery for Claude-generated images
- Support for local LLMs via OpenAI-compatible API (Ollama, LM Studio, vLLM)
- Import CLI conversation history feature
- Auto-updater built into the app
- Streaming message preview on Telegram bridge
- Permission confirmation buttons for sensitive operations
- Multi-provider switching in GUI
- Assistant Workspace for project context management
Codepilot cons
- Requires Node.js 18+ as a prerequisite
- Requires Claude Code CLI (separate installation if not auto-detected)
- Requires your own API key (not included)
- API usage fees charged by provider separately
- Only supports macOS 12+ and Windows 10+ (no Linux)
- Desktop app must keep running for Telegram bridge to work
- Multiple Claude Code installations can cause conflicts
- macOS may show 'unidentified developer' warning on first launch
Frequently asked questions about Codepilot
What is CodePilot?
CodePilot is a desktop workspace for Claude Code. It provides a graphical interface on top of the Claude Code CLI, integrating multi-provider management, MCP plugins, skills, message bridging, and the assistant workspace. It is built with Electron + Next.js [web:7].
What is the relationship between CodePilot and Claude Code CLI?
CodePilot is a graphical frontend for the Claude Code CLI. It calls Claude Code CLI capabilities through the Claude Agent SDK while adding GUI-exclusive features on top (multi-provider switching, bridging, gallery, etc.). You need to install the Claude Code CLI before using CodePilot [web:7].
Is CodePilot free?
Yes, CodePilot is open source and free to use. You need your own API key from a supported provider (Anthropic, OpenRouter, or others). API usage fees are charged by the provider, not by CodePilot [web:7].
What operating systems are supported?
CodePilot supports macOS 12+ (both Apple Silicon and Intel) and Windows 10+ (64-bit). Linux is not currently supported [web:5][web:7].
How do I get an API key?
API keys can be obtained from: Anthropic (console.anthropic.com), OpenRouter (openrouter.ai), GLM/Zhipu (open.bigmodel.cn), Kimi/Moonshot (platform.moonshot.cn), Volcengine (console.volcengine.com), Alibaba Cloud Bailian (dashscope.console.aliyun.com), AWS Bedrock, or Google Vertex [web:7].
Can I use a local LLM with CodePilot?
Yes. Any local service that provides an OpenAI-compatible API (Ollama, LM Studio, vLLM, etc.) can be connected as a custom API provider. Select Custom API in the provider settings and enter your local service URL [web:7].
What are the differences between Code/Plan/Q&A modes?
Code mode is the default where Claude can read and write files and execute commands, suitable for everyday development. Plan mode has Claude only analyze and propose solutions without executing actions, suitable for the planning phase. Q&A mode has Claude only answer questions without using any tools, suitable for pure Q&A [web:1][web:7].
How do I chat with Claude from my phone?
Use the Message Bridge feature to connect CodePilot to Telegram, Discord, Feishu, or QQ. Keep the desktop app running and you can chat with Claude from your phone through the configured messaging platform [web:7].
What should I do if Claude isn't responding?
Check that your API key is valid and has sufficient balance, check your internet connection, try switching to a different provider, check the MCP page for any server errors, or restart CodePilot [web:7].
How do I report a bug?
Open an issue on GitHub Issues. Include your OS and CodePilot version, steps to reproduce, and relevant error logs [web:7].