도구별 실전 가이드 · 공식 정보 확인 2026-08-17
OpenCode Open Source 조건과 시작 절차
작성: gentive · 편집·검수 책임: 신유빈 · 지원 환경: Windows, macOS, Linux, CLI · 페이지 갱신: · 운영·편집 기준
터미널에서 코드 탐색·수정·명령 실행을 돕는 오픈소스 AI 코딩 에이전트예요.
터미널에서 코드 탐색과 수정, 명령 실행을 직접 통제하며 에이전트를 쓰고 싶은 개발자용 도구입니다.
이럴 때 맞습니다
- 편집기를 바꾸지 않고 터미널 흐름을 유지하려는 개발자
- 로컬 모델이나 직접 고른 API를 연결하려는 경우
- 오픈소스 클라이언트를 검토하고 쓰려는 팀
이럴 때는 멈추세요
- 권한 검토 없이 셸 명령을 자동 실행하게 두려는 경우
- 설정 없이 즉시 최고 품질의 답이 필요한 상황
참고 시작점
팩트시트 · 작업 근거 확인 필요: 아래 문구는 공식 제품 사실을 정리한 참고 시작점이며, 성공 결과를 보장하는 검증 절차가 아닙니다.
복사본에서 먼저 돌리기
실제 저장소를 건드리기 전에 안전하게 시험합니다.
참고 시작점: (터미널에서) 저장소 복사본을 만든 뒤 그 안에서만 에이전트를 실행합니다.
- 작업 브랜치나 복사본을 만듭니다.
- 변경 범위를 폴더 단위로 지정합니다.
- 결과를 확인한 뒤 원본에 반영합니다.
실행할 명령 미리 정하기
예상 밖의 명령이 실행되는 것을 막습니다.
참고 시작점: 변경 후 검증은 다음 명령만 실행해줘: [테스트 명령]. 다른 명령은 실행하기 전에 물어봐.
- 허용할 명령을 명시합니다.
- 삭제·배포 명령은 자동 실행을 막습니다.
- 실행 로그를 확인하며 진행합니다.
연결할 모델 정하기
비용과 데이터 처리 방식을 함께 결정합니다.
참고 시작점: (설정에서) 로컬 모델과 외부 API 중 이 프로젝트에 맞는 쪽을 정하고 키를 환경변수로 관리합니다.
- 민감한 코드라면 로컬 모델을 우선합니다.
- API 키는 저장소에 넣지 않습니다.
- 사용량과 비용을 주기적으로 확인합니다.
무료 조건과 주의점
MIT 클라이언트는 무료, 무료·로컬 모델 연결 가능하며 유료 모델 API 사용 시 비용 별도
오픈소스 클라이언트는 무료지만 연결한 모델 API의 사용 비용은 별도로 발생합니다.
셸 명령 실행 권한을 가진 에이전트는 파일 삭제 같은 위험한 동작도 할 수 있으므로 범위를 제한하세요.
저장소의 코드가 외부 모델로 전송될 수 있으니 비공개 프로젝트에서는 연결 대상을 확인해야 합니다.
직접 대안과 비교
- Cursor — 코드베이스를 읽고 수정하는 Agent와 자동 완성을 한 편집기 안에서 쓰는 AI 코드 에디터예요.
- Ollama — Qwen·Gemma·DeepSeek 같은 오픈 모델을 명령 한 줄과 로컬 API로 실행하는 AI 런타임이에요.
공식 근거와 확인일
| 확인 항목 | 확인한 내용 | 공식 출처·확인일 |
|---|---|---|
| 제품 정보 | 터미널에서 코드 탐색·수정·명령 실행을 돕는 오픈소스 AI 코딩 에이전트예요. | OpenCode 공식 사이트 |
| 무료 조건 | MIT 클라이언트는 무료, 무료·로컬 모델 연결 가능하며 유료 모델 API 사용 시 비용 별도 | 공식 무료 근거 확인 필요 |
| 공식 코드 라이선스 | 오픈소스 코드의 사용·수정·재배포 조건 | 공식 코드 라이선스 |
| 공식 제품 페이지 | 터미널에서 코드 탐색·수정·명령 실행을 돕는 오픈소스 AI 코딩 에이전트예요. | 공식 제품 페이지 |