macOS：安装与首次检查

你要确认的结果是：Claude 的哪些连接和凭据已经受控，哪些还需要处理。先看范围，再进行安装和检查。

系统要求

CCIso macOS 版是 PKG 安装包，通用版（Apple 芯片与 Intel），需要 macOS 13 Ventura 及以上；已用 Developer ID 签名并经 Apple 公证。软件免费。

安装前先确认

• 你的 Claude 使用场景需要连接规则、特定凭据保护和状态检查。
• 你已准备好一个通道：自有的 SOCKS5 或 HTTP 地址、隧道分享链接（hysteria2 / vless / vmess / trojan / ss）、普通 WireGuard（wg-quick）配置文件，或隧道密钥文件。CCIso 不提供出口服务。
• 安装需要一次管理员密码：安装程序会把 CCIso 装进「应用程序」文件夹，并安装一个后台服务。
• 当前没有完整私人目录隔离或外发内容审查。如果这是你的必要条件，请先读保护范围。

安装与首次检查

1. 在下载页下载安装包，按页面说明核对 SHA256。也可以在终端进入下载目录，运行 spctl -a -vv -t install CCIso-0.1.7.pkg（换成实际文件名），结果应包含 source=Notarized Developer ID。

2. 双击安装包。macOS 安装器会请求一次管理员密码，用来把 CCIso 装进「应用程序」并安装后台服务。

3. 安装完成后 CCIso 会自动打开。选择通道：把密钥文件拖进窗口，或粘贴分享链接、你自己的代理地址。

4. 点「测试连通」，通过后开启隔离。登录 Claude 仍由你本人完成。

5. 运行「检测」查看结果。如果已有 Claude 进程尚未纳入，先保存任务，再按提示重开；重开后再次检查。不要把旧窗口仍能联网当成保护证据。

首次检查的完成标准：相关入口、规则、进程与连接测试都有明确结果；未知或未完成的项目仍需处理。这只证明列出的检查项，不证明所有私人文件不可读。

激活

软件免费，未激活也能使用基础保护。要开启常开、自动更新与彻底清理，在 CCIso 里打开「激活」，粘贴激活码，点「激活」。这台电脑的编号显示在「关于」里。

卸载

在 CCIso 里打开「设置 → 卸载」。卸载会解除隔离，Claude 恢复直接联网。

不用 CCIso 时的手动代理配置

这部分是 Claude Code 的配置参考，不需要 CCIso，也不会增加私人文件隔离。命令依据 Anthropic 文档；本页未在你的代理环境中执行连通测试。

假设你自己的 HTTP 代理正在本机 8080 端口运行，在终端执行：

export HTTPS_PROXY=http://127.0.0.1:8080
claude

将示例端口替换为自己的端口。该变量影响此终端之后启动的进程；已在运行的会话需要重开。进入 Claude Code 后运行 /status，Proxy 一行应显示你设置的地址。地址正确只说明配置已读取，实际连通性还要另行确认。

若需要让后台会话也读取配置，可把变量合并到 ~/.claude/settings.json 的 env 中，保留已有配置：

{
  "env": {
    "HTTPS_PROXY": "http://127.0.0.1:8080"
  }
}

从 Dock 打开的编辑器不等于从这个终端启动；不能假定它继承了刚才的变量。后台监管进程也可能保留较早的环境。先让后台任务完成，再按 Anthropic 文档决定是否运行 claude daemon stop --any 让监管进程重新启动。

不要把真实代理密码提交到项目配置中。若已有小写代理变量或托管设置，先检查它们是否覆盖了当前设置。

遇到问题

• 地址被判为无效：确认带有正确的 HTTP 或 HTTPS 协议前缀，不把 SOCKS5 地址直接写进 Claude Code。
• 终端可用、编辑器不可用：检查两者实际读取的配置和启动环境。
• 连接成功但不确定隐私范围：查看工作原理，不要用联网结果代替文件权限判断。

继续阅读自有代理与排错。依据：Anthropic 的网络配置文档，查阅于 2026-11-01。