# claude-auto-proxy 中文文档 规范地址：https://npmcn.com/package/claude-auto-proxy/ 版本：0\.4\.1 npm 元数据更新时间：2026-11-03T07:35:18.451Z 中文译文更新时间：2026-11-03T08:21:57.178Z 软件包许可：未声明 本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/claude-auto-proxy 原文对照：https://npmcn.com/package/claude-auto-proxy/?lang=original 项目主页：https://github.com/choiyounggi/claude-auto-proxy#readme 源码仓库：https://github.com/choiyounggi/claude-auto-proxy ## 关键信息（来自 npm 元数据） - 包体积（解压后）：99 kB，13 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：\>=20\.11 - 运行依赖：0 个 - 首次发布：2026-11-03T07:15:41.711Z - 最新版本发布：2026-11-03T07:35:18.088Z - 已发布版本数：3（近 12 个月 3 个） ## 中文简介 通过HTTP或SOCKS5代理路由macOS上的每个Claude Code连接，在不重新启动会话的情况下打开和关闭 ## 安装 ```sh npm install claude-auto-proxy ``` 也可以使用：`pnpm add claude-auto-proxy`、`yarn add claude-auto-proxy`、`bun add claude-auto-proxy` ## README # 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`大黄蜂：大黄蜂：大黄蜂 - **\[qh\] \[qh\]** 셸老外老外老外老外老外老外老外。 - **袜子。** 链接本文（[克劳德代码(Claude Code](https://code.claude.com/docs/en/network-config)） 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。 ### 家酿 ```bash brew tap choiyounggi/claude-auto-proxy https://github.com/choiyounggi/claude-auto-proxy brew install claude-auto-proxy ``` ### npm ```bash 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 --on`n / n / n / n / n / n / n / n / n / n ## \* \* \* 시스템을바꾸는명령은실행하면sudo비밀번호를묻습니다。【翻译】 `sudo`\[qh\] | 명령 | 10 / 10 | | --- | --- | | `onboard [url] [--on]` | 大黄蜂，大黄蜂，大黄蜂，大黄蜂，大黄蜂，大黄蜂 | | `set-proxy ` | ■■■■■■■■■■■■■ `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 ` / `hosts remove ` / `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/hosts`127.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](https://github.com/choiyounggi/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`·`apiKeyHelper`h； `settings.local.json`，셸 `ANTHROPIC_API_KEY`·`ANTHROPIC_BASE_URL`처럼라우터설정을덮을수있는값이있으면경고합니다。 - **`router status`\[qh\] \[qh\]** 大黄蜂 `/_router/status`5、大表壳、大表壳、大表壳、大表壳、大表壳。`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\] | ## 개발 ```bash npm test ``` 【翻译】테스트는가짜HTTP·SOCKS5프록시와로컬TLS서버로전체경로를확인하며sudo가필요없습니다(릴레이테스트에는 `openssl`\[qh\]■■■■■ [文档/ DESIGN.md](https://npmcn.com/package/claude-auto-proxy/docs/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 是什么？ 通过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 和提交记录判断。