proxychains

A guide to proxychains4, a tool that routes command-line network traffic through a proxy server. It is intended for cases where direct connections fail or access is blocked.

In plain words
What is it for?
It helps rerun commands such as curl, wget, git, pip, npm, or yarn through the configured proxy.
Why use it?
It provides a way to retry commands affected by timeouts, DNS errors, connection refusals, or blocked access to services such as GitHub, PyPI, and npm.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/2025emma/vibe-coding-cn/proxychains
Any agent
npx skills add 2025Emma/vibe-coding-cn --skill proxychains
Clone the repo
git clone --depth 1 https://github.com/2025Emma/vibe-coding-cn

Made for: Claude Code, Codex.

Per session 0 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,901 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 2 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00000 $0.01901
Opus 5 $0.00000 $0.00950
Sonnet 5 $0.00000 $0.00380
Haiku 4.5 $0.00000 $0.00190

Measured 2d ago against content hash 87f3941973b5, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade B, and why

proxychains scanned grade B with 2 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/setup-proxy.sh), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Asks for rootmediumPrivilege escalation

A mod that escalates privileges can change anything on the machine, not only the project.

sudo apt install proxychains4 # Debian/Ubuntu

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

- ❌ curl/wget/git/pip 等命令失败
Origin

Copies of this mod

1 near-identical copy found in the catalogue:

i18n/en/skills/proxychains/SKILL.md · 293 lines

How it starts

The opening of the file, as written. The whole thing — 293 lines — stays where its author put it; the contents beside it link to each section on GitHub.

TRANSLATED CONTENT:

name: proxychains description: Auto-detect network issues and force proxy usage with proxychains4. Use this skill when encountering connection timeouts, DNS failures, or blocked network access. Default proxy is http://127.0.0.1:9910

Proxychains Network Proxy Skill

自动使用代理解决网络问题 - 当遇到网络连接失败、超时或访问受限时,自动使用 proxychains4 强制走代理。

When to Use This Skill

触发条件(自动应用):

  • ❌ Connection timeout errors
  • ❌ DNS resolution failures
  • ❌ "Connection refused" errors
  • ❌ HTTP 403/451 blocked access
  • ❌ GitHub/PyPI/npm 等国外资源访问失败
  • ❌ curl/wget/git/pip 等命令失败

Claude 应该:

  1. 检测到网络错误后,自动在命令前添加 proxychains4
  2. 使用默认代理配置:http://127.0.0.1:9910
  3. 如果代理失败,提示用户检查代理服务状态

Quick Reference

基本用法模式

# ❌ 原命令失败
curl https://github.com/user/repo

# ✅ 使用代理重试
proxychains4 curl https://github.com/user/repo

常见场景自动应用

场景 1: Git 操作失败

# 原命令
git clone https://github.com/user/repo.git

# 自动改为
proxychains4 git clone https://github.com/user/repo.git

场景 2: Python pip 安装失败

# 原命令
pip install requests

# 自动改为
proxychains4 pip install requests

场景 3: npm/yarn 安装失败

# 原命令
npm install package-name

# 自动改为
proxychains4 npm install package-name

场景 4: wget/curl 下载失败

# 原命令
wget https://example.com/file.tar.gz

# 自动改为
proxychains4 wget https://example.com/file.tar.gz

场景 5: Docker 拉取镜像失败

# 原命令
docker pull image:tag

# 自动改为
proxychains4 docker pull image:tag

场景 6: SSH 连接失败

# 原命令
ssh user@remote-host

# 自动改为
proxychains4 ssh user@remote-host

配置详情

默认代理配置

本地代理地址: http://127.0.0.1:9910

配置文件位置:

  • ~/.proxychains/proxychains.conf (推荐)
  • /etc/proxychains.conf (系统级)

快速配置脚本

创建用户级配置(自动使用 127.0.0.1:9910):

mkdir -p ~/.proxychains
cat > ~/.proxychains/proxychains.conf << 'EOF'
# Proxychains configuration
strict_chain
proxy_dns
remote_dns_subnet 224
tcp_read_time_out 15000
tcp_connect_time_out 8000

[ProxyList]
http 127.0.0.1 9910
EOF

Read the full file on GitHub · 293 lines

Files

What ships with it

6 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 293 lines · 0 tokens per session scan B 87f3941973b5

Subscribe to this mod's changes

proxychains is a skill published in the GitHub repository 2025Emma/vibe-coding-cn (22,815 stars, last pushed 8mo ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 1,901 tokens. A static security scan graded it B with 2 findings (asks for root, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

planning-with-files-ar

تخطيط مستمر قائم على الملفات لعمل وكلاء الذكاء الاصطناعي متعدد الخطوات. يحتفظ بملفات taskplan.md و findings.md و progress.md على القرص، وتحقن خطافات دورة الحياة سياق التخطيط المحدد للمشروع. تقرأ الاستعادة التلقائية ملفات تخطيط المشروع فقط. يمكن للأمر الصريح session-catchup.py --metadata فحص بيانات وصفية لجلسات الوكيل…

OthmanAdi/planning-with-files · 189 tokens

kl-consistency-test

Write, calibrate, and debug the prefill-vs-decode logprob (KL) consistency tests in sglang -- the two independent conditions a zero requires (every operator batch-invariant, and the two paths computing the same function), which helper separates them, how to pick a threshold once they hold, and how to localize a…

sgl-project/sglang · 108 tokens

i18n-localization

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

vudovn/ag-kit · 27 tokens

baoyu-youtube-transcript

Downloads YouTube video transcripts/subtitles and cover images by URL or video ID. Supports multiple languages, translation, chapters, and speaker identification. Caches raw data for fast re-formatting. Use when user asks to "get YouTube transcript", "download subtitles", "get captions", "YouTube字幕", "YouTube封面"…

JimLiu/baoyu-skills · 107 tokens

indication-dossier

Build a source-backed biomedical indication dossier. Use when a research task asks for disease biology, target rationale, patient segmentation, biomarkers, trials, drugs, competitive landscape, or translational evidence.

companion-inc/feynman · 43 tokens

seedance-vocab-ja

This skill should be used when the user asks for Japanese Seedance 2.0 prompt wording, Japanese cinematic vocabulary, or translation of camera, lighting, action, VFX, audio, and production terms into Japanese.

Emily2040/seedance-2.0 · 50 tokens