문서 검색

설치

macOS · Windows · Linux 설치 파일을 받아 설치하는 방법과, 서명되지 않은 파일이 띄우는 첫 실행 보안 경고에 대응하는 방법을 안내합니다.

상태: 제공 중 마지막 확인:
목차

Cocode IDE 설치 파일은 다운로드 페이지에서 받습니다. 페이지의 각 버튼은 해당 운영체제용 설치 파일의 주소로 연결됩니다. 이 문서를 확인한 2026-10-08 에는 버전 0.1.0 이 게시되어 있었습니다.

참고

2026-10-09 에 다시 확인했을 때는 세 설치 파일의 주소가 모두 접근을 거부했습니다(HTTP 403). 다운로드 페이지는 열렸지만 파일은 받지 못했습니다. 이 문서의 설치 방법은 파일을 받을 수 있는 상태를 전제로 하므로, 받아지지 않으면 다운로드 페이지의 최신 안내를 확인하세요.

참고

홈페이지 메뉴에는 아직 다운로드 링크가 없습니다. 위 링크로 직접 들어오세요. 페이지 제목은 「Cocode IDE 다운로드」입니다.

주의

설치 파일은 서명 · 공증되지 않았습니다. 그래서 첫 실행에서 macOS 는 열기를 막고, Windows 는 SmartScreen 경고를 띄울 수 있습니다. 직접 허용해야 하는데, 방법은 아래 「첫 실행 보안 경고」에 있습니다. 위 다운로드 페이지에서 받은 파일인지 확인한 뒤에만 허용하세요.

받을 파일과 지원 환경

운영체제 파일 요구 사항
macOS DMG macOS 12 이상. 한 파일에 Apple 실리콘과 Intel 맥용이 모두 들어 있습니다
Windows 설치 프로그램(EXE) 64비트 Windows 10 이상
Linux 포터블 ZIP 64비트 x86-64(Intel · AMD)용 한 가지만 게시됩니다. glibc 기반 배포판에서 GLib 2.80 이상과 GTK 3 · GStreamer · EGL · OpenGL ES(libEGL.so.1 · libGLESv2.so.2) 실행 라이브러리가 필요합니다. Ubuntu 24.04 · 25.04 · Fedora 40 · 42 · Arch 에서는 실행되었고, Ubuntu 20.04 · 22.04 · 23.10 · Debian 11 · 12 · Alpine(musl)에서는 실행되지 않았습니다(2026-10-08 x86-64 컨테이너에서 확인)

설치 방법

macOS

  1. 내려받은 DMG 파일을 엽니다.
  2. 열린 창에서 Cocode IDE 를 「Applications」(응용 프로그램) 폴더로 끌어 놓습니다.
  3. 응용 프로그램 폴더에서 Cocode IDE 를 실행합니다. 처음에는 보안 경고가 나오는데, 대응 방법은 아래 「첫 실행 보안 경고」에 있습니다.

Windows

  1. 내려받은 설치 파일(EXE)을 실행합니다. 처음에는 SmartScreen 경고가 뜰 수 있습니다.
  2. 설치 마법사의 안내를 따릅니다. 마법사는 영어로 표시되고, 추가 작업으로 바탕 화면 아이콘을 만들지와 Windows 시작 시 Cocode IDE 를 자동으로 실행할지를 고르는 칸이 있습니다.
  3. 설치가 끝나면 시작 메뉴에서 Cocode IDE 를 실행합니다. 마법사의 마지막 쪽에서 바로 실행할 수도 있습니다.

Linux

  1. 새 폴더를 만들고 ZIP 의 모든 파일을 그 폴더에 풉니다. ZIP 에는 최상위 폴더가 없고 cocode 실행 파일과 lib · data 폴더가 바로 들어 있어서, 빈 폴더에 풀어야 다른 파일과 섞이지 않습니다. lib 과 data 폴더는 cocode 옆에 함께 두세요.
  2. 압축을 푼 cocode 에 실행 권한이 없으면 chmod +x cocode 를 실행합니다. ZIP 항목이 FAT 형식이라 unzip 은 저장된 실행 권한을 무시하므로 대개 필요합니다.
  3. 같은 폴더의 터미널에서 ./cocode 로 앱을 실행합니다.

설치 패키지가 아닌 포터블 ZIP 입니다. 라이브러리 오류가 나면 배포판의 패키지 관리자로 GTK 3 · GStreamer(core 와 plugins-base) · EGL · OpenGL ES 라이브러리를 설치하세요. GLib 이 2.80 보다 낮은 배포판(Ubuntu 22.04 · Debian 12 포함)에서는 라이브러리를 더 설치해도 실행되지 않습니다.

첫 실행 보안 경고

0.1.0 의 macOS 앱은 Apple 개발자 서명(Developer ID) 없이 임시(ad-hoc) 서명만 되어 있고 공증도 받지 않았습니다. Windows 설치 파일은 코드 서명이 없습니다. 이런 파일은 운영체제가 처음 열기 전에 사용자의 허락을 요구합니다.

macOS

