opencode 튜토리얼 - LLM모델을 CLI에서 사용하기

opencode 는 여러 LLM을 CLI 환경에서 사용할 수 있는 AI Coding Agent이다.
opencode 사용법, agent 생성하는 법에 대해 알아보기로 한다.

opencode 특징

• TUI 기반이다 (설정같은 건 CLI로 하긴 함)
• 여러 LLM 들을 한 곳에서 사용할 수 있다
• agent를 지원하지 않는 LLM(ex. github copilot)도 agent를 사용할 수 있다 (생성은 안되더라)
• 독스 학습이 쉽다
• opencode툴 자체는 무료지만 사용하려는 LLM에 대해서는 API key를 이용하든 구독을 하든 돈을 내야한다.

 

※참고) 용어-화면 매핑
CLI
터미널 창

TUI
opencode 커맨드 입력한 후

opencode 설치

독스

brew install opencode

(맥북)

opencode help 커맨드를 통해 CLI 커맨드를 확인할 수 있다.

 

opencode 로그인

독스

LLM을 사용하려면 각 LLM에 대해 로그인이 필요하다.

opencode auth login

위/아래 방향키로 많은 모델들을 선택할 수 있다.

 

opencode Zen

• 현존하는 LLM이 많기 때문에 가장 좋은 성능이 무엇인지 알려면 일일히 선택할 수 밖에 없다.
• opencode Zen은 이런 문제를 해결하기 위해 모델들을 돌려보고 가장 성능 좋은 하나만 선택해준다.
• 기본적으로 유료이지만, 무료인 모델도 있다.
• 
• TUI /models 커맨드에서 무료 모델 선택가능하다.

 

Anthropic

• Claude 만든 회사
• Claude Pro/Max를 구독중이라면, 여기서 로그인해주면 된다.

 

GitHup Copilot

알려준 링크 들어가서 code입력해준다.

OpenAI

• ChatGPT만든 회사
• ChatGPT 구독중인데도 불구하고 로그인할 수 없다!
• 구독과 별개로 API key가 필요하고, 그에 대한 돈을 따로 내야한다.

 

필자는 Anthropic, GitHub Copilot 두 개를 로그인해주었다.

 

opencode 대화하기

opencode

바로 입력 후 엔터를 쳐 대화를 시작할 수 있다.
선택된 모델도 확인할 수 있다.

 

TUI 커맨드

opencode TUI에서도 유용한 커맨드들이 있다. (독스)

/models

• 모델 리스트를 확인하고 선택한다.
• 로그인한 모델들과 opencode zen의 무료 모델들이 보인다.

 

/share

대화를 공유할 수 있는 링크가 생성된다.

TUI환경에선 raw 마크다운인데 링크 내용은 마크다운이 적용되어 예쁘게 보인다.

/undo

직전 대화가 삭제된다.

 

/redo

/undo다음 /redo하면 원복된다.

 

Agent에 관해

독스

내가 프롬포팅한대로 특정 작업만 수행하는 AI assistant를 만들 수 있고, 그것을 Agent라고 한다.
참고로, claude code(claude clit 툴)에서도 agent를 사용할 수 있다.(클로드 독스)

opencode에선 build agent가 디폴트이다. 나만의 agent를 어떻게 생성하는지 알아보자

agent를 지원하는 claude로 로그인 후 CLI에서 아래 커맨드를 실행한다.

opencode create agent

Location: 현재 프로젝트(디렉토리)에서만 쓸건지, global로 쓸 건지 선택한다.

Description: 내가 시키고 싶은 일을 입력한다.
이런 use case가 있다.

• Build agent: Full development work with all tools enabled
• Plan agent: Analysis and planning without making changes
• Review agent: Code review with read-only access plus documentation tools
• Debug agent: Focused on investigation with bash and read tools enabled
• Docs agent: Documentation writing with file operations but no system commands

 

tool 선택

생성할 agent가 어떤 tool을 가질 수 있는지 선택한다.
필자는 설명봇을 만들거라 수정/생성 tool은 제외했다.
각각 tool에 대한 설명 ▶️ 독스

 

agent 생성 완료

agent 생성이 완료됐다. agent이름은 eck-code-explainer로 자동 생성되었다.

 

agent 사용하기

TUI화면에서 <tab>으로 agent 전환을 쉽게 할 수 있다.

 

❓클로드말고 다른 LLM 도 agent 지원이 되나?

github copilot cli가 현재는 agent 지원하지 않는데 opencode에서는 agent를 쓸 수 있는지 궁금해졌다.

▶️ 빠른 한 줄: agent 사용은 할 수 있다. 근데 agent 생성은 안 된다. (필자의 환경 기준)

 

TUI /models에서 github copilot/Gemini 2.5 pro 선택

에러 난다.

 

TUI /models에서 Anthropic/Claude Sonnet 4.5 선택

클로드 모델은 성공한다.

 

하지만 미리 만들어논 Concept-Explainer agent를 지정한 상태에서 github copilot/Gemini 2.5 pro 모델을 선택하면 에러가 나지도 않고, 간단하게 설명해달라는 Concept-Explainer agent의 말을 잘 듣는 것으로 보아 agent도 적용되는 것 같다.

Concept-Explainer agent / gemini-2.5-pro

 

Build agent (default) / gemini-2.5-pro

레퍼런스

노마드코더 영상에서는 opencode + claude 조합을 메인으로 쓴다고한다.

글 읽어주셔서 언제나 감사합니다. 좋은 피드백, 개선 피드백 너무나도 환영합니다.

 

opencode로 CLI 사용하기