# OpenCode > OpenCode는 언어 모델을 소프트웨어 프로젝트 및 개발자 도구와 연결하여 코딩 작업을 수행하는 오픈 소스 AI 코딩 에이전트입니다. - Canonical URL: https://iq.wiki/kr/wiki/opencode - Categories: Projects & Protocols - Tags: AIAgent - Created: 2026-10-21T02:28:58.410Z - Last updated: 2026-10-21T02:28:58.410Z - Source: IQ.wiki — the world's largest blockchain and crypto encyclopedia (https://iq.wiki) --- **OpenCode**는 사용자가 선택한 모델을 소프트웨어 프로젝트, 개발 도구 및 터미널에 연결하는 오픈 소스 인공지능 코딩 에이전트입니다. 이 에이전트는 코드를 검사하고, 변경 사항을 계획 및 실행하며, 명령과 테스트를 실행하고 그 결과를 사용하여 작업을 계속할 수 있습니다. OpenCode는 AI 모델 자체가 아니라 에이전트 소프트웨어와 인터페이스를 제공합니다.[\[1\]](#cite-id-dhdgz18ngm)​[\[2\]](#cite-id-wxsh1s9r6n)​[\[3\]](#cite-id-0aslq0971o)​ ## Overview OpenCode는 터미널 인터페이스, 데스크톱 애플리케이션, 브라우저 클라이언트 및 IDE 확장을 통해 사용할 수 있습니다. V2 문서는 macOS, Windows, Linux용 데스크톱 빌드와 함께 독립형 명령줄 바이너리에 대해 설명합니다.[[1]](#cite-id-dhdgz18ngm)[[4]](#cite-id-gyvcfudg7w) 이 소프트웨어는 클라이언트-서버 아키텍처를 사용합니다. 터미널 인터페이스, 데스크톱 애플리케이션, IDE 확장, 소프트웨어 개발 키트(SDK) 및 웹 클라이언트는 HTTP를 통해 로컬 서버와 통신하며, 서버는 모델 제공자와 통신하고 도구를 실행하며 세션 상태를 관리합니다.[[2]](#cite-id-wxsh1s9r6n)[[3]](#cite-id-0aslq0971o) 서버는 `opencode serve`를 통해 터미널 인터페이스와 독립적으로 실행될 수 있습니다. `opencode web`은 브라우저 클라이언트를 추가하며, `opencode attach`는 실행 중인 세션에 다른 클라이언트를 연결합니다.[[2]](#cite-id-wxsh1s9r6n)[[3]](#cite-id-0aslq0971o) OpenAPI 3.1 사양은 공식 `@opencode-ai/sdk`를 뒷받침합니다. 서버 API는 세션, 메시지, 파일, 제공자, 도구, 에이전트 및 구성을 다루므로, 스크립트와 사용자 정의 클라이언트가 터미널 인터페이스에서 키보드 입력을 시뮬레이션하지 않고도 OpenCode와 상호작용할 수 있도록 합니다.[[2]](#cite-id-wxsh1s9r6n)[[3]](#cite-id-0aslq0971o) V2 웹 인터페이스는 `opencode pair` 명령을 통해 페어링할 수 있습니다. 생성된 연결 링크는 일회용이며 5분 후에 만료됩니다.[[4]](#cite-id-gyvcfudg7w) OpenCode는 또한 구성, 플러그인, [Model Context Protocol](https://iq.wiki/wiki/model-context-protocol) (MCP) 서버, 사용자 정의 명령, 테마 및 키 바인딩을 지원합니다.[[4]](#cite-id-gyvcfudg7w)[[5]](#cite-id-vrx9tt4wlu) ## History and Development 활발히 운영 중인 OpenCode 프로젝트는 Serverless Stack 프레임워크를 만든 팀인 Anomaly에 의해 유지 관리됩니다. `opencode-ai/opencode`라는 이름의 별도 Go 기반 저장소는 동일한 프로젝트가 아니며, 2025년 9월에 유지 관리가 종료된 후 아카이브되었습니다.[[2]](#cite-id-wxsh1s9r6n) 2026년에 발표된 기록에 따르면, OpenCode는 첫해 동안 800개 이상의 버전을 포함하는 빠른 릴리스 기록을 보유하고 있습니다.[[2]](#cite-id-wxsh1s9r6n)[[3]](#cite-id-0aslq0971o) 이 프로젝트의 개발 과정에는 터미널, 데스크톱, 브라우저 및 에디터 클라이언트뿐만 아니라 모델 액세스 서비스와 코딩 세션 관리 도구들이 포함되었습니다.[[2]](#cite-id-wxsh1s9r6n)[[4]](#cite-id-gyvcfudg7w) ## 코딩 워크플로우 (Coding Workflow) OpenCode의 도구들을 통해 모델은 프로젝트 파일을 찾아 검사하고, 코드를 편집하며, 셸 명령을 실행할 수 있습니다. 모델은 후속 요청에서 명령 출력 결과를 수신하여 테스트 실패나 기타 오류에 대응하는 데 사용할 수 있습니다.[\[2\]](#cite-id-wxsh1s9r6n) 또한 OpenCode는 언어 서버 프로토콜(LSP) 도구와 통합되어 컴파일러 및 린터(linter) 진단 결과를 모델에 반환할 수 있습니다.[\[2\]](#cite-id-wxsh1s9r6n)​[\[1\]](#cite-id-dhdgz18ngm)​ 기본 설정인 빌드(Build) 모드는 파일을 읽고 쓰며 명령을 실행할 수 있습니다. 계획(Plan) 모드는 구현 방안을 제안하고 파일을 편집하거나 셸 명령을 실행하기 전에 사용자에게 확인을 요청합니다. 사용자는 계획을 수정하고 빌드 모드로 전환하여 이를 수행할 수 있습니다.[\[2\]](#cite-id-wxsh1s9r6n)​[\[3\]](#cite-id-0aslq0971o)​[\[5\]](#cite-id-vrx9tt4wlu) 도구 권한 설정을 통해 특정 작업을 허용, [차단(block)](https://iq.wiki/wiki/block)하거나 확인을 요구할 수 있으며, 여기에는 명령 패턴에 기반한 규칙도 포함됩니다. 이러한 권한은 워크플로우 제어 용도이며 보안 샌드박스는 아닙니다.[\[2\]](#cite-id-wxsh1s9r6n)​[\[3\]](#cite-id-0aslq0971o)​ `/init` 명령은 프로젝트를 분석하고 루트 디렉토리에 프로젝트 구조 및 코딩 컨벤션 정보가 담긴 `AGENTS.md` 파일을 생성합니다. 팀은 이 파일을 커밋하여 에이전트가 공유된 프로젝트 지침을 갖도록 할 수 있으며, 전역 `AGENTS.md`를 통해 여러 리포지토리에 걸쳐 적용할 수도 있습니다.[\[5\]](#cite-id-vrx9tt4wlu)​[\[2\]](#cite-id-wxsh1s9r6n) 사용자는 프롬프트에서 `@`를 사용하여 파일을 참조할 수 있고, 코드베이스 검색, 스캐닝, 문서 조회 등의 작업을 위해 서브에이전트를 사용할 수 있습니다. 커스텀 에이전트는 자체적인 모델, 프롬프트, 도구 권한을 가질 수 있으며 메인 세션과 분리된 하위 세션에서 실행됩니다.[\[2\]](#cite-id-wxsh1s9r6n)​[\[3\]](#cite-id-0aslq0971o)​ `/undo` 및 `/redo` 명령은 프로젝트 문서에 설명된 대로 Git 기반 스냅샷을 사용하여 파일 변경 사항을 앞뒤로 이동합니다.[\[5\]](#cite-id-vrx9tt4wlu)​[\[3\]](#cite-id-0aslq0971o) OpenCode는 또한 하나의 프로젝트에서 여러 에이전트를 병렬로 실행할 수 있으며, 참조나 디버깅을 위해 공유 가능한 세션 링크를 생성할 수 있습니다.[\[1\]](#cite-id-dhdgz18ngm)​ ## 모델 제공업체 및 액세스 OpenCode는 다양한 모델 제공업체와 연동되도록 설계되어, 사용자가 코딩 에이전트를 교체하지 않고도 모델을 변경할 수 있습니다. 이 서비스는 Models.dev 레지스트리를 사용하며 Anthropic, OpenAI, Google, xAI를 포함한 75개 이상의 제공업체와 로컬 모델을 지원합니다.[[1]](#cite-id-dhdgz18ngm)[[2]](#cite-id-wxsh1s9r6n) 사용자는 터미널 인터페이스의 `/connect` 명령어를 통해 제공업체 계정이나 API 키를 연결할 수 있으며, 커스텀 제공업체 및 호환 가능한 엔드포인트를 구성할 수도 있습니다.[[4]](#cite-id-gyvcfudg7w)[[2]](#cite-id-wxsh1s9r6n) OpenCode 웹사이트에는 사용자가 연결할 수 있는 구독 옵션으로 GitHub Copilot, ChatGPT Plus 또는 Pro, Claude Pro 또는 Max가 나열되어 있습니다.[[1]](#cite-id-dhdgz18ngm) 이와 별개로, 2026년 1월 Anthropic의 제한 조치에 관한 보고서에 따르면 해당 회사가 비공식 채널을 통해 소비자용 Claude 구독에 액세스하는 제3자 도구를 차단했다고 전했습니다. 해당 계정들은 대신 OpenCode에서 표준 Anthropic API 키를 사용하여 API 요율로 비용을 지불하며 Claude 모델을 사용하는 것으로 설명되었습니다.[[2]](#cite-id-wxsh1s9r6n)[[3]](#cite-id-0aslq0971o) 소프트웨어 자체는 무료로 사용할 수 있지만, 호스팅된 모델에 액세스할 때는 제공업체 요금이 발생할 수 있습니다. OpenCode는 Zen과 Go라는 두 가지 모델 액세스 서비스를 제공하며, 사용자는 자신의 제공업체 자격 증명을 제공하거나 로컬 모델을 실행할 수도 있습니다.[[1]](#cite-id-dhdgz18ngm)[[6]](#cite-id-rbaqzj07cf)[[7]](#cite-id-gtacfjf1ka)[[2]](#cite-id-wxsh1s9r6n) ### OpenCode Zen OpenCode Zen은 OpenCode 팀이 만든 종량제(pay-as-you-go) 서비스입니다. 이 서비스는 팀이 코딩 에이전트 성능을 위해 테스트하고 벤치마킹한 선별된 모델 세트를 제공하며, OpenCode뿐만 아니라 다른 코딩 에이전트와도 함께 작동하도록 설계되었습니다.[[6]](#cite-id-rbaqzj07cf) Zen은 추가 수수료 없이 모델 제공업체의 원가로 요청당 비용을 청구하며 선불 잔액 방식을 사용합니다. 사용자는 월간 지출 한도를 설정하고, 결제를 비활성화하며, 남은 크레딧을 계속 사용할 수 있습니다. 충전 후 14일 이내에 요청할 경우 사용하지 않은 크레딧에 대해 환불이 가능할 수 있습니다.[[6]](#cite-id-rbaqzj07cf) OpenCode는 Zen 모델이 미국에서 호스팅되며, 제공업체들이 제로 보존(zero-retention) 정책을 따르고 서비스에서 설명하는 예외 사항을 제외하고는 사용자 데이터를 모델 학습에 사용하지 않는다고 밝히고 있습니다.[[6]](#cite-id-rbaqzj07cf) ### OpenCode Go OpenCode Go는 선별된 코딩 모델 라인업에 액세스할 수 있는 구독 서비스입니다. OpenCode는 Go를 월 10달러, Go Plus를 월 40달러로 책정하고 있으며, 후자는 더 높은 사용 한도를 제공합니다. 두 서비스 모두 OpenCode 또는 다른 코딩 에이전트와 함께 사용할 수 있습니다.[[7]](#cite-id-gtacfjf1ka) 2026년 9월의 한 기사에서는 첫 달 5달러 혜택에 이어 월 10달러가 부과되는 제안에 대해 설명했습니다.[[2]](#cite-id-wxsh1s9r6n)[[3]](#cite-id-0aslq0971o) Go는 5시간, 주간, 월간 단위의 유동적인 기간에 걸쳐 할당량(quota)을 적용하며, 모델별 허용량과 요청 횟수는 모델 및 사용량에 따라 달라집니다.[[7]](#cite-id-gtacfjf1ka) 이 서비스의 모델 라인업에는 여러 제공업체의 제품이 포함되어 있으며, 월간 구독 및 사용 한도를 Zen의 종량제 모델과 차별화하고 있습니다.[[7]](#cite-id-gtacfjf1ka) 2026년 10월 21일 기준, 공식 Go 문서는 변경되는 모델 라인업을 나열하고 모델별 제한 사항과 데이터 사용 및 보존 약관이 다를 수 있음을 설명했습니다. 또한 DeepSeek의 데이터 제로 보존 계약은 매달 갱신되며 2026년 10월 31일까지 유효하다고 명시했습니다.[[12]](#cite-id-2xbh1d2u5h) ## 개인정보 보호 및 보안 OpenCode는 사용자의 코드나 컨텍스트 데이터를 저장하지 않는다고 밝히며, 이를 개인정보 보호에 민감한 용도에 적합한 특징으로 제시합니다.[[1]](#cite-id-dhdgz18ngm) 또한 FAQ에 따르면 사용자가 OpenCode의 무료 모델을 사용할 때는 데이터와 정보가 저장됩니다.[[1]](#cite-id-dhdgz18ngm) 데이터 처리 방식은 선택한 모델과 서비스에 따라 다릅니다. 호스팅 모델(hosted-model) 요청은 코드 컨텍스트를 제공자에게 전송하는 반면, 로컬 모델은 로컬 인프라에서 처리를 유지할 수 있습니다.[[2]](#cite-id-wxsh1s9r6n)[[3]](#cite-id-0aslq0971o) OpenCode의 `/share` 명령은 세션을 공개 링크로 업로드하며 이는 공유를 취소할 때까지 액세스 가능한 상태로 유지됩니다. 또한 Zen은 모델 제공자에게 요청을 전송합니다.[[2]](#cite-id-wxsh1s9r6n)[[3]](#cite-id-0aslq0971o) OpenCode의 권한 시스템은 소프트웨어를 운영 체제로부터 격리하지 않습니다. 네트워크 서버 사용에 관한 문서에서는 `OPENCODE_SERVER_PASSWORD`를 설정하고 서버를 localhost에 바인딩할 것을 권장합니다. 프로젝트 관련 보고서에서는 이전에 발생했던 인증되지 않은 노출 문제가 패치되었다고 설명했습니다.[[2]](#cite-id-wxsh1s9r6n)[[3]](#cite-id-0aslq0971o) ## Enterprise Use OpenCode는 조직 내에서 운영되도록 설계된 기업용 배포를 제공합니다. 회사 측에 따르면 조직은 팀 트라이얼로 시작하여 싱글 사인온(SSO) 및 내부 AI 게이트웨이를 통합함으로써 조직 전체에 OpenCode를 배포할 수 있습니다. 또한 라이선스 제한이나 소유권 주장을 하지 않으며 어떠한 데이터나 컨텍스트도 저장하지 않는다고 명시하고 있습니다.[[8]](#cite-id-p6aqkf0rqx) ## OpenCode Data OpenCode Data는 모델 사용량, 모델 믹스의 변화, 비용, 세션 비용, 토큰 비용, 캐시 비율, 지리적 분석 및 모델 비교를 위한 대시보드입니다.[[9]](#cite-id-ffvi2jkdia) ## 2026년 10월 Console 보안 사고 2026년 10월 17일에서 18일 사이 밤, 공격자들이 구형 OpenCode 시스템에 침입했습니다. OpenCode는 이번 사건을 대규모 “증류 공격(distillation attack)”과 연관된 것으로 설명하며, OpenCode Console 사용자의 1.4%가 영향을 받았다고 밝혔습니다.[[10]](#cite-id-iod7os5e45) 공동 창립자 Dax Raad는 이번 침해 사고가 오픈 소스 애플리케이션이나 명령줄 도구가 아닌, 일부 사용자가 API 키를 저장하는 Console에 영향을 미쳤다고 말했습니다. Raad에 따르면 노출된 키는 Console 워크스페이스에 국한되었으며 앱 자체에서는 접근할 수 없었습니다.[[10]](#cite-id-iod7os5e45) 사용자들은 OpenAI, Anthropic, Google AI 계정에서 무단 지출 알림 및 요금 청구가 발생했다고 보고했습니다. 일부는 청구액이 수백 달러에 달했다고 전했으며, 몇몇은 총액이 1,000달러를 넘었다고 보고했습니다. Anthropic과 Google은 노출된 것으로 판단되는 키를 차단했습니다.[[10]](#cite-id-iod7os5e45) OpenAI는 OpenCode와 협력하여 액세스를 복구하고 공격에 사용된 크레딧에 대해 고객에게 환불해 주기로 했으며, OpenCode는 무단 청구에 대한 환불 절차가 진행 중이라고 밝혔습니다.[[10]](#cite-id-iod7os5e45) OpenCode는 이메일을 통해 피해 사용자에게 통지하고 각 제공업체에서 직접 API 키를 폐기하고 교체할 것을 권고했습니다.[[10]](#cite-id-iod7os5e45) 일부 평론가들은 이번 침해가 전형적인 절도 사건이며 모델 증류를 위해 키가 사용되었다는 점이 입증되지 않았다고 주장하며, 회사의 “증류 공격” 프레임에 이의를 제기했습니다.[[10]](#cite-id-iod7os5e45) Raad는 공격자들이 48시간 동안 지속적으로 OpenCode 시스템 침입을 시도했으며, 팀이 방어 대응을 돕기 위해 [AI agents](https://iq.wiki/wiki/ai-agents)를 사용했다고 말했습니다.[[10]](#cite-id-iod7os5e45) 그는 또한 일부 AI 모델이 처음에는 사건 분석을 도왔으나, 나중에 안전 필터가 작동하여 악성 코드 검사를 거부했다고 언급했습니다. 이후 OpenCode는 검증된 사용자에게 방어 보안 요청을 거부할 가능성이 낮은 모델을 제공하는 OpenAI의 Daybreak Blue 프로그램에 대한 액세스 권한을 부여받았습니다.[[10]](#cite-id-iod7os5e45) 이번 침해 사고는 OpenCode가 GLM-5.3-Flash를 사용자에게 무료로 공개한 것과 같은 날 밤에 발생했습니다. 오픈 웨이트(open-weight) 모델을 연구하는 연구원들은 광범위한 GLM-5.3 제품군의 사이버 보안 능력이 이전에 Anthropic의 Claude Mythos Preview와 같은 접근 제한 모델과 연관되었던 수준에 근접했다고 보고한 바 있습니다.[[10]](#cite-id-iod7os5e45)