1. 개요
오픈코드(opencode)는 Anomaly가 MIT 라이선스로 공개한 AI 코딩 에이전트입니다. 프로젝트 폴더에서 요청하면 코드를 탐색하고 파일을 수정하며 명령을 실행합니다. 터미널 인터페이스뿐 아니라 Windows·macOS·Linux 데스크톱 앱과 VS Code 계열 편집기 확장도 공식적으로 제공합니다.
특정 AI 회사에 고정되지 않는 것이 핵심입니다. 공식 문서는 75개가 넘는 제공자와 로컬 모델을 지원한다고 안내하며, 처음 연결할 때 /connect에서 제공자를 선택하고 API 키나 지원되는 구독 계정으로 인증합니다. ChatGPT Plus·Pro와 GitHub Copilot 구독 연결을 공식 지원하지만 모델과 구독 등급에 따라 이용 범위가 달라질 수 있습니다. 인증 정보는 사용자 컴퓨터의 OpenCode 데이터 폴더에 저장되므로 공용 PC에서는 사용 후 자격 증명을 정리해야 합니다.
OpenCode 프로그램 자체는 무료지만 연결하는 모델 비용까지 모두 무료라는 뜻은 아닙니다. OpenCode Zen 같은 공식 제공 경로, 각 회사의 API 종량제, 지원 구독 또는 로컬 모델 중 하나를 선택합니다. Claude Pro·Max 구독 인증을 외부 도구에서 사용하는 플러그인은 Anthropic 정책상 금지되어 공식 번들에서 제거됐으므로, OpenCode에서 Claude 모델을 사용할 때는 Anthropic API 등 공식적으로 허용된 경로를 선택해야 합니다.
Windows에서도 네이티브 앱과 여러 설치 방법을 제공하지만 공식 문서는 터미널 버전의 최적 호환성을 위해 WSL 사용을 권장합니다. 처음에는 작은 저장소에서 권한과 변경 내역을 확인하며 쓰고, 중요한 작업은 Git 커밋이나 별도 브랜치로 되돌릴 지점을 만든 뒤 맡기는 것이 안전합니다.
사용 전 확인할 점
모델 선택 폭이 넓은 대신 비용·개인정보 처리·도구 실행 권한도 제공자별로 달라집니다. 처음부터 프로젝트 전체 권한을 맡기기보다 Git으로 복구 지점을 만든 뒤 작은 작업에서 인증과 변경 내역을 확인하세요.
2. 주요 기능
- MIT 라이선스 오픈소스 — 소스 공개, 자유롭게 수정·자체 호스팅 가능
- 모델 종속 없음 — 클로드·GPT·제미나이·로컬 모델 등 75개+ 제공자 연결
- 터미널·Windows/macOS/Linux 데스크톱 앱·IDE 확장 제공
- ChatGPT Plus·Pro와 GitHub Copilot 구독 연결 지원
- 프로젝트 파일 탐색·수정과 명령 실행을 수행하는 에이전트 작업
- 여러 세션과 작업 공유 기능
- Windows는 네이티브 설치와 WSL 환경 모두 지원
3. 시스템 요구사항
- OS
- Windows · macOS · Linux
- 터미널
- 공식 문서가 안내하는 최신 터미널 권장
- Windows
- 네이티브 사용 가능, 최적 호환성은 WSL 권장
- 모델
- 사용할 제공자의 API 키·지원 구독 또는 로컬 모델 필요
4. 설치 방법
- 1.
창 형태로 쓰려면 [오픈코드 다운로드] 버튼에서 운영체제에 맞는 데스크톱 앱을 받습니다.
- 2.
터미널에서 쓰려면 [설치 문서 보기]에서 설치 스크립트나 npm·Homebrew·Chocolatey·Scoop 등 환경에 맞는 방법을 선택합니다.
- 3.
작업할 프로젝트 폴더에서 opencode를 실행합니다.
- 4.
/connect를 열어 사용할 모델 제공자를 선택하고 API 키 또는 공식 지원 구독으로 인증합니다.
- 5.
첫 요청 전에 Git 상태와 권한을 확인하고 작은 수정부터 테스트합니다.
5. 자주 발생하는 문제
Windows 터미널에서 명령이나 도구가 제대로 동작하지 않을 때
공식 문서는 Windows에서 최적의 호환성을 위해 WSL을 권장합니다. 네이티브 설치가 막히면 WSL 환경에서 공식 설치 절차를 다시 진행하세요.
모델을 연결했는데 인증 오류가 날 때
/connect에서 제공자와 인증 방식을 다시 확인하세요. API 키와 구독 로그인은 서로 다른 방식이며, 인증 정보는 사용자 데이터 폴더의 auth.json에 저장됩니다.
무료 프로그램인데 모델 비용이 청구될 때
MIT 라이선스는 OpenCode 클라이언트에 적용됩니다. 연결한 API나 구독의 요금은 각 제공자 정책을 따르므로 모델 선택 전에 가격과 사용량을 확인하세요.
6. 오픈코드와 비슷한 프로그램 비교
- Claude Code
- 앤트로픽이 만든 터미널 코딩 에이전트로 클로드 모델에 맞춰져 있고 유료 구독이 필요합니다. 오픈코드는 오픈소스이며 모델을 골라 쓸 수 있습니다.
- Codex
- 오픈AI의 코딩 에이전트로 ChatGPT 계정을 기반으로 동작합니다. 오픈코드는 특정 회사 계정에 묶이지 않습니다.
- GitHub Copilot
- 편집기 안에서 코드를 제안하는 방식이 중심입니다. 오픈코드는 터미널에서 파일을 직접 읽고 고치는 에이전트 방식입니다.
- Cursor
- AI 기능을 넣은 편집기 자체를 제공합니다. 오픈코드는 편집기를 바꾸지 않고 쓰던 환경에 더해서 사용합니다.
7. 자주 묻는 질문
오픈코드는 무료인가요?
+
OpenCode 클라이언트는 MIT 라이선스 오픈소스이며 무료입니다. 다만 연결하는 모델은 OpenCode Zen, 각 제공자의 API, 지원 구독 또는 로컬 모델의 요금·제한을 따릅니다. 클라이언트가 무료라고 모든 모델 사용까지 무료인 것은 아닙니다.
Claude Code와 뭐가 다른가요?
+
Claude Code는 앤트로픽이 만들어 클로드 모델을 쓰도록 설계된 도구이고, 오픈코드는 어느 회사 모델이든 연결해 쓰는 오픈소스 도구입니다. 소스가 공개되어 있어 직접 고쳐 쓰거나 자체 호스팅할 수 있다는 점도 차이입니다. 어느 쪽이 낫다기보다 한 모델에 최적화된 환경을 원하는지, 모델 선택의 자유를 원하는지에 따라 갈립니다.
클로드 구독(Pro·Max) 계정을 연결해도 되나요?
+
OpenCode 공식 문서는 Claude Pro·Max 모델을 구독 인증으로 사용하는 플러그인이 Anthropic 정책상 금지되며 1.3.0부터 기본 포함하지 않는다고 안내합니다. Claude 모델은 Anthropic API처럼 공식적으로 허용된 제공 경로와 결제 방식을 사용하세요.
프로그래밍을 모르는 사람도 쓸 수 있나요?
+
터미널 대신 창으로 쓸 수는 없나요?
+
가능합니다. 공식 다운로드 페이지에서 macOS·Windows·Linux용 데스크톱 앱을 제공하고, VS Code·Cursor·Windsurf·VSCodium·Zed용 편집기 연동도 안내합니다.
이미 쓰는 ChatGPT나 코파일럿 구독을 활용할 수 있나요?
+
공식 문서는 ChatGPT Plus·Pro와 GitHub Copilot 구독 인증을 지원한다고 안내합니다. 다만 사용할 수 있는 모델과 한도는 구독 등급 및 제공자 정책에 따르며, 별도 API 기능이 필요하면 추가 요금이 발생할 수 있습니다. Claude Pro·Max 구독 인증은 예외이므로 공식 API 경로를 사용하세요.
8. 참고 자료
관련 프로그램
