소개

OpenCode를 시작해 보세요.

OpenCode는 오픈소스 AI 코딩 에이전트입니다. 터미널 기반 인터페이스(TUI), 데스크톱 앱 또는 IDE 확장 프로그램으로 사용할 수 있습니다.

OpenCode TUI with the opencode theme

시작해봅시다.

전제 조건

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

최신 터미널 에뮬레이터(예: WezTerm, Alacritty, Ghostty, Kitty 등)
사용할 LLM 제공자의 API 키

설치

OpenCode를 설치하는 가장 쉬운 방법은 설치 스크립트를 사용하는 것입니다.

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

다음 명령으로도 설치할 수 있습니다:

Node.js 사용

npm install -g opencode-ai
# 또는
bun install -g opencode-ai
# 또는
pnpm install -g opencode-ai
# 또는
yarn global add opencode-ai

Homebrew 사용 (macOS 및 Linux)

brew install anomalyco/tap/opencode

Arch Linux에 설치

sudo pacman -S opencode           # Arch Linux (안정版)
paru -S opencode-bin              # Arch Linux (AUR 최신판)

Windows

권장: WSL 사용. Windows에서 최상의 경험을 위해 Windows Subsystem for Linux (WSL) 사용을 권장합니다.

choco install opencode # Chocolatey
scoop install opencode    # Scoop
npm install -g opencode-ai    # NPM
mise use -g github:anomalyco/opencode    # Mise
docker run -it --rm ghcr.io/anomalyco/opencode    # Docker

Windows에서 Bun을 사용하여 OpenCode 설치 지원은 현재 개발 중입니다.

Releases에서 바이너리를 다운로드할 수도 있습니다.

구성

OpenCode에서는 API 키를 구성하여 모든 LLM 제공자를 사용할 수 있습니다.

LLM 제공자를 처음 사용하는 경우 OpenCode Zen 사용을 권장합니다. OpenCode 팀이 테스트하고 검증한 모델 목록입니다.

TUI에서 /connect 명령을 실행하고 opencode를 선택한 후 opencode.ai/auth로 이동합니다.

/connect

로그인하고 결제 정보를 추가한 후 API 키를 복사합니다.
API 키를 붙여넣습니다.

또는 다른 제공자를 선택할 수도 있습니다. 자세히 알아보기.

초기화

이제 제공자를 구성했으니 작업할 프로젝트로 이동합니다.

cd /path/to/project
opencode

그런 다음 다음 명령을 실행하여 프로젝트의 OpenCode를 초기화합니다.

/init

이렇게 하면 OpenCode가 프로젝트를 분석하고 프로젝트 루트에 AGENTS.md 파일을 생성합니다.

사용법

이제 프로젝트에서 작업할 OpenCode를 사용할 준비가 되었습니다. 무엇이든 질문하세요!

AI 코딩 에이전트를 처음 사용하는 경우 다음 예제가 도움이 될 수 있습니다.

질문하기

OpenCode에 코드베이스를 설명하도록 요청할 수 있습니다.

@packages/functions/src/api/index.ts에서 인증은 어떻게 처리되나요?

작업하지 않은 코드베이스의 일부가 있을 때 유용합니다.

기능 추가

OpenCode에 프로젝트에 새 기능을 추가하도록 요청할 수 있습니다. 먼저 계획 생성부터 요청하는 것을 권장합니다.

1. 계획 생성

OpenCode에는 변경 기능을 비활성화하고 대신 기능을 구현할 방법을 제안하는 Plan 모드가 있습니다.

Tab 키를 사용하여 전환합니다. 오른쪽 하단에 표시기가 표시됩니다.

<TAB>

이제 원하는 것을 설명합니다.

사용자가 메모를 삭제하면 데이터베이스에서 삭제됨으로 표시하고 싶습니다.
그런 다음 최근 삭제된 메모를 모두 표시하는 화면을 만듭니다.
이 화면에서 사용자는 메모를 복원하거나 영구 삭제할 수 있습니다.

원하는 것을 이해할 수 있도록 OpenCode에 충분한 세부 정보를 제공해야 합니다. 팀의 주니어 개발자와 대화하듯이 대화하는 것이 좋습니다.

2. 계획 반복

계획을 제공받은 후 피드백을 제공하거나 세부 정보를 추가할 수 있습니다.

이전에 사용한 디자인을 사용하여 새 화면을 디자인하고 싶습니다.
[Image #1] 이 이미지를 확인하고 참조로 사용하세요.

3. 기능 빌드

계획에 만족하면 Tab 키를 다시눌러 Build 모드로 돌아갑니다.

<TAB>

변경하도록 요청합니다.

좋습니다! 변경을 계속 진행하세요.

변경하기

더 간단한 변경의 경우 계획을 먼저 검토할 필요 없이 OpenCode에 직접 빌드를 요청할 수 있습니다.

/settings 경로에 인증을 추가해야 합니다. @packages/functions/src/notes.ts의
/notes 경로에서 처리하는 방법을 확인하고 @packages/functions/src/settings.ts에
동일한 로직을 구현하세요.

OpenCode가 올바른 변경을 하도록 충분한 세부 정보를 제공하는지 확인하세요.

변경 취소

OpenCode에 변경을 요청했다고 가정해 보겠습니다.

@packages/functions/src/api/index.ts의 함수를 리팩토링할 수 있나요?

하지만 그것이 원하는 것이 아니라는 것을 깨달았습니다. /undo 명령을 사용하여 변경을 취소할 수 있습니다.

/undo

OpenCode는 수행한 변경을 취소하고 원래 메시지를 다시 표시합니다.

@packages/functions/src/api/index.ts의 함수를 리팩토링할 수 있나요?

여기서 프롬프트를 조정하고 OpenCode에 다시 시도하도록 요청할 수 있습니다.

OpenCode와의 대화를 팀과 공유할 수 있습니다.

/share

현재 대화 링크가 생성되어 클립보드에 복사됩니다.

OpenCode 대화 예시를 확인하세요.

사용자 정의

이제 OpenCode의 전문가가 되었습니다!

OpenCode를 나만의 것으로 만들기 위해 테마 선택, 키바인드 사용자 정의, 코드 포맷터 구성, 사용자 정의 명령 만들기 또는 OpenCode 구성을 살펴보는 것을 권장합니다.