한국어
문서
웹

웹

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

시작하기

웹 인터페이스를 시작합니다:

opencode web

이 명령은 127.0.0.1에 자동으로 선택된 포트로 로컬 서버를 시작하고 기본 브라우저에서 애플리케이션을 엽니다.

보안 참고: OPENCODE_SERVER_PASSWORD가 설정되지 않으면 서버에 보안이 적용되지 않습니다. 로컬 사용에는 문제없지만, 네트워크에 노출할 때는 반드시 설정해야 합니다.

설정 옵션

포트

사용자 정의 포트를 지정합니다:

opencode web --port 4096

호스트명

모든 네트워크 인터페이스에 바인딩합니다:

opencode web --hostname 0.0.0.0

기본적으로 서버는 127.0.0.1(localhost만)에 바인딩됩니다. 네트워크 접근을 허용하려면 0.0.0.0을 사용합니다.

mDNS 검색

로컬 네트워크 검색을 활성화합니다:

opencode web --mdns

이 명령은 자동으로 호스트명을 0.0.0.0으로 설정하고 로컬 네트워크에서 서버를 opencode.local로 광고합니다.

CORS

교차 출처 요청을 위한 추가 도메인을 허용합니다:

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

인증

비밀번호로 서버 접근을 보호합니다:

OPENCODE_SERVER_PASSWORD=secret opencode web

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

웹 인터페이스 기능

  • 세션: 홈페이지에서 활성 세션을 보고 관리합니다
  • 서버 상태: "See Servers" 옵션을 통해 연결된 서버에 접근합니다

터미널 연결

실행 중인 웹 서버에 터미널 TUI를 연결합니다:

opencode web --port 4096
opencode attach http://localhost:4096

이를 통해 브라우저와 터미널 모두에서 동시에 접근할 수 있습니다.

설정 파일

opencode.json에서 서버 설정을 구성합니다:

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

명령줄 플래그는 설정 파일 값을 재정의합니다.

CLIIDE