웹

브라우저에서 OpenCode 사용.

OpenCode는 터미널 없이도 동일한 강력한 AI 코딩 경험을 제공하는 웹 애플리케이션으로 실행할 수 있습니다.

OpenCode 웹 - 새 세션

시작하기

웹 인터페이스를 시작하려면 다음을 실행합니다:

opencode web

이것은 사용 가능한 무작위 포트로 127.0.0.1에서 로컬 서버를 시작하고 기본 브라우저에서 자동으로 OpenCode를 엽니다.

[!CAUTION] OPENCODE_SERVER_PASSWORD가 설정되지 않으면 서버가 보호되지 않습니다. 로컬 사용에는 괜찮지만 네트워크 액세스에는 설정해야 합니다.

[!NOTE] Windows 사용자: 최상의 경험을 위해 PowerShell이 아닌 WSL에서 opencode web을 실행하세요. 이렇게 하면 올바른 파일 시스템 액세스 및 터미널 통합이 보장됩니다.

명령줄 플래그 또는 구성 파일에서 웹 서버를 구성할 수 있습니다.

기본적으로 OpenCode는 사용 가능한 포트를 선택합니다. 포트를 지정할 수 있습니다:

opencode web --port 4096

기본적으로 서버는 127.0.0.1 (로컬호스트만)에 바인딩됩니다. 네트워크에서 OpenCode에 액세스할 수 있도록 하려면:

opencode web --hostname 0.0.0.0

0.0.0.0을 사용하면 OpenCode는 로컬 및 네트워크 주소를 모두 표시합니다:

  Local access:       http://localhost:4096
  Network access:     http://192.168.1.100:4096

로컬 네트워크에서 서버를 검색할 수 있도록 mDNS를 활성화합니다:

opencode web --mdns

이것은 자동으로 호스트명을 0.0.0.0으로 설정하고 서버를 opencode.local로 광고합니다.

같은 네트워크에서 여러 인스턴스를 실행하려면 mDNS 도메인 이름을 사용자 정의할 수 있습니다:

opencode web --mdns --mdns-domain myproject.local

커스텀 프론트엔드가 OpenCode API에 액세스할 수 있도록 추가 도메인을 허용하려면:

opencode web --cors https://example.com

액세스를 보호하려면 OPENCODE_SERVER_PASSWORD 환경 변수를 사용하여 비밀번호를 설정합니다:

OPENCODE_SERVER_PASSWORD=secret opencode web

사용자명은 기본적으로 opencode이지만 OPENCODE_SERVER_USERNAME으로 변경할 수 있습니다.

시작하면 웹 인터페이스는 OpenCode 세션에 대한 액세스를 제공합니다.

홈페이지에서 세션을 보고 관리할 수 있습니다. 활성 세션을 보고 새 세션을 시작할 수 있습니다.

OpenCode 웹 - 활성 세션

“See Servers”를 클릭하여 연결된 서버 및 해당 상태를 볼 수 있습니다.

OpenCode 웹 - 서버 보기

실행 중인 웹 서버에 터미널 TUI를 연결할 수 있습니다:

# 웹 서버 시작
opencode web --port 4096
# 다른 터미널에서 TUI 연결
opencode attach http://localhost:4096

이렇게 하면 웹 인터페이스와 터미널을 동시에 사용할 수 있으며, 동일한 세션과 상태를 공유합니다.

opencode.json 구성 파일에서 서버 설정을 구성할 수도 있습니다:

{
  "server": {
    "port": 4096,
    "hostname": "0.0.0.0",
    "mdns": true,
    "cors": ["https://example.com"]
  }
}

명령줄 플래그는 구성 파일 설정보다 우선합니다.