跳到正文
机场翻墙指南
AI 专用机场

AI 开发者网络环境：API、终端、IDE 与容器的代理配置

AI 开发者网络环境配置指南：为 Claude Code、Codex CLI、OpenAI/Anthropic API、Git、npm、Docker 配置代理，以及 TUN 模式与环境变量的取舍。

更新于 3 篇相关文章2 个内容集群

简要回答

资料更新：

开发环境最常见的问题是“浏览器能用、终端不行”。解决方案有两种：开启客户端 TUN 模式，让系统层面所有程序走代理；或者为终端、Git、npm、Docker 分别配置代理。TUN 最省事，环境变量更可控。

学习路线

按顺序完成，每一步都链接到对应的详细教程。

  1. 1

    选择客户端模式 →

    系统代理还是 TUN？

  2. 2

    配置终端代理 →

    环境变量与持久化。

  3. 3

    安装 AI CLI →

    Claude Code、Codex CLI。

  4. 4

    排查连接错误 →

    超时、流中断、证书问题。

关于本专题

AI 编程工具让开发者的网络需求变得更复杂：同一个工作流里，模型 API、包管理器、Git 仓库、容器镜像都可能需要访问海外服务。

你可能是这些用户

  • 终端 AI 工具

    Claude Code、Codex CLI、Gemini CLI 等。

  • 调用模型 API

    Python / Node SDK 读取 HTTPS_PROXY。

  • 依赖下载

    Git、npm、pip、Docker 各自有代理配置方式。

常用代理配置速查

以本机代理端口 7897 为例（Clash Verge Rev 默认混合端口），按需替换：

  • Shell：export HTTPS_PROXY=http://127.0.0.1:7897 HTTP_PROXY=http://127.0.0.1:7897
  • PowerShell：$env:HTTPS_PROXY="http://127.0.0.1:7897"
  • Git：git config --global http.proxy http://127.0.0.1:7897
  • npm：npm config set proxy http://127.0.0.1:7897
  • 不需要走代理的地址写入 NO_PROXY，例如 localhost,127.0.0.1

内容集群

本专题下的子问题与对应文章，按阅读顺序排列。

开发环境代理

终端、Git、包管理器。

本集群文章正在整理中。

AI 编程工具

Claude Code 与 Codex。

延伸阅读：Claude Code 教程Codex 教程

更多相关文章

常见问题

Q

TUN 模式和系统代理有什么区别？

A

系统代理只是告诉“愿意读取系统设置”的程序去用代理；TUN 模式创建虚拟网卡，在网络层接管流量，对所有程序生效。

Q

WSL 里怎么走代理？

A

WSL2 可开启镜像网络模式（networkingMode=mirrored）后使用 127.0.0.1，或在 Clash 中开启“允许局域网连接”并使用 Windows 主机 IP。

Q

Docker 拉取镜像慢怎么办？

A

为 Docker Daemon 单独配置代理，或使用可用的镜像加速源。

相关专题

Codex 稳定机场

Codex 稳定机场与网络环境指南：Codex CLI、IDE 扩展与云端任务的网络需求，终端代理与 TUN 模式配置，stream disconnected 等常见错误排查。

进入专题 →

Claude Code 教程

Claude Code 中文教程：Windows / macOS / Linux 安装、账号登录、终端代理与 TUN 配置、CLAUDE.md 项目记忆、常用命令与常见网络错误处理。

进入专题 →

客户端配置问题

客户端配置问题排查：系统代理开启后不生效、TUN 模式无法开启、端口被占用、规则模式下部分网站无法访问、与其他 VPN 软件冲突等问题的解决方法。

进入专题 →

AI 编程工具

AI 编程助手对比：Claude Code、Codex、Cursor、GitHub Copilot 的工作方式、计费模式、适用场景与网络要求，帮助开发者选择合适的 AI 编程工具。

进入专题 →