OpenCode 支持 standard proxy environment variables(标准代理环境变量)以及 custom certificates(自定义证书),适用于企业网络环境。


Proxy(代理)

OpenCode 会遵循标准的 proxy environment variables(代理环境变量)。

  1. # HTTPS proxy(推荐)
  2. export HTTPS_PROXY=https://proxy.example.com:8080
  3. # HTTP proxy(如果无法使用 HTTPS)
  4. export HTTP_PROXY=http://proxy.example.com:8080
  5. # 为本地服务绕过代理(必需)
  6. export NO_PROXY=localhost,127.0.0.1

你可以通过 CLI flags 来配置 server 的端口和主机名。


Authenticate(代理认证)

如果你的 proxy 需要 basic authentication(基础认证),可以在 URL 中包含用户名和密码。

  1. export HTTPS_PROXY=http://username:password@proxy.example.com:8080

对于需要更高级认证方式(如 NTLM 或 Kerberos)的代理,建议使用支持对应认证方式的 LLM Gateway。


Custom certificates(自定义证书)

如果你的企业在 HTTPS 连接中使用自定义的 CAs(证书颁发机构),需要配置 OpenCode 去信任这些证书。

  1. export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem

该配置同时适用于 proxy 连接以及直接访问 API 的场景。