네트워크

프록시 및 커스텀 인증서 구성.

OpenCode는 표준 프록시 환경 변수 및 기업 네트워크 환경을 위한 커스텀 인증서를 지원합니다.

프록시

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

[!CAUTION] TUI는 로컬 HTTP 서버와 통신합니다. 라우팅 루프를 방지하려면 이 연결에 대해 프록시를 우회해야 합니다.

CLI 플래그를 사용하여 서버의 포트 및 호스트명을 구성할 수 있습니다.

인증

프록시에 기본 인증이 필요한 경우 URL에 자격 증명을 포함하세요:

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

[!CAUTION] 비밀번호 하드코딩을 피하세요. 환경 변수 또는 안전한 자격 증명 저장소를 사용하세요.

NTLM 또는 Kerberos와 같은 고급 인증이 필요한 프록시의 경우 해당 인증 방법을 지원하는 LLM 게이트웨이 사용을 고려하세요.

커스텀 인증서

기업에서 HTTPS 연결에 커스텀 CA를 사용하는 경우 OpenCode가 신뢰하도록 구성하세요:

# 커스텀 CA 인증서 구성
export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem

이는 프록시 연결 및 직접 API 액세스에 적용됩니다.

기업 네트워크 고려사항

방화벽 구성

방화벽/프록시에서 다음 도메인이 허용되는지 확인:

opencode.ai - OpenCode 서비스
anthropic.com - Anthropic API
api.openai.com - OpenAI API
api.together.ai - Together AI API
기타 LLM provider 도메인

오프라인 설치

완전히 오프라인 환경의 경우:

GitHub releases에서 설치 패키지 다운로드
npm 또는 bun으로 로컬 설치
필요한 경우 외부 API 액세스를 위한 프록시 구성

VPN 구성

VPN 사용 시:

VPN이 로컬 포트에 간섭하지 않는지 확인
필요한 도메인을 VPN의 우회 목록에 추가
VPN이 DNS 설정을 수정하는지 확인