Claude Code VKontakte Channel plugin
Claude Code channel plugin: chat with an agent session through a VK community from mobile or web
- 2 ★ on the repository
- Last commit
Broad access
Why this level
- Relays messenger input into an agent session that can run code on the machine
- Requires running Claude Code with the unapproved channels flag
- Stores a community token with messaging rights
Install
- Works in
- Services
Manual install
mkdir -p ~/.claude/plugins/marketplaces/local/plugins
cd ~/.claude/plugins/marketplaces/local/plugins
git clone https://github.com/nazbav/claude-code-vkontakte-channel.git vkontakte-channelThen create ~/.claude/plugins/marketplaces/local/.claude-plugin/marketplace.json following the README.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Relays messenger input into an agent session that can run code on the machine
- Requires running Claude Code with the unapproved channels flag
- Stores a community token with messaging rights
This is third-party code. Review the repository files before installing.
What it does
The plugin ports Claude Code's official Telegram channel to the VK Bot Long Poll API. Messages sent to a community land in the active Claude Code session, and the agent replies with reply, edit_message, react and download_attachment tools, including photos and documents. Claude Code permission requests appear in VK as buttons. Access is limited by pairing codes, an allowlist and mention-only mode in group chats, managed with the /vkontakte:access skill from the terminal only.
Who it is for. Developers who want to drive a Claude Code session from their phone via VK.
Good fit when
- You want to follow a long agent task and reply while away from the computer
- Telegram is unavailable or inconvenient while VK is always at hand
- You need to send photos and documents to the agent from your phone
Not a fit when
- You cannot run Claude Code with the development channels flag
- You need formatted replies: community bots send plain text only
Example request
Message me on VK when the tests pass, and send a screenshot of the error if they failLimitations
Requires Bun, Claude Code 2.1.80 or newer, and a VK community with a token and Long Poll enabled. The plugin is not on the approved channels list, so Claude Code must run with --dangerously-load-development-channels. Reactions are limited to eight emoji, edits work for 24 hours, and video arrives only as a player link. The repo was published in a single commit.
How to disable. Run Claude Code without the channel flag, uninstall with claude plugin uninstall vkontakte@local and revoke the community token. Settings and attachments live in ~/.claude/channels/vkontakte.
FAQ
Can I use a personal account instead of a community?
No, it needs a community token with messages, photos, docs and manage scopes.
Can a stranger message the agent?
Not by default: a new sender gets a code, and access opens only after /vkontakte:access pair in the terminal. The skill refuses access changes requested through the channel itself.
Discussion
No questions or reviews yet.
Related
All VK toolsVK video watching plugin
vk-video
A Claude Code plugin that analyzes video from vkvideo.ru, vk.com and vk.ru: downloads the clip, transcribes audio with whisper and extracts frames
A Claude Code skill for the full VK Ads cycle: campaigns, ad groups, banners, statistics, remarketing and lead forms via bash scripts
BotHelp analytics skill
claude-skill-bothelp
A Claude Code skill for the BotHelp Open API: a bot map, step-by-step drop-off, subscriber export and limited management via the open API
VK Ads skill for agencies
claude-skill-vk-ads
A Claude Code skill for VK Ads built for agencies: bulk operations, hashed remarketing audiences, ad-marking compliance and Google Sheets reports
VK chat-reading plugin via the browser
vk-api-mcp
A Claude Code plugin: a browser extension captures the VK web messenger token and exposes read-only chat access via MCP
MAX channel for Claude Code
max-gateway
A robust daemon and bridge plugin: talk to your Claude Code session from the MAX messenger, with photos, voice and buttons
README in short
The README explains the flow from the community bot to the Claude Code session and the token and Long Poll event requirements. Installation uses a local marketplace with a hand-written manifest, and events are enabled with a VK API call. It gives launch commands with the development channels flag, the pairing flow and all access commands. A table compares features with the Telegram channel. Apache-2.0 license.