CodePilotCodePilot

FAQ

Frequently asked questions about CodePilot.

FAQ

General

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. Built with Electron + Next.js.

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.

Is CodePilot free?

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.

What operating systems are supported?

  • macOS 12+ (Apple Silicon and Intel)
  • Windows 10+ (64-bit)

Installation & Configuration

"Node.js not found" on first launch

CodePilot requires Node.js 18+. The first-launch setup wizard will detect this and offer automatic installation. You can also install manually from nodejs.org.

How do I get an API key?

Can I use a local LLM?

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.

macOS says "cannot verify the developer"

Go to System Settings > Privacy & Security, find the CodePilot prompt, and click "Open Anyway".

Usage

What are the differences between Code / Plan / Q&A modes?

  • Code — Claude can read and write files and execute commands; suitable for everyday development
  • Plan — Claude only analyzes and proposes solutions without executing actions; suitable for the planning phase
  • Q&A — Claude only answers questions without using tools; suitable for pure Q&A

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.

What should I do if Claude isn't responding?

  1. Check that your API key is valid and has sufficient balance
  2. Check your internet connection
  3. Try switching to a different provider
  4. Check the MCP page for any server errors
  5. Restart CodePilot

How do I import CLI conversation history?

Use the import feature on the chat page to search for and import historical sessions from the Claude Code CLI.

Feedback & Support

How do I report a bug?

Open an issue on GitHub Issues. Please include:

  • Your OS and CodePilot version
  • Steps to reproduce
  • Relevant error logs

On this page

FAQGeneralWhat is CodePilot?What is the relationship between CodePilot and Claude Code CLI?Is CodePilot free?What operating systems are supported?Installation & Configuration"Node.js not found" on first launchHow do I get an API key?Can I use a local LLM?macOS says "cannot verify the developer"UsageWhat are the differences between Code / Plan / Q&A modes?How do I chat with Claude from my phone?What should I do if Claude isn't responding?How do I import CLI conversation history?Feedback & SupportHow do I report a bug?