CONTEENUA COMPANION · 데스크톱 앱

Conteenua에서 내 컴퓨터에 있는 내 ChatGPT로 코딩하세요.

Conteenua Companion은 내 컴퓨터에서 승인한 저장소를 Conteenua 웹 및 모바일의 「내 AI로 코딩」 기능과 연결합니다. 아래에서 운영체제에 맞는 설치 파일을 고르세요.

Conteenua에서 완료된 로컬 ChatGPT 코딩 대화, 프로젝트와 후속 입력창이 함께 보입니다

작업에 맞는 방법을 고르세요

직접 하는 작업과 수동 작업은 여전히 간단합니다. AI는 선택 사항입니다.

Conteenua는 이 방법들을 분리해 두어, 하나를 골라도 크레딧이 몰래 쓰이거나 제공자가 몰래 바뀌지 않게 합니다.

직접 / 수동

AI 크레딧 0

메모를 쓰고, 컨텍스트를 관리하고, 나만의 소셜 콘텐츠를 직접 작성하거나 예약할 수 있습니다. 이런 일상 작업에는 Conteenua AI 크레딧이 필요하지 않습니다.

내 AI 사용

Conteenua AI 크레딧 0

Companion은 승인한 로컬 저장소를 일반적인 ChatGPT 대화에 연결합니다. 이미 가지고 있는 ChatGPT 계정을 사용하며, Conteenua의 유료 실행기로 넘어가지 않습니다.

Conteenua AI

Conteenua AI 크레딧 사용

Conteenua가 호스팅된 코딩 작업을 실행하고, 결과를 검증한 뒤 「적용 준비 완료」로 돌려주길 원할 때 GitHub 컨텍스트를 사용하세요. 적용, 변경 요청, 실행 취소를 할 수 있습니다.

요구 사항

로컬 코딩을 켜기 전에 필요한 것들.

  • Companion과 Conteenua 웹 또는 모바일 앱에 로그인된 Conteenua 계정.
  • 개발자 모드와 쓰기가 가능한 MCP App 도구를 제공하는 ChatGPT 계정 또는 워크스페이스.
  • Companion에서 명시적으로 승인한 로컬 저장소 폴더.
  • 지원되는 Windows 10/11, macOS 15 이상 또는 Linux 데스크톱 환경. 아래에서 맞는 프로세서 종류와 Linux 패키지를 고르세요.

Conteenua는 실행 중에 제공자의 기능을 확인합니다. 쓰기가 가능한 ChatGPT 도구를 쓸 수 없으면 로컬 코딩은 꺼진 상태로 남고 Conteenua AI 크레딧은 청구되지 않습니다.

설정

한 번 연결한 뒤, Conteenua에서 컴퓨터와 프로젝트를 고르세요.

  1. 1Conteenua Companion을 설치하고 열어서, 웹이나 모바일에서 쓰는 것과 같은 Conteenua 계정으로 로그인하세요.
  2. 2사용하려는 로컬 프로젝트 폴더를 추가하세요. 폴더를 고르는 것이 곧 승인된 루트 권한을 부여합니다.
  3. 3ChatGPT에 사용하는 것과 같은 Chrome 프로필에 Conteenua Companion Chrome 확장 프로그램을 추가하세요.
  4. 4「Stable OpenAI tunnel (recommended)」를 선택한 채로 두고, 영구 MCP 터널을 만들고, Tunnels: Read + Use 권한이 있는 제한된 터널 API 키를 만든 뒤, 둘 다 Companion에 저장하고 로컬 도구를 연결하세요.
  5. 5ChatGPT에서 Settings → Security and login으로 가서 Developer mode를 켜세요.
  6. 6ChatGPT Plugins를 열고 Add → Create MCP App을 선택하세요. Create plugin은 고르지 마세요. Plugin Creator가 열리며 이는 터널 설정 경로가 아닙니다.
  7. 7MCP App 이름을 Conteenua Companion Core로 지정하세요.
  8. 8Tunnel을 고르고, 같은 영구 터널을 선택하고, No Auth를 고른 뒤, 개발자 경고에 동의하고 MCP App을 만드세요.
  9. 9일반 ChatGPT 대화에서 Conteenua Companion Core를 켜고, 승인된 프로젝트에 대해 무해한 로컬 도구를 한 번 실행하세요.
  10. 10Companion으로 돌아가 확장 프로그램, Core 커넥터, 로컬 도구 검증이 모두 준비 완료로 표시되는지 확인하세요.
개발자 모드가 켜진 ChatGPT 설정 화면
개발자 모드 켜기
만든 뒤 ChatGPT에 나타난 Conteenua Companion Core MCP App
Companion Core MCP App 만들기

임시 대안

