跳到正文

配置自有代理与凭据

连接规则回答的是「Claude 通过哪里联网」。它是隐私保护的一层;它不决定 Claude 可以读取哪些私人文件,也不检查连接中发送了什么。

准备主机、端口,以及代理要求的用户名和密码。无凭据的地址格式示例:

类型 示例
SOCKS5 socks5://203.0.113.10:1080
HTTP http://203.0.113.10:8080

这些是格式示例,不能用来连接。不要把真实密码放进项目文件、截图或提交给他人的诊断信息。

  1. 选择通道时,在 CCIso 里粘贴你自己的代理地址和凭据。确认主机与端口来自你自己的配置。

  2. 点「测试连通」,通过后开启隔离。后台服务在安装时已经装好(macOS 安装器会请求一次管理员密码);未完成这一步前,不把设置视为已生效。

  3. 运行「检测」查看结果:规则是否存在、转发服务是否可用、目标进程是否纳入、连接测试是否完成。按待处理项逐项解决。

当前 macOS 底层实现把代理秘密保存到仅系统管理员身份可访问的目录,文件权限限制为该身份读写,再通过内存管道交给转发引擎。它不是已经完成的系统钥匙串集成,也不代表磁盘没有明文。

这些权限用于保护 CCIso 保存的副本。若你还在项目配置或其他文件中保留了同一密码,那些副本需要单独处理。

Anthropic 的网络配置文档说明 Claude Code 不直接支持 SOCKS 代理。CCIso 的本机转发引擎衔接 HTTP 代理入口和你配置的 SOCKS5 出口,因此不需要把 SOCKS5 地址直接填入 Claude Code 的代理变量。

如果你的代理本来提供 HTTP 入口,可以先参考对应平台的手动设置:macOS、Windows、Linux。手动代理变量不建立私人文件隔离。

先区分主机没有联网、代理地址或认证错误、系统规则未生效、进程尚未纳入这几种情况。不要仅凭「连不上」推定保护已经生效,也不要仅凭「连得上」推定所有保护都正常。

本机 MCP 服务、局域网地址和其他网络工具可能涉及额外规则。它们的覆盖与共存情况尚未公布完整实测说明;当前不承诺自动识别并放行所有服务。

外部配置依据查阅于 2026-11-01。CCIso 的操作说明依据 macOS 0.1.7 版本。