한국어
문서
웹

Web

브라우저에서 OpenCode 사용하기.

OpenCode는 브라우저에서 웹 애플리케이션으로 실행할 수 있으며, 터미널 없이도 동일한 강력한 AI 코딩 경험을 제공합니다.

시작하기

다음 명령을 실행하여 웹 인터페이스를 시작합니다:

opencode web

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

⚠️

OPENCODE_SERVER_PASSWORD가 설정되지 않으면 서버가 보호되지 않습니다. 로컬 사용에는 문제없지만, 네트워크 접근 시에는 설정해야 합니다.

최상의 경험을 위해 PowerShell 대신 WSL에서 opencode web을 실행하세요. 이렇게 하면 적절한 파일 시스템 접근과 터미널 통합이 보장됩니다.

설정

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

포트

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

opencode web --port 4096

호스트명

기본적으로 서버는 127.0.0.1(localhost만)에 바인딩됩니다. 네트워크에서 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 검색

mDNS를 활성화하여 로컬 네트워크에서 서버를 검색 가능하게 만듭니다:

opencode web --mdns

이렇게 하면 호스트명이 자동으로 0.0.0.0으로 설정되고 서버가 opencode.local로 광고됩니다.

동일한 네트워크에서 여러 인스턴스를 실행하기 위해 mDNS 도메인 이름을 사용자 정의할 수 있습니다:

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

CORS

CORS에 대한 추가 도메인을 허용하려면 (사용자 정의 프론트엔드에 유용):

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

인증

접근을 보호하려면 OPENCODE_SERVER_PASSWORD 환경 변수를 사용하여 비밀번호를 설정합니다:

OPENCODE_SERVER_PASSWORD=secret opencode web

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

웹 인터페이스 사용

시작되면 웹 인터페이스에서 OpenCode 세션에 접근할 수 있습니다.

세션

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

서버 상태

"See Servers"를 클릭하여 연결된 서버와 상태를 확인합니다.

터미널 연결

실행 중인 웹 서버에 터미널 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"]
  }
}

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

CLIIDE