Apple 의 안내(Mac에서 앱 안전하게 열기)를 따릅니다. 아래는 macOS 15 기준이고, 버전마다 화면 이름이 조금씩 다릅니다.

  1. Cocode IDE 를 열려고 시도합니다.
  2. 「시스템 설정」을 엽니다.
  3. 「개인정보 보호 및 보안」을 누르고 아래로 스크롤해 「그래도 열기」 버튼을 누릅니다. 이 단추는 앱을 열려고 한 뒤 약 1시간 동안만 쓸 수 있습니다.
  4. 로그인 암호를 물으면 입력하고, 경고가 다시 나타나면 열기를 확인하는 「열기」를 누릅니다.
  5. 이제 앱이 보안 설정의 예외로 저장되어, 다른 앱처럼 두 번 클릭해 열 수 있습니다.

macOS 12 ~ 14 에서는 앱을 Control 키를 누른 채 눌러 나오는 메뉴에서 「열기」를 골라도 됩니다(Launchpad 에서는 되지 않습니다). 설정 쪽 단추는 macOS 12 와 13 이 「확인 없이 열기」, macOS 14 가 「그래도 열기」입니다. macOS 12 는 「시스템 환경설정」 › 「보안 및 개인 정보 보호」 › 「일반」에 있습니다.

시스템 관리자나 IT 부서가 관리하는 Mac 에서는 이 설정을 바꾸지 못할 수 있습니다.

Windows

경고(「Windows의 PC 보호」 창)가 나타나면 먼저 위 다운로드 페이지, 곧 공식 출처에서 받은 파일인지 확인합니다. 믿을 수 있으면 「추가 정보」를 눌러 나오는 「실행」으로 계속합니다. 화면 문구는 Windows 버전에 따라 다를 수 있습니다. Microsoft 문서에 따르면 서명이 없는 앱은 「Windows protected your PC」 경고가 뜨고 사용자가 「Run anyway」를 직접 골라야 실행되며, 기업 정책이 계속 진행 자체를 막을 수도 있습니다(SmartScreen 평판). Microsoft Defender SmartScreen 은 널리 알려지고 자주 내려받는 파일 목록에 없는 파일에 주의 경고를 보여 줍니다(SmartScreen 개요).

Windows 11 의 스마트 앱 컨트롤이 적용 모드이면 Microsoft 가 인식하지 못하는 서명 없는 앱은 실행할 수 없습니다(스마트 앱 컨트롤 개요). 그런 PC 에서는 이 설치 파일이 막힐 수 있습니다.

조직의 보안 정책이 설치를 막을 수도 있습니다. 그럴 때는 조직의 IT 담당자에게 문의하세요.

위험

경고를 허용하는 것은 이 파일이 믿을 만하다고 직접 판단하는 일입니다. 출처가 불분명한 곳에서 받은 파일에는 같은 방법을 쓰지 마세요.

업데이트

앱 안에는 업데이트를 확인하거나 내려받는 기능이 없습니다(2026-10-08 소스 기준). 새 버전이 나오면 다운로드 페이지에서 최신 설치 파일을 받아 위와 같은 방법으로 설치합니다. 앱 안에서 자동으로 갱신하는 기능은 준비 중인 기능에 있습니다.

제공하지 않는 것

이 문서가 안내하는 설치 파일은 다운로드 페이지의 세 가지입니다. Mac App Store · Microsoft Store(MSIX 패키지)에서 받는 방법과 iOS · Android 앱은 안내하지 않습니다.

확인

  • 앱이 열리고 채팅 화면에 「무엇을 만들까요?」가 보입니다.
  • 「설정」 › 「정보」에 이전 표기인 「cocode ADE」와 앱을 빌드한 Flutter · Dart 버전이 보입니다.

자주 겪는 문제

macOS 에서 앱이 열리지 않고 경고만 나옵니다

서명 · 공증되지 않은 앱이라 처음에는 막히는 것이 정상입니다. 위 「첫 실행 보안 경고」의 「그래도 열기」 순서를 따르세요. 「그래도 열기」 버튼은 앱을 열려고 시도한 뒤 약 1시간 동안 「개인정보 보호 및 보안」에 나타납니다(macOS 12 ~ 14 는 위의 이름을 보세요).

Windows 에서 설치가 막힙니다

SmartScreen 경고는 「추가 정보」를 눌러 나오는 「실행」으로 넘어갈 수 있습니다. 그래도 막히면 Windows 11 의 스마트 앱 컨트롤이 서명 없는 앱을 막은 것이거나, 조직의 보안 정책이 설치를 제한하는 경우일 수 있습니다. 조직의 PC 라면 IT 담당자에게 문의하세요.

Linux 에서 앱이 실행되지 않습니다

압축을 푼 폴더에 lib 과 data 폴더가 cocode 와 함께 있는지 확인하세요. 「Permission denied」가 나오면 chmod +x cocode 를 실행합니다. 공유 라이브러리 오류가 나오면 GTK 3 · GStreamer · EGL · OpenGL ES 라이브러리를 설치하세요. GLIBC_2.34 를 찾지 못했다는 오류나 「undefined symbol: g_once_init_enter_pointer」 같은 오류는 배포판의 glibc · GLib 버전이 너무 낮다는 뜻이라 배포판을 올려야 합니다.

다음 단계

앱이 열리면 빠른 시작으로 첫 프로젝트를 만들어 봅니다.

출처