OpenCode 支持 standard proxy environment variables(标准代理环境变量)以及 custom certificates(自定义证书),适用于企业网络环境。
Proxy(代理)
OpenCode 会遵循标准的 proxy environment variables(代理环境变量)。
# HTTPS proxy(推荐)export HTTPS_PROXY=https://proxy.example.com:8080# HTTP proxy(如果无法使用 HTTPS)export HTTP_PROXY=http://proxy.example.com:8080# 为本地服务绕过代理(必需)export NO_PROXY=localhost,127.0.0.1
你可以通过 CLI flags 来配置 server 的端口和主机名。
Authenticate(代理认证)
如果你的 proxy 需要 basic authentication(基础认证),可以在 URL 中包含用户名和密码。
export HTTPS_PROXY=http://username:password@proxy.example.com:8080
对于需要更高级认证方式(如 NTLM 或 Kerberos)的代理,建议使用支持对应认证方式的 LLM Gateway。
Custom certificates(自定义证书)
如果你的企业在 HTTPS 连接中使用自定义的 CAs(证书颁发机构),需要配置 OpenCode 去信任这些证书。
export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem
该配置同时适用于 proxy 连接以及直接访问 API 的场景。
