Claude Code VKontakte Channel
Claude Code channel plugin: chat with an agent session through a VK community from mobile or web
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.
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.
Security check
- 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
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.
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.
Related
Open-source personal AI assistant on your own machine: answers in Telegram, Slack, Discord and WhatsApp, extended with skills and plugins
A self-improving agent from Nous Research with a TUI, messaging gateway, cron jobs and skills it writes itself
An open source coding agent for the terminal and desktop with build and plan modes
Open prompt library with a Claude Code plugin, MCP server and CLI: search, fetch and improve prompts and skills from an agent