한국어
문서
소개

소개

OpenCode는 터미널 인터페이스, 데스크톱 애플리케이션 또는 IDE 확장 프로그램으로 사용할 수 있는 오픈소스 AI 코딩 에이전트입니다. 개발자가 코드 관련 작업을 위해 AI와 상호작용할 수 있게 해줍니다.

사전 요구사항

터미널에서 OpenCode를 사용하기 전에 다음이 필요합니다:

  1. 현대적인 터미널 에뮬레이터 - 옵션 포함:

    • WezTerm (크로스플랫폼)
    • Alacritty (크로스플랫폼)
    • Ghostty (Linux 및 macOS)
    • Kitty (Linux 및 macOS)

  2. API 키 - 선택한 LLM 프로바이더의 인증 정보

설치

범용 설치

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

Node.js 패키지 매니저

# npm
npm install -g opencode-ai
 
# Bun
bun install -g opencode-ai
 
# pnpm
pnpm install -g opencode-ai
 
# Yarn
yarn global add opencode-ai

시스템 패키지 매니저

# Homebrew (macOS/Linux)
brew install anomalyco/tap/opencode
 
# Paru (Arch Linux)
paru -S opencode-bin
 
# Chocolatey (Windows)
choco install opencode
 
# Scoop (Windows)
scoop bucket add extras && scoop install extras/opencode
 
# Docker
docker run -it --rm ghcr.io/anomalyco/opencode

설정

  1. 터미널 인터페이스에서 /connect 명령어 실행
  2. 선호하는 프로바이더 선택
  3. opencode.ai/auth에서 인증
  4. 결제 정보 설정
  5. API 키 획득 및 입력

초보자를 위해 검증된 모델 컬렉션인 OpenCode Zen을 권장합니다.

프로젝트 초기화

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

cd /path/to/project
opencode

다음 명령으로 프로젝트 초기화:

/init

이것은 프로젝트 루트에 AGENTS.md 파일을 생성하며, 버전 관리에 커밋해야 합니다.

핵심 사용 패턴

코드베이스에 대한 질문

프로젝트 파일을 검색하려면 @ 사용:

How is authentication handled in @packages/functions/src/api/index.ts

기능 개발

  1. 계획 모드 (Tab 키) - AI가 변경 없이 구현 접근 방식 제안
  2. 반복 - 피드백과 시각적 참조로 계획 개선
  3. 빌드 모드 (Tab 키) - 승인된 변경 사항 실행

변경 사항 되돌리기

  • 실행 취소 명령: /undo
  • 다시 실행 명령: /redo
  • 여러 번 실행 취소 지원

협업

다음을 통해 대화 공유:

/share

클립보드에 복사되는 공유 가능한 링크가 생성됩니다.

개인화

경험 커스터마이징:

  • 테마 선택
  • 키보드 바인딩
  • 코드 포매터
  • 사용자 정의 명령어
  • 설정 구성
홈설정