OpenCode로 터미널에서 AI 코딩 시작하기

OpenCode란 무엇인가요?

OpenCode는 터미널에서 AI를 활용해 개발 작업을 더 빠르고 편리하게 할 수 있도록 도와주는 툴입니다. Neovim이나 tmux와 같이 자주 사용하는 에디터·터미널 도구 옆에서 동작해, 반복적인 작업이나 궁금했던 내용을 쉽게 해결할 수 있습니다.

OpenCode는 여러 방식으로 설치 가능해요. Mac에서는 Homebrew를 활용해 간단하게 설치할 수 있습니다.

brew install opencode

npm을 이용할 수도 있고, 각각의 환경에 맞는 명령어를 사용하면 됩니다.

OpenCode는 다양한 AI 모델과 연동됩니다. 추천 모델은 Anthropic의 Claude이고, Pro나 Max 요금제가 효율적이에요. 원하는 모델에 가입 후, 터미널에서 인증을 진행하면 바로 사용할 수 있습니다.

opencode auth login

이후 안내에 따라 인증 코드를 입력하면 됩니다.

OpenCode는 tmux의 여러 창이나 split을 활용해서 에디터, 프로젝트 실행, AI 창을 동시에 띄울 수 있어요. 원하는 위치에 OpenCode를 띄워두고, 질문하거나 추천을 받을 때마다 쉽게 접근할 수 있습니다.

처음에

/init

명령을 입력하면, 프로젝트의 구조와 코드 패턴을 AI가 분석합니다. 프로젝트 루트에 agents.md 파일이 생성되어 OpenCode가 코드를 더 잘 이해할 수 있게 됩니다.

OpenCode에는 두 가지 에이전트가 있어요.

탭(Tab) 키를 누르면 두 에이전트 간 전환이 가능합니다.

OpenCode에선 슬래시(/)로 다양한 명령어를 사용하거나, 기본 프리픽스(예시: Ctrl+X)에 원하는 키를 조합해 빠르게 기능을 실행할 수 있습니다. 키바인드와 기능은 자유롭게 변경이 가능합니다.

설정 파일 예시:

{
  "leader": "ctrl+s",
  "keybinds": {
    "apply": "a",
    "undo": "u"
  }
}

프로젝트 내 opencode/command 폴더에 마크다운 파일을 추가해, 원하는 명령을 직접 만들 수 있어요. 예를 들어 새로운 Svelte 컴포넌트 생성 명령을 아래와 같이 정의할 수 있습니다.

---
description: 새로운 Svelte 컴포넌트를 만듭니다
---
새 컴포넌트 이름은 $arguments로 받습니다. TypeScript와 빈 props 인터페이스를 포함하게 해주세요.

명령어 /component 컴포넌트이름을 통해 빠르게 자주 쓰는 코드를 만들어낼 수 있습니다.

수정한 내용을 실수로 반영했다면, 다음 명령으로 쉽게 되돌릴 수 있습니다.

/undo

반려했던 변경을 다시 적용하려면

/redo

대화나 작업 내용을 팀원과 공유할 땐 /share 명령으로 URL을 생성할 수 있습니다. 민감한 정보가 포함된 경우 공유 전 반드시 확인하세요.

opencode.json 파일을 통해 AI 모델, 테마, 키바인드, 에이전트 등을 자유롭게 설정할 수 있습니다. 원하는 워크플로에 맞게 세밀하게 커스터마이즈가 가능합니다.