Skip to main content
affpapa.org
RU EN
skill CX Codex

tg-ws-proxy-telegram-socks5 — Claude Code skill: setup and usage

Guides the setup of a local SOCKS5 proxy routing Telegram Desktop traffic to data centers over WebSockets. Useful for bypassing connection blocks without remote servers.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add reason-machines/trending-skills --skill tg-ws-proxy-telegram-socks5 -a claude-code
Open on GitHub

What tg-ws-proxy-telegram-socks5 does

This skill instructs coding agents how to deploy and configure tg-ws-proxy. The proxy defaults to port 1080. It detects Telegram DC IDs inside MTProto packets and establishes TLS WebSocket tunnels. Direct TCP serves as a fallback whenever a WebSocket connection returns an HTTP 302 status.

The assistant learns commands for building the project with pip install -e . or running background systemd services on Linux. Guidance covers CLI flags like --dc-ip for datacenter mappings and system tray executables for desktop environments.

If port 1080 is already occupied, the proxy fails until pointed to another port via --port. The skill also provides integration snippets for Python scripts using telethon or requests.

What it helps with

  • Deploy a local SOCKS5 proxy to route Telegram Desktop traffic
  • Tunnel connections to Telegram data centers over WebSockets
  • Build and run tg-ws-proxy from source
  • Route Telethon and Requests scripts through the local proxy
  • Change proxy listener ports during local port conflicts

Example prompts for the agent

  • Help me build and start tg-ws-proxy from source for Telegram Desktop
  • Telegram cannot connect, configure a local WebSocket tunnel proxy on port 1080
  • Show me how to route a Telethon script through the local tg-ws-proxy instance

How to install tg-ws-proxy-telegram-socks5

1Skills CLI (Vercel)

npx skills add reason-machines/trending-skills --skill tg-ws-proxy-telegram-socks5 -a claude-code

2Manually: put the files in place

~/.claude/skills/tg-ws-proxy-telegram-socks5/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/tg-ws-proxy-telegram-socks5/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about tg-ws-proxy-telegram-socks5

How do I install tg-ws-proxy-telegram-socks5 in Claude Code?

Run npx skills add reason-machines/trending-skills --skill tg-ws-proxy-telegram-socks5 -a claude-code in your terminal. This command registers the skill in Claude Code.

What does tg-ws-proxy-telegram-socks5 do?

It guides the assistant through deploying a local SOCKS5 proxy that encapsulates Telegram traffic inside WebSocket connections. This reconnects desktop clients and scripts to Telegram data centers without relying on remote third-party servers.

What should I do if port 1080 is already in use?

Start the proxy with an alternate port flag like tg-ws-proxy --port 1081. Afterwards, enter the new port number in the Telegram Desktop proxy settings.

Similar skills

SKILL.md skills catalog →
access official anthropics This skill manages Telegram channel access through a local JSON file. Use it for pairings, allowlists, and DM or group policy changes. 3,867installs configure official anthropics Saves a Telegram bot token and reviews access policy. Use it when setting up the channel or checking who can reach the bot. 3,861installs claude-to-im op7418 Forwards Claude replies to Telegram, Discord, Feishu, QQ or WeChat. Chat with the agent from your phone while the session stays on desktop. CX Codex +1 7,100installs mode-creator thedotmack Interactive helper to set up claude-mem for your specific workflow. Creates modes with custom observation types, concept tags, and optional Telegram notifications so your AI agent remembers what matters. CX Codex +1 1,300installs chat-sdk vercel Assists in building multi-platform TypeScript chat bots using Vercel's Chat SDK. Useful when configuring unified bot logic across Slack, Discord, Telegram, or WhatsApp. CX Codex +1 5,400installs telegram-mini-app sickn33 Skill for developing Telegram Mini Apps—web applications that run inside Telegram with a native-like experience. Covers Telegram Web App API, TON ecosystem, user authentication, and monetization through Telegram Stars. CX Codex +1 1,700installs

From the same set139

career-ops-job-search A job-search pipeline for Claude Code that scores vacancies, creates tailored PDF resumes, scans portals, and tracks applications. CX Codex +1 913installs creationix-rx-data-store This skill guides RX data encoding and direct reads from JSON-shaped documents. Use it when an agent needs path-based access without parsing the whole value. CX Codex +1 904installs agent-flow-visualization Installs the Agent Flow VS Code extension, which draws Claude agent orchestration as a live node graph: tool calls, branches, subagents, timings. CX Codex +1 887installs wewrite-wechat-ai-publishing Runs a WeChat Official Account article from trending topics to a saved draft: topic pick, copy, SEO, cover art, formatting. CX Codex +1 882installs mcp-brasil-public-apis Wires an agent into 28 Brazilian public APIs — economy, legislation, courts, elections, environment, health. 26 of them need no key. CX Codex +1 872installs holyclaude-ai-workstation Sets up a container with Claude, the CloudCLI web UI, a headless browser and five AI CLIs. Useful when you would rather not build the environment by hand. CX Codex +1 865installs obliteratus-abliteration This skill runs OBLITERATUS workflows that analyze and alter refusal behavior in LLMs. Use it when testing models from HuggingFace. CX Codex +1 864installs legalize-es-spanish-legislation Search and inspect Spanish legislation in Markdown files, then trace changes through Git. Useful for finding articles, checking revisions, and reviewing past versions. CX Codex +1 858installs

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor