소개

OpenCode를 시작하세요.

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

시작해 봅시다.

사전 요구사항

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

• 다음과 같은 현대적인 터미널 에뮬레이터:
  • WezTerm (opens in a new tab), 크로스플랫폼
  • Alacritty (opens in a new tab), 크로스플랫폼
  • Ghostty (opens in a new tab), Linux 및 macOS
  • Kitty (opens in a new tab), Linux 및 macOS
• 사용하려는 LLM 프로바이더의 API 키

설치

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

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

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

• Node.js 사용

npm install -g opencode-ai

• macOS 및 Linux에서 Homebrew 사용

brew install anomalyco/tap/opencode

최신 릴리스를 위해 OpenCode tap 사용을 권장합니다. 공식 brew install opencode 포뮬러는 Homebrew 팀에서 관리하며 업데이트 빈도가 낮습니다.

• Arch Linux에서 Paru 사용

paru -S opencode-bin

Windows

• Chocolatey 사용

choco install opencode

• Scoop 사용

scoop install opencode

• NPM 사용

npm install -g opencode-ai

• Mise 사용

mise use -g github:anomalyco/opencode

• Docker 사용

docker run -it --rm ghcr.io/anomalyco/opencode

Bun을 사용한 Windows에서의 OpenCode 설치 지원은 현재 진행 중입니다.

Releases (opens in a new tab)에서 바이너리를 직접 다운로드할 수도 있습니다.

설정

OpenCode를 사용하면 API 키를 설정하여 모든 LLM 프로바이더를 사용할 수 있습니다.

LLM 프로바이더 사용이 처음이라면 OpenCode Zen 사용을 권장합니다. OpenCode 팀이 테스트하고 검증한 모델의 큐레이션된 목록입니다.

1. TUI에서 /connect 명령어를 실행하고, opencode를 선택한 후 opencode.ai/auth (opens in a new tab)로 이동하세요.

/connect

2. 로그인하고, 결제 정보를 추가한 후 API 키를 복사하세요.

3. API 키를 붙여넣으세요.

┌ API key
│
│
└ enter

또는 다른 프로바이더 중 하나를 선택할 수 있습니다. 자세히 알아보기.

초기화

프로바이더를 설정했으므로 이제 작업하려는 프로젝트로 이동할 수 있습니다.

cd /path/to/project

그리고 OpenCode를 실행하세요.

opencode

다음으로, 다음 명령어를 실행하여 프로젝트에 대해 OpenCode를 초기화하세요.

/init

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

이를 통해 OpenCode가 프로젝트 구조와 사용된 코딩 패턴을 이해할 수 있습니다.

사용법

이제 OpenCode를 사용하여 프로젝트 작업을 할 준비가 되었습니다. 무엇이든 자유롭게 질문하세요!

AI 코딩 에이전트 사용이 처음이라면 도움이 될 수 있는 몇 가지 예시가 있습니다.

질문하기

OpenCode에게 코드베이스에 대해 설명해 달라고 요청할 수 있습니다.

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

이것은 코드베이스에서 작업하지 않은 부분이 있을 때 유용합니다.

기능 추가

OpenCode에게 프로젝트에 새로운 기능을 추가해 달라고 요청할 수 있습니다. 하지만 먼저 계획을 세우도록 요청하는 것을 권장합니다.

1. 계획 세우기

   OpenCode에는 변경을 수행하는 기능을 비활성화하고 대신 기능을 어떻게 구현할지 제안하는 Plan 모드가 있습니다.

   Tab 키를 사용하여 전환하세요. 오른쪽 하단에 표시기가 나타납니다.

   <TAB>

   이제 원하는 작업을 설명해 봅시다.

   When a user deletes a note, we'd like to flag it as deleted in the database.
   Then create a screen that shows all the recently deleted notes.
   From this screen, the user can undelete a note or permanently delete it.

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

   팁

   OpenCode가 원하는 것을 이해할 수 있도록 충분한 컨텍스트와 예시를 제공하세요.

2. 계획 반복

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

   We'd like to design this new screen using a design I've used before.
   [Image #1] Take a look at this image and use it as a reference.
   팁

   이미지를 터미널에 드래그 앤 드롭하여 프롬프트에 추가하세요.

   OpenCode는 제공하는 모든 이미지를 스캔하여 프롬프트에 추가할 수 있습니다. 터미널에 이미지를 드래그 앤 드롭하면 됩니다.

3. 기능 구현

   계획에 만족하면 Tab 키를 다시 눌러 Build 모드로 전환하세요.

   <TAB>

   그리고 변경을 수행하도록 요청하세요.

   Sounds good! Go ahead and make the changes.

변경하기

더 간단한 변경의 경우 계획을 먼저 검토하지 않고 OpenCode에게 직접 구현하도록 요청할 수 있습니다.

We need to add authentication to the /settings route. Take a look at how this is
handled in the /notes route in @packages/functions/src/notes.ts and implement
the same logic in @packages/functions/src/settings.ts

OpenCode가 올바른 변경을 수행할 수 있도록 충분한 세부 정보를 제공해야 합니다.

변경 취소

OpenCode에게 일부 변경을 요청했다고 가정해 봅시다.

Can you refactor the function in @packages/functions/src/api/index.ts?

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

/undo

OpenCode는 이제 변경 사항을 되돌리고 원래 메시지를 다시 표시합니다.

Can you refactor the function in @packages/functions/src/api/index.ts?

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

또는 /redo 명령어를 사용하여 변경을 다시 실행할 수 있습니다.

/redo

공유

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

/share

이렇게 하면 현재 대화에 대한 링크가 생성되어 클립보드에 복사됩니다.

다음은 OpenCode와의 예시 대화 (opens in a new tab)입니다.

커스터마이징

이게 전부입니다! 이제 OpenCode 사용의 전문가가 되었습니다.

자신만의 것으로 만들려면 테마 선택, 키바인딩 커스터마이징, 코드 포매터 설정, 사용자 정의 명령어 생성 또는 OpenCode 설정을 살펴보는 것을 권장합니다.