网络

OpenCode 支持标准的代理环境变量，也支持在企业网络环境下配置自定义证书。

---

代理（Proxy）

OpenCode 会遵循常见的代理相关环境变量：

# HTTPS 代理（推荐）
export HTTPS_PROXY=https://proxy.example.com:8080

# HTTP 代理（如果没有 HTTPS 代理）
export HTTP_PROXY=http://proxy.example.com:8080

# 为本地服务绕过代理（必须配置）
export NO_PROXY=localhost,127.0.0.1

警告

TUI 会与本地 HTTP Server 通信。如果不为本地连接配置 NO_PROXY 绕过代理，可能会导致请求循环转发或失败。

你可以通过 CLI 参数 配置 Server 的端口和主机名。

---

代理认证

如果代理需要 Basic Auth，可以在 URL 中携带凭证：

export HTTPS_PROXY=http://username:[email protected]:8080

警告

不要在代码中硬编码密码。推荐通过环境变量或安全的凭证管理系统来注入。

如果代理使用更复杂的认证方式（如 NTLM、Kerberos 等），可以考虑使用支持这些认证方式的 LLM Gateway 作为中间层，然后让 OpenCode 连接到该 Gateway。

---

自定义证书

如果企业环境中为 HTTPS 使用了自签名或私有 CA，可以通过环境变量让 OpenCode 信任这些证书：

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

这对通过代理的连接和直接访问 API 都同样生效。