claude-auto-proxy

中文文档
0.4.1发布于 2026/11/03ES Module零依赖构建来源已验证

通过HTTP或SOCKS5代理路由macOS上的每个Claude Code连接,在不重新启动会话的情况下打开和关闭

中文使用文档
文档目录14 节
  1. “。”“。
  2. 【关键词】
  3. 설치
  4. 家酿
  5. npm
  6. [中文]:
  7. * * *
  8. 尾标器
  9. (client -proxy-router)
  10. 1 . a . 1 . a . 1
  11. 보안
  12. * * * * *
  13. 개발
  14. * * *

claude-auto-proxy

macOS에서의克劳德代码연결을HTTP·SOCKS5프록시로돌려주는도구입니다。【中文翻译 [qh [qh] [qh] [qh] [qh]

claude-auto-proxy onboard      # 프록시 주소 입력 → 연결 확인 → 등록 → 켜기
claude-auto-proxy off
claude-auto-proxy on

“。”“。

克劳德代码 HTTPS_PROXY大黄蜂:大黄蜂:大黄蜂

Claude-auto-proxy(克劳德-自动代理)。[footnotern.com] [footnoter.com] [footnoter.com] [footnoter.com]

【关键词】

Claude Code ──api.anthropic.com:443──▶ /etc/hosts → 127.0.0.1   (on/off는 이 블록만 넣고 뺍니다)
                                          │
                              릴레이 데몬 (launchd, 127.0.0.1:443)
                                          │  TLS ClientHello의 SNI로 목적지 확인
                                          │  TLS는 풀지 않고 바이트를 그대로 전달
                                          ▼
                              프록시 (HTTP CONNECT 또는 SOCKS5)
                                          ▼
                                  api.anthropic.com
  • Tls:超大型超大型。 克劳德代码는진짜人为서버의인증서를그대로검증하므로루트인증서를따로설치할필요가없습니다。
  • DNS亨廷顿、亨廷顿、亨廷顿。 2015-10-29 16:517:45 / 417:30 / 417:30 / 417:30 / 417:30 / 417:30 / 417:30로컬 /etc/hosts[qh] [qh] [qh]
  • ■■■■■■■ 프록시를바꿔도데몬을재시작할필요가없습니다。
  • [qh] 【大数据】【大数据】【大数据】【大数据】【大数据】【大数据】【大数据】【大数据】

설치

Node.js 20。

家酿

brew tap choiyounggi/claude-auto-proxy https://github.com/choiyounggi/claude-auto-proxy
brew install claude-auto-proxy

npm

npm install -g claude-auto-proxy

nvm같은버전관리자로설치를한节点쓰면,节点버그전을지웠을때데몬도멈춥니다。节点 claude-auto-proxy install◆◆◆◆◆家酿网。

[中文]:

$ claude-auto-proxy onboard
Enter the proxy address (for a claude-proxy-router, use `claude-auto-proxy router onboard`).
proxy: http://proxy.example.com:3128
checking http://proxy.example.com:3128 → api.anthropic.com:443
  [1/3] reach the proxy                ok (12 ms)
  [2/3] open a tunnel to the target    ok (48 ms)
  [3/3] TLS handshake with the target  ok (95 ms)
registered: http://proxy.example.com:3128
Turn routing on now? [Y/n]

■■■■■■■■■■■■■■■■■■■■■■■■■■

  1. [qh] [qh]
  2. 16 .大黄蜂 api.anthropic.com:443 터널을열어달라고요청합니다。
  3. [qh] [qh] [qh] [qh] [qh]

[qh] [qh] 하나라도실패하면어느단계에서왜막혔는지보여주고,아무것도저장하지않습니다。[qh host:port/ / / / / / / / / / / /[qh claude-auto-proxy onboard <url> --onn / n / n / n / n / n / n / n / n / n

* * *

시스템을바꾸는명령은실행하면sudo비밀번호를묻습니다。【翻译】 sudo[qh]

명령10 / 10
onboard [url] [--on]大黄蜂,大黄蜂,大黄蜂,大黄蜂,大黄蜂,大黄蜂
set-proxy <url>■■■■■■■■■■■■■ http://[user:pass@]host:port, https://…, socks5://host:port
on데몬이없으면설치하고,터널이열리는지확인하고,主机를바꾼뒤실제경로로한번더확인합니다。2015-10-16 16:517:23 2015-10-16 16:517:20
off* * * * * * * * * * *克劳德代码
status켜짐여부,데몬상태,터널상태를보여줍니다。Sudo * * * * * * * * * * * * * * * * * * * * * * *
hosts / hosts add <host> / hosts remove <host> / hosts reset경유할호스트목록을관리합니다
install[中文]:Node . Node .节点。
uninstall [--purge]“”“”“”“”“”“” --purge[qh] [qh

【翻译】【翻译 api.anthropic.com, mcp-proxy.anthropic.com, claude.ai, claude.com, platform.claude.com[qh]【中文】:http://github, http://github, http://github, http://github hosts add[qh]

尾标器

  • [size] size [size [qh] [qh]예: set-proxy http://100.64.0.10:3128
  • 尾尺度(Tailscale)用户空间(userspace [qh] [qh] tailscaled --tun=userspace-networking --socks5-server=localhost:1055* * * * onboard socks5://localhost:1055[qh]
  • ■■■■■■■■■■■■■■■■■ [qh /etc/hosts127.0.0.1 .0.0.1 .0.1 .1 .1 .1 .1 .1 .1 .1 .1 .1 .1 .1 .1 .1 .1 .1 .1 .1 .1 .1 .1 .1 .* * * on大数据:大数据:大数据:大数据:大数据:大数据:大数据:大数据量身定制的。超大型的。超大型的。超大型的 status[qh]

(client -proxy-router)

claude-proxy-router[中文]:[中文]:그맥에로그인된克劳德계정중여유가가장많은계정으로요청을대신보냅니다。라우터는HTTP连接터널이아니라평HTTP로문API요청자체를받기때문에,위의프록시방식(主机+릴레이)으로는붙을수없습니다。[qh] [qh] [qh API API。

$ claude-auto-proxy router onboard
Enter the router address and key (on the router Mac: claude-proxy-router key).
router address (e.g. http://100.64.0.10:18787): http://100.81.176.24:18787
router key:                                   ← 입력한 키는 화면에 표시되지 않습니다
  ping http://100.81.176.24:18787  ok (25 ms, 6 accounts available, router 0.1.0)
registered: http://100.81.176.24:18787 (key cpr_***xY)
Point Claude Code at the router now? [Y/n]
  • 2015-07-23 13:517:20:大黄蜂 /_router/ping[qh] pong[qh] [qh]■■■■■■■■■■■■■■■■■■【摘要】【摘要】【摘要】,【摘要】,【摘要】,【摘要】。
  • router on:克劳德代码 env에 ANTHROPIC_BASE_URL[qh ANTHROPIC_AUTH_TOKEN(超大型超大型)。【翻译 ~/.claude/settings.json,虎鲸 settings.json, $CLAUDE_CONFIG_DIR의 settings.json[qh][qh] [qh] [qh] [qh] [qh] [qh]
  • router off:。그사이손으로주소를바꾼파일은주소는두고라우터키만원래값으로되돌린뒤알려줍니다。되돌릴값은파일을바꾸기 전에 “”“”“”“”“”“”“ router off大黄蜂大黄蜂大黄蜂大黄蜂
  • settings.json大数据:大数据:大数据:大数据:大数据:大数据:大数据:大数据
  • Sudo。 大数据:大数据:大数据“root”(root)、“root”、“root”、“root”、“root”、“root”、“root”、“root”。
  • [qh] [qh] “”。“” env [qh] [qh] [qh] [qh] [qh]【中文】:大黄蜂,大黄蜂,大黄蜂
  • 라우터키가설정파일에들어가므로,켜있는동안설정파일은소유자만읽을수있게(0600)두고 router off [qh] [qh]★★★★★★★ env.ANTHROPIC_API_KEY·apiKeyHelperh; settings.local.json,셸 ANTHROPIC_API_KEY·ANTHROPIC_BASE_URL처럼라우터설정을덮을수있는값이있으면경고합니다。
  • router status[qh] [qh] 大黄蜂 /_router/status5、大表壳、大表壳、大表壳、大表壳、大表壳。ok, ok (not for Fable), full, limited until …, token …,, [qh]갱[qh] ok■■■■■■■■available/availableForFable,, limitPct 기준)을그대로쓰고,지금쓸수있는계정을먼저,그안에서는라우터점수가낮은(여유가많은)순서로보여줍니다。大黄蜂:大黄蜂generatedAt[qh][qh] [qh] [qh] [qh] [qh] [qh]라우터모드에서는克劳德代码의인증이라우터키뿐이라 /status·/usage■■■■■■■■■■■■■■■■■■■
  • [qh]i / i / i / i / i / i / i / i / i / i / i / i / i / i / i / i [qh] [qh] [qh]/api/claude_cli/bootstrap、快速模式、大容量、大容量、大容量 api.anthropic.com에직접보냅니다。[qh] [qh] router on과 router status[qh] .credentials.json에 claudeAiOauth[qh] .claude.json에 oauthAccount가있으면서그폴더의钥匙扣항목이있을때로그인으로봅니다(钥匙扣비밀값은읽지않습니다。[qh] .claude.json에계정이남아있으면서钥匙扣항목에MCP토큰만있을때는로그인으로잘못볼수있습니다。钥匙扣,超大型超大型,超大型超大型,超大型超大型,超大型超大型,超大型超大型,超大型超大型。有:有:有:有:有:有:有:有:有 /logout* * * * * *■■■■■■■■■■
  • settings.json의 env【克劳德代码 env[qh] [qh]
  • router on 逆戟鲸(Orca router on大黄蜂,大黄蜂,大黄蜂。 router status가파일별적용여부를보여주고,예전라우터주소·키가남은파일이있으면알려줍니다。
  • uninstall[qh]满腹满腹 router off[qh]

1 . a . 1 . a . 1

  • 大数据:大数据:大数据:大数据:大数据:大数据 이미열려있는연결은끊길때까지그대로쓰이고,새로맺는연결부터프록시를탑니다。2015-10-29 16:517:00 16:517:00 16:517:00
  • 같은호스트를쓰는다른앱도경유합니다。 /etc/hosts는맥전체에적용되므로克劳德데스크톱앱같은다른앱도이호스트에접속하면프록시를거칩니다。
  • Claude Code。 大数据:大数据:大数据:大数据:大数据:大数据 status变身变身变身变身变身变身变身变身变身 off大吼大吼。满满满满 set-proxy나 hosts大数据:大数据:大数据:大数据:大数据:大数据:大数据:大数据:大数据
  • * * * * * * * * ■■■■■■■■■■■■■■■■ on全无。全无。
  • TLS를검사하는프록시도쓸수있습니다。 * * * status“节点。”“节点。”“节点。”[qh] [qh] [qh] [qh] [qh] [qh]

보안

  • [qh] [qh] [qh] [qh] [qh] [qh] [qh]■■■■■■■■■■■ nobody 계정으로내려가서,외부에서들어온바이트해석이나프록시와의통신은根가아닌권한으로합니다。
  • [qh] [qh] [qh] npm·家酿 install이나 on [qh] /Library/Application Support/claude-auto-proxy/app(根发)。(根发)。[qh]
  • ■■■■■■ 데몬을시작하는节点실행파일자체家酿나는nvm경로에있어사용자가쓸수있습니다。사용자권한으로도는악성코드가그파일을바꿔치기하면,데몬이다시시작될때로根실행됩니다。 install■■■■■■■■막으려면根소유경로의节点(예:nodejs.org의공식pkg설치본, /usr/local/bin/node)로 install[qh]
  • [qh] [qh] [qh] (0640)。* *status·2015-10-16 16:517:30 ***大黄蜂:大黄蜂

* * * * *

경로내용
/Library/Application Support/claude-auto-proxy/config.json■■■■■■■■■■■■■■■■■■■■■■■■■■
/Library/Application Support/claude-auto-proxy/app/[qh] [qh] [qh
/Library/LaunchDaemons/io.github.choiyounggi.claude-auto-proxy.plist[qh]
/Library/Logs/claude-auto-proxy.log[qh] [qh] [qh] [qh]
/etc/hosts变身变身变身变身变身变身变身变身变身[qh /etc/hosts.claude-auto-proxy.bak你是谁
~/Library/Application Support/claude-auto-proxy/router.json* * * * * * * * * * * * router off[0600]

개발

npm test

【翻译】테스트는가짜HTTP·SOCKS5프록시와로컬TLS서버로전체경로를확인하며sudo가필요없습니다(릴레이테스트에는 openssl[qh]■■■■■ 文档/ DESIGN.md[qh]

* * *

主要的;主要的.github/workflows/ci.yml)。

  1. 全文:pdf (264kb)
    • feat!:大黄蜂 BREAKING CHANGE: →主要
    • feat: →小
    • “”“”“”“”“”“”“”“”“”“”“
    • docs:·chore:·ci:·test:·style:[qh] [qh]
  2. package.json 버전을올려커밋하고 vX.Y.Z 태그를붙여GitHub释放를만듭니다。
  3. “sha256” Formula/claude-auto-proxy.rb갱发财发财밋发财发财发财发财发财。 brew upgrade[qh]
  4. Npm。토큰없이npm의信任出版(GitHub行动OIDC)으로인증하므로,npm의패키지설정에이저장소의 ci.yml大黄蜂大黄蜂大黄蜂(npm trust github claude-auto-proxy --file ci.yml --repo choiyounggi/claude-auto-proxy --allow-publish).

[qh package.json大黄蜂:大黄蜂:大黄蜂:大黄蜂:大黄蜂。变身变身变身变身变身变身变身 github-actions[bot]主要,主要,主要,主要,主要,主要,主要,主要。

版本与发布记录

claude-auto-proxy 共发布 3 个版本,首次发布于 2026/11/03;过去 12 个月发布了 3 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.4.1latest2026/11/03今天
0.4.02026/11/03今天
0.0.0-stage2026/11/03今天

关于 claude-auto-proxy 的常见问题

claude-auto-proxy 是什么?

通过HTTP或SOCKS5代理路由macOS上的每个Claude Code连接,在不重新启动会话的情况下打开和关闭

如何安装 claude-auto-proxy?

在项目目录运行 npm install claude-auto-proxy,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 claude-auto-proxy,可以用 npx claude-auto-proxy 直接运行。

claude-auto-proxy 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/claude-auto-proxy 是否存在。

claude-auto-proxy 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

claude-auto-proxy 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20.11。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

claude-auto-proxy 可以商用吗?

claude-auto-proxy 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

claude-auto-proxy 还在维护吗?

最新版本 0.4.1 发布于 2026/11/03(今天);至今共发布 3 个版本,其中过去 12 个月发布了 3 个;首次发布于 2026/11/03。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。