@aiclude/claude-code-channel

A bridge between AICLUDE AI agents and Claude Code sessions via the MCP Channel protocol.

Prerequisites: You need an AICLUDE account. Configure your agent with a Coding Agent connection in the pipeline settings to get started.

Overview

This package allows AICLUDE agents to delegate code-related tasks — such as code analysis, refactoring, bug fixes, and file modifications — to a local Claude Code session, and receive results back in real-time.

AICLUDE Agent ◀══ WebSocket ══▶ Channel Server ──▶ Claude Code
                                      ◀── reply ───┘

The Channel Server connects to AICLUDE automatically — no port forwarding, tunnels, or URL configuration needed.

Setup (2 steps)

Step 1. Get Your Token

In the AICLUDE web console, go to your agent's Pipeline settings, click Change to Coding Agent in the generation stage, and follow the setup guide. A connection token will be generated — copy it.

Step 2. Add to .mcp.json and Run

Create or edit .mcp.json in your project root:

{
  "mcpServers": {
    "aiclude-channel": {
      "command": "npx",
      "args": ["@aiclude/claude-code-channel", "--token", "YOUR_TOKEN_HERE"]
    }
  }
}

Then start Claude Code:

claude --dangerously-load-development-channels server:aiclude-channel

That's it! The Channel Server automatically connects to AICLUDE using the info embedded in the token.

Options

| Option | Description | Default | |--------|-------------|---------| | --token, -t | AICLUDE connection token (required) | — | | --timeout | Default task timeout in seconds | 300 |

Environment variable AICLUDE_TOKEN is also supported.

How It Works

The Channel Server runs as a subprocess managed by Claude Code. It plays two roles:

1. MCP Channel — Communicates with Claude Code over stdio using the claude/channel protocol.
2. WebSocket Client — Maintains a persistent outbound connection to AICLUDE, receiving commands and sending results through the same channel.

Security

• Outbound-only — The Channel Server initiates the connection; no ports are opened or exposed.
• Token authentication — The connection token is verified server-side before accepting the WebSocket.
• Automatic reconnection with exponential backoff on disconnection.
• Request body size limits and concurrent job caps.

Requirements

• Node.js 18+
• Claude Code v2.1.80+
• An AICLUDE account

License

Proprietary. Copyright (c) 2025-2026 AICLUDE. All rights reserved. This software is licensed for use exclusively with the AICLUDE platform.