컨텐츠로 건너뛰기
쇼케이스 생태계 문서

빠른 시작

5분 이내에 OpenCode를 시작하세요.

전제 조건

  • macOS, Linux 또는 Windows (WSL2 지원)
  • Node.js 18+ (일부 언어 서버용)
  • API 키 (내장 모델 사용 시 선택 사항)

설치

터미널에서 다음 명령을 실행하여 바이너리를 다운로드하고 설치합니다:

curl -fsSL https://opencode.ai/install | bash

더 많은 설치 옵션은 설치 페이지를 참조하세요.

인증

OpenCode는 빠르게 시작할 수 있는 여러 인증 옵션을 제공합니다.

옵션 1: 내장 무료 모델 (Zen)

가장 쉬운 시작 방법은 코딩에 최적화된 엄선된 AI 모델을 제공하는 OpenCode Zen을 사용하는 것입니다:

opencode auth login --provider zen

API 키가 필요 없습니다 - 바로 코딩을 시작하세요!

옵션 2: GitHub Copilot

GitHub Copilot 구독이 있는 경우:

opencode auth login --provider github

브라우저가 열리고 GitHub로 인증합니다.

옵션 3: ChatGPT Plus/Pro

ChatGPT Plus 또는 Pro 구독이 있는 경우:

opencode auth login --provider openai

ChatGPT 구독을 직접 사용합니다.

옵션 4: 사용자 지정 API 키

다른 제공업체의 경우 자신의 API 키를 구성할 수 있습니다:

# 대화형 인증 시작
opencode auth login

# 또는 특정 제공업체로 인증
opencode auth login --provider anthropic
opencode auth login --provider google

지원되는 제공업체:

API 키는 ~/.local/share/opencode/auth.json에 안전하게 저장됩니다.

프로젝트 초기화

OpenCode가 프로젝트 구조를 더 잘 이해할 수 있도록 /init 명령으로 프로젝트를 초기화하세요.

/init 명령 사용

옵션 1: 터미널에서

프로젝트 디렉토리로 이동하여 실행:

opencode init

옵션 2: TUI에서

OpenCode TUI 시작:

opencode tui

그런 다음 /init 명령 입력:

/init

/init 명령의 작동

/init 명령은:

  1. 프로젝트 디렉토리 구조를 스캔
  2. 주요 파일 및 구성 요소를 식별
  3. 프로젝트 루트에 AGENTS.md 파일 생성
  4. AI가 참조할 중요한 프로젝트 정보를 문서화

이를 통해 AI가 코드베이스를 더 잘 이해하고 더 정확하고 관련성 높은 응답을 제공할 수 있습니다.

첫 번째 작업

인증을 구성하고 프로젝트를 초기화했으므로 OpenCode를 사용할 준비가 되었습니다.

TUI 시작

opencode tui

에이전트 전환

OpenCode에는 두 개의 내장 에이전트가 포함되어 있습니다:

  • build (기본값): 개발 작업을 위한 완전 액세스 에이전트
  • plan: 분석 및 코드 탐색을 위한 읽기 전용 에이전트

Tab 키를 눌러 에이전트를 전환합니다.

예제 작업

시도해 볼 수 있는 몇 가지 예제 작업:

  1. 코드 설명: “이 프로젝트에서 인증 흐름이 어떻게 작동하는지 설명하세요”
  2. 버그 수정: “로그인 구성 요소의 버그를 찾아 수정하세요”
  3. 리팩토링: “사용자 프로필 구성 요소를 훅을 사용하도록 리팩토링하세요”
  4. 문서화: “API 엔드포인트에 대한 문서를 생성하세요”
  5. 테스트: “체크아웃 기능에 대한 단위 테스트를 작성하세요”

멀티 세션 지원

동일한 프로젝트 내에서 여러 에이전트를 병렬로 실행할 수 있습니다:

# 새 세션 시작
opencode tui

# 다른 터미널에서 다른 세션 시작
opencode tui

각 세션은 독립적으로 작동하며 다른 작업을 동시에 처리할 수 있습니다.

세션 링크 공유

참조 또는 디버깅을 위해 세션 링크를 공유할 수 있습니다:

opencode share <session-id>

이렇게 하면 다른 사람이 세션을 볼 수 있는 공유 가능한 링크가 생성됩니다.

확인

설정이 올바르게 작동하는지 확인:

  1. opencode models를 실행하여 구성된 제공업체에서 사용 가능한 모델 확인
  2. opencode stats를 실행하여 사용 통계 확인
  3. “JavaScript에서 프로미스를 사용하는 방법 설명”과 같은 간단한 쿼리 시도

다음 단계

  • 구성 페이지를 탐색하여 OpenCode를 워크플로에 맞게 사용자 지정
  • CLI 참조를 확인하여 더 많은 명령 학습
  • 생태계 페이지를 방문하여 커뮤니티 도구 및 리소스 발견
  • OpenCode Zen에 대해 알아보고 최적화된 AI 모델 확보

OpenCode로 즐거운 코딩 되세요!