도구별 실전 가이드 · 공식 정보 확인 2026-08-17
OpenCode 사용법: 무료로 시작하는 가장 현실적인 방법
터미널에서 코드 탐색과 수정, 명령 실행을 직접 통제하며 에이전트를 쓰고 싶은 개발자용 도구입니다.
이럴 때 맞습니다
- 편집기를 바꾸지 않고 터미널 흐름을 유지하려는 개발자
- 로컬 모델이나 직접 고른 API를 연결하려는 경우
- 오픈소스 클라이언트를 검토하고 쓰려는 팀
이럴 때는 멈추세요
- 권한 검토 없이 셸 명령을 자동 실행하게 두려는 경우
- 설정 없이 즉시 최고 품질의 답이 필요한 상황
처음 해볼 작업 3가지
복사본에서 먼저 돌리기
실제 저장소를 건드리기 전에 안전하게 시험합니다.
실행할 명령 미리 정하기
예상 밖의 명령이 실행되는 것을 막습니다.
연결할 모델 정하기
비용과 데이터 처리 방식을 함께 결정합니다.
무료 조건과 주의점
MIT 클라이언트는 무료, 무료·로컬 모델 연결 가능하며 유료 모델 API 사용 시 비용 별도
오픈소스 클라이언트는 무료지만 연결한 모델 API의 사용 비용은 별도로 발생합니다.
셸 명령 실행 권한을 가진 에이전트는 파일 삭제 같은 위험한 동작도 할 수 있으므로 범위를 제한하세요.
저장소의 코드가 외부 모델로 전송될 수 있으니 비공개 프로젝트에서는 연결 대상을 확인해야 합니다.
직접 대안과 비교
- Cursor — 코드베이스를 읽고 수정하는 Agent와 자동 완성을 한 편집기 안에서 쓰는 AI 코드 에디터예요.
- Ollama — Qwen·Gemma·DeepSeek 같은 오픈 모델을 명령 한 줄과 로컬 API로 실행하는 AI 런타임이에요.