OpenAI 영구 터널을 설정하지 않으면, 테스트용으로 Companion이 검증된 Cloudflare 퀵 터널을 쓸 수 있습니다. 공개 URL은 Companion을 다시 시작하면 바뀔 수 있으므로, Server URL 모드로 만든 ChatGPT 앱은 새로 고치거나 다시 만들어야 할 수 있습니다.

개인정보 및 권한

로컬 컴퓨터가 여전히 신뢰의 경계입니다.

기본적으로 내 컴퓨터에 남습니다

  • 저장소 파일과 로컬 파일 시스템 경로
  • 셸 환경, 로컬 프로세스, 터미널의 전체 출력
  • ChatGPT 브라우저 인증 정보, 쿠키, 브라우저 프로필 데이터
  • 운영체제 인증 정보와 저장된 터널 키

Conteenua 클라우드는 원격 제어용 메타데이터를 받습니다

  • 연결된 기기의 식별자, 플랫폼, 온라인 상태, 프로젝트 표시용 메타데이터
  • Conteenua에 입력한 원격 지시
  • 세션 및 제공자 상태, 명시적인 승인 결정
  • 「ChatGPT가 작업을 시작했습니다」 또는 「exec_command 사용 중」처럼 범위가 제한된 안전한 활동 요약

모델이 사용하는 파일 도구는 승인한 폴더로 제한됩니다. 터미널 명령은 로그인한 운영체제 사용자 권한으로 실행되므로, 명령 실행은 별도의 권한이며 위험도가 높은 작업은 승인이 필요할 수 있습니다.

로컬 도구 승인 요청을 보여주는 ChatGPT 화면

문제 해결

대부분의 설정 문제는 하나의 경계를 가리킵니다.

Conteenua에서 컴퓨터가 오프라인으로 나옴

Companion을 열어 두고, 같은 Conteenua 계정으로 로그인했는지 확인하고, 컴퓨터가 외부로 나가는 연결을 만들 수 있는지 점검하세요. Conteenua 원격 제어에는 라우터의 인바운드 포트가 필요하지 않습니다.

ChatGPT 도구를 쓸 수 없음

이 ChatGPT 워크스페이스에서 개발자 모드를 쓸 수 있는지, Companion Core 앱이 쓰기 가능한 로컬 도구를 노출하는지 확인하세요. 계정이 이를 지원하지 않으면, Conteenua는 Codex나 Conteenua AI로 바꾸지 않고 「코딩 시작」을 꺼진 상태로 둡니다.

안정 터널이 준비되지 않음

영구 터널 ID와 제한된 터널 API 키를 다시 확인하고, 커넥터를 다시 저장한 뒤 로컬 도구를 다시 연결하세요. Companion은 커넥터에 실제로 도달할 수 있을 때만 준비 완료로 표시합니다.

임시 Server URL이 작동하지 않음

Cloudflare 퀵 터널 URL은 재시작 후 바뀔 수 있습니다. 새로 확인된 URL을 복사하고, Server URL 모드를 쓰던 ChatGPT MCP 앱을 새로 고치거나 다시 만드세요.

프로젝트가 보이지 않음

그 컴퓨터에서 실행 중인 Companion에서 폴더를 승인하세요. 클라우드 프로젝트를 선택해도 로컬 폴더 접근 범위가 넓어지지 않습니다.

다운로드 및 체크섬

내 컴퓨터에 맞는 직접 다운로드를 고르세요.

각 버튼은 맞는 설치 파일을 바로 다운로드합니다. Linux에서는 휴대용 패키지라면 AppImage를, Debian이나 Ubuntu라면 DEB를 고르세요. 체크섬 매니페스트는 아래에 있습니다.

Windows 체크섬

설치 파일이 있는 폴더에서 PowerShell로 다음을 실행한 뒤, 나온 64자리 해시를 SHA256SUMS.txt에서 같은 파일 이름의 줄과 비교하세요:

Get-FileHash .\Conteenua-Companion-Setup-x64.exe -Algorithm SHA256

macOS나 Linux에서는 shasum -a 256 <파일명> (또는 사용 가능하면 sha256sum <파일명>)을 실행하고, 같은 릴리스 매니페스트와 비교하세요.

SHA256SUMS.txt

Companion이 준비되면 코딩은 Conteenua에서 시작됩니다.

「내 AI 사용」을 고르고, 연결된 컴퓨터와 승인된 프로젝트를 선택한 뒤, 지시를 입력하고 일반 ChatGPT 세션을 시작하세요. 후속 질문을 하고, 활동을 확인하고, 제한된 작업을 승인하거나 거부하고, 일시 중지, 재개, 중지하거나 ChatGPT를 직접 열 수 있습니다.

Conteenua 열기