---
title: "Supported Coding Agents"
description: "Complete guide to all coding agents supported by Vibe Kanban, including installation and authentication instructions"
---

Vibe Kanban integrates with a variety of coding agents. These agents are available via `npx` and can be selected when creating task attempts.

<AccordionGroup>

<Accordion title="Claude Code" icon="code">
**Anthropic's Claude Code**

## Installation
Claude Code is now available via npx - no separate installation required!

## Authentication
You need to authenticate with Claude Code outside of Vibe Kanban before using it. Please follow the authentication instructions on the [Claude Code GitHub page](https://github.com/anthropics/claude-code).
</Accordion>

<Accordion title="OpenAI Codex" icon="code">
**OpenAI Codex integration**

## Installation
OpenAI Codex is now available via `npx` - no separate installation required!

## Authentication
You need to authenticate with OpenAI Codex outside of Vibe Kanban before using it. Please follow the authentication instructions from the [OpenAI help center](https://help.openai.com/en/articles/11369540-using-codex-with-your-chatgpt-plan) to use Codex with your ChatGPT plan.

Alternatively, Codex can be used via the OpenAI API by setting the `OPENAI_API_KEY` environment variable. For more details, see the [OpenAI documentation](https://developers.openai.com/codex/pricing/#use-an-openai-api-key)
</Accordion>

<Accordion title="Amp" icon="code">
**Amp code completion agent**

## Installation
Amp is now available via npx - no separate installation required!

## Authentication
You need to authenticate with Amp outside of Vibe Kanban before using it. Please follow the authentication instructions on the [Amp Owner's Manual](https://ampcode.com/manual#install).
</Accordion>

<Accordion title="GitHub Copilot" icon="code">
**GitHub Copilot CLI**

## Installation
GitHub Copilot CLI is available via npm. Install it globally:

```bash
npm install -g @github/copilot
```

## Prerequisites
- A GitHub Copilot subscription
- Node.js version 22 or later
- npm version 10 or later

## Authentication
When you first start Copilot CLI, you'll be prompted to authenticate. Follow the on-screen instructions to log in to your GitHub account using the `/login` command. For more details, see the [GitHub Copilot CLI documentation](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/use-copilot-cli).
</Accordion>

<Accordion title="Cursor CLI" icon="code">
**Cursor's command-line agent**

## Installation
Install Cursor CLI using the official guide: https://docs.cursor.com/en/cli/installation. On most systems you can run `curl https://cursor.com/install -fsS | bash`, then verify with `cursor-agent --version`.

## Authentication
Sign in with `cursor-agent login` (opens a browser). You can also set the `CURSOR_API_KEY=...` environment variable. Full instructions: https://docs.cursor.com/en/cli/reference/authentication
</Accordion>

<Accordion title="CCR (Claude Code Router)" icon="code">
**Orchestrate multiple Claude Code models**

CCR (Claude Code Router) lets you route coding prompts across different LLM providers and models, and select specialised models for specific tasks like long context, background work, or image understanding.

## Installation
CCR is available via `npx` – no separate installation required.

```bash
npx -y @musistudio/claude-code-router ui
```

This launches the CCR local UI where you configure providers and models.

## Authentication
Authenticate and configure CCR outside of Vibe Kanban. Follow the instructions on the CCR GitHub repo:

- GitHub: https://github.com/musistudio/claude-code-router

You'll add providers, set API keys, and register model names in the CCR UI or via CCR's JSON configuration (see the CCR repo for the schema and file location).

## Configure CCR (Providers and Models)

Configure CCR either via the UI or JSON config.

In the CCR UI (`npx -y @musistudio/claude-code-router ui`):

1) Add providers
- Choose a provider (e.g., `openrouter`, `deepseek`, etc.).
- Enter the required API key(s) and settings for that provider.

2) Add models
- For each provider, register the model identifier (e.g., `moonshotai/kimi-k2-0905`, `deepseek-chat`).
- CCR supports configuring different models for specific cases:
  - `default`: general coding
  - `background`: lightweight/background operations
  - `think`: models that support "thinking" modes
  - `longContext`: very long inputs/files
  - `webSearch`: models that support web/tool use
  - `image`: models with vision capabilities

Note: not all models support web search, thinking, or images. Choose models accordingly in the CCR UI.

### Configure via JSON (optional)
CCR can also be configured via its JSON configuration file. Refer to the CCR GitHub documentation for the exact schema, keys, and file location. Define providers (with API keys) and map the model cases (`default`, `background`, `think`, `longContext`, `webSearch`, `image`) to specific provider/model pairs.

### Example: OpenRouter provider configured in CCR UI

<Frame>
<img src="/images/ccr-openrouter-ui.png" alt="OpenRouter configured in CCR UI" />
</Frame>

### Example: CCR model mapping (default/background/think/etc.)

<Frame>
<img src="/images/ccr-config-example.png" alt="CCR models configuration example" />
</Frame>

## Configure Vibe Kanban

Vibe Kanban does not ship a default configuration for CCR. Add configurations to the existing Claude Code agent:

1) Open the "Coding Agent Configurations" page.
2) Add a new configuration for the Claude Code agent (or edit an existing one).
3) Enable the `claude_code_router` checkbox.
4) Optionally set a model string to target a specific CCR provider/model.

See the [Agent Profiles & Variants](/configuration-customisation/agent-configurations) guide for managing agent configurations.

Model string format: `<provider>,<model-name>`

Examples:
```text
openrouter,moonshotai/kimi-k2-0905
deepseek,deepseek-chat
```

Tips:
- Create multiple configurations if you want easy switching between different models.
- Leave the model string empty if you want CCR to use its own routing based on your CCR UI configuration (e.g., its `default`/`longContext`/etc. mappings).

### Example: Claude Code agent configuration in Vibe Kanban

<Frame>
<img src="/images/vk-ccr-agent-config.png" alt="Claude Code agent configuration in Vibe Kanban" />
</Frame>

## Using CCR in Vibe Kanban

When creating a Task Attempt, select the coding agent and configuration: choose the Claude Code agent, then pick one of your CCR-enabled configurations.

## Troubleshooting

- Authentication errors: verify your API keys/provider settings in CCR (via UI or JSON config).
- Model not found: confirm the model identifier is correct for the chosen provider.
- Missing features (webSearch/think/image): switch to a model that supports the capability and update your CCR mapping (via UI or JSON config).
</Accordion>



<Accordion title="Gemini CLI" icon="code">
**Google Gemini CLI**

## Installation
Gemini CLI is now available via npx - no separate installation required!

## Authentication
You need to authenticate with Gemini CLI outside of Vibe Kanban before using it. Please follow the authentication instructions on the [Gemini CLI GitHub page](https://github.com/google-gemini/gemini-cli).
</Accordion>

<Accordion title="OpenCode" icon="code">
**SST's OpenCode**

## Installation
OpenCode is now available via `npx` - no separate installation required!

## Authentication
You need to authenticate with OpenCode outside of Vibe Kanban before using it. Please follow the authentication instructions on the [OpenCode GitHub page](https://github.com/sst/opencode).
</Accordion>

<Accordion title="Qwen Code" icon="code">
**Qwen code-focused assistant**

## Installation
Qwen Code is available via npx - no separate installation required!

## Authentication
You need to authenticate with Qwen outside of Vibe Kanban before using it. Please follow the authentication instructions in the official Qwen documentation: https://github.com/QwenLM/qwen-code
</Accordion>

</AccordionGroup>