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

빠른 시작

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

전제 조건

  • macOS 또는 Linux (Windows WSL2 지원)
  • Node.js 18+ (일부 언어 서버용)
  • API 키 (OpenAI, Anthropic, 또는 Gemini)

설치

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

curl -sL opencode.ai/install | bash

API 키 구성

설치 후 선택한 AI 제공업체의 API 키를 구성해야 합니다. 이를 통해 Opencode가 AI 모델에 요청을 보낼 수 있습니다.

단계 1: API 키 가져오기

먼저 선호하는 AI 제공업체에서 API 키를 가져와야 합니다:

단계 2: API 키 구성

opencode auth login 명령을 실행하여 API 키를 구성합니다:

# 대화형 인증 시작
opencode auth login

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

API 키를 입력하라는 메시지가 표시됩니다. 입력하면 ~/.local/share/opencode/auth.json에 안전하게 저장됩니다.

프로젝트 초기화

Opencode가 프로젝트 구조를 더 잘 이해할 수 있도록 /init 명령으로 프로젝트를 초기화해야 합니다. 이렇게 하면 프로젝트 구조와 주요 구성요소를 문서화하는 AGENTS.md 파일이 생성됩니다.

/init 명령 사용

옵션 1: 터미널에서

프로젝트 디렉터리로 이동하여 실행합니다:

opencode init

옵션 2: TUI에서

Opencode TUI를 시작합니다:

opencode tui

그런 다음 /init 명령을 입력합니다:

/init

/init 명령이 하는 일

/init 명령은 다음을 수행합니다:

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

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

첫 번째 작업

API 키를 구성하고 프로젝트를 초기화했으므로 이제 Opencode를 사용할 준비가 되었습니다.

TUI 시작

opencode tui

작업 예시

다음은 시도해볼 수 있는 작업 예시입니다:

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

확인

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

  1. opencode models를 실행하여 구성된 제공업체의 사용 가능한 모델을 확인합니다
  2. opencode stats를 실행하여 사용 통계를 확인합니다
  3. “JavaScript에서 promises를 사용하는 방법을 설명해주세요”와 같은 간단한 쿼리를 시도합니다

다음 단계

  • 구성 페이지를 탐색하여 워크플로우에 맞게 Opencode를 사용자 정의합니다
  • CLI 참조를 확인하여 더 많은 명령을 알아봅니다
  • 생태계 페이지를 방문하여 커뮤니티 도구와 리소스를 발견합니다

Opencode로 즐거운 코딩을 즐기세요!