Termux에서 Open Code를 무료로 실행하는 방법: 최종 가이드

AI 에이전트(AI agents)는 우리가 코드를 작성하는 방식을 변화시키고 있지만, 이를 모바일 기기에서 실행하는 것은 항상 도전 과제였습니다. 최근 기술 크리에이터 DevCoreX가 작성한 가이드에 따르면, Android의 Termux 내에서 업데이트된 버전의 Open Code를 직접 실행할 수 있는 원활하고 완전히 무료인 방법이 공개되었습니다.

다음은 이 설정이 어떻게 작동하는지, 어떻게 설치하는지, 그리고 MiniMax M2.5 및 Big Pickle과 같은 무료 AI 모델을 휴대폰에서 어떻게 활용하기 시작할 수 있는지에 대한 종합적인 분석입니다.

아키텍처: 루팅(Root) 없이 작동하는 원리

데스크톱급의 복잡한 AI 소프트웨어를 Android에서 실행하려면 보통 루팅(rooted)된 기기가 필요합니다. 하지만 이 구현 방식은 UDocker라는 영리한 우회 방법을 활용합니다.

표준 Docker는 루팅 권한 없이 Termux에서 실행될 수 없기 때문에(루팅을 하더라도 심각한 제한이 따릅니다), 이 설정은 UDocker를 사용합니다. UDocker를 사용하면 완전히 루팅 없이도 격리된 Linux 환경(예: Ubuntu) 내에서 Docker 컨테이너를 가져오고(pull) 실행할 수 있습니다.

워크플로우를 네이티브하게 유지하기 위해, 이 설정은 공유 볼륨(shared volume, 공유 디렉토리)을 구현합니다. Termux의 폴더 내에서 Open Code를 실행하면, 컨테이너 내부의 home/opencode/workspace로 직접 매핑됩니다. 이는 AI가 생성하거나 수정하는 모든 파일이 로컬 Termux 디렉토리에 즉시 반영됨을 의미하며, 수동으로 파일을 전송할 필요가 없습니다.

단계별 설치 가이드

Open Code를 설치하고 관리하는 가장 쉬운 방법은 DevCoreX 커뮤니티에서 개발한 오픈 소스 유틸리티 저장소인 Cortermux를 사용하는 것입니다.

1단계: Cortermux 설치 또는 업데이트

curl -fsSL https://raw.githubusercontent.com/DevCoreXOfficial/core-termux/main/install.sh | bash

Termux 터미널을 열고 메인 Cortermux 설치 스크립트(프로젝트의 공식 저장소에서 제공됨)를 실행합니다. 설치가 완료되면 다음 명령어를 실행하여 버전을 확인하세요:

core

버전이 3.7.1 이상인지 확인하십시오. 이전 설치 버전을 업데이트해야 하는 경우 다음을 실행하십시오:

core update core

Step 2: Open Code 개별 설치

Cortermux는 여러 도구가 포함된 AI 모듈을 제공합니다. 저장 공간을 절약하고 필요하지 않은 도구의 다운로드를 방지하려면, 다음 플래그를 사용하여 Open Code를 특정하여 설치하십시오:

core install ai --opencode

참고: 저의 경우 libc 방식을 선택했으며 완벽하게 작동했습니다.

Step 3: 실행 및 초기화

전용 작업 디렉터리를 생성하고 해당 디렉터리로 이동하십시오:

mkdir devcorex && cd devcorex

이제 다음 명령어를 실행하여 에이전트 (agent)를 시작하십시오:

opencode

참고: 컨테이너 설치 (container installation) 방식을 선택한 경우, 이 명령어를 처음 실행할 때 필요한 UDocker Linux 컨테이너를 자동으로 다운로드합니다. 이 초기 다운로드에는 시간이 약간 소요되지만, 이후의 모든 실행은 거의 즉시 이루어집니다.

무료 모델 및 기능 활용하기

Open Code가 실행되면 표준 터미널 기반 AI 어시스턴트(assistant)처럼 상호작용할 수 있습니다.

• 사용 가능한 모델 확인: 환경 내에서 /models를 입력하십시오. 기본적으로 MiniMax M2.5, Big Pickle, Nemotron 3 Superfree라는 세 가지 유능한 무료 모델에 접근할 수 있습니다.
• 커스텀 제공자 (Custom Providers): 무료 제한을 모두 소진한 경우, Open Code는 매우 유연합니다. OpenAI, Anthropic, Google 또는 GitHub와 같은 프리미엄 제공자의 API 키를 쉽게 연결할 수 있습니다.
• 지속적인 세션 (Persistent Sessions): 에이전트는 채팅 기록과 프로젝트 컨텍스트 (context)를 자동으로 추적합니다. /exit를 입력하고 나중에 돌아오더라도, 무엇을 작업하고 있었는지 정확히 기억합니다.
• 기술 통합 (Skills Integration): /skills 명령어를 사용하여 자동화된 모듈형 작업을 검사하거나 실행함으로써 에이전트의 핵심 기능을 확장할 수 있습니다.

크레딧 및 주요 링크

주요 참조: Video Author -> DevCoreX

특별 감사: 이 Termux 적응 버전은 환경을 성공적으로 적응시키고 자신의 커스텀 연구소 내에서 이를 유지 관리하고 있는 커뮤니티 개발자 Iván 3 (Iván 3 by Cinderela) 덕분에 가능했습니다.

프로젝트 리소스:

Ialaf GitHub Repository: Iván 3가 유지 관리하며, 수동 배포 파일 및 대체 Termux 패키지를 호스팅합니다. (저장소 릴리스에 접속하려면 "Ialaf GitHub"를 검색하세요).

Cortermux Project: 이 튜토리얼에서 사용된 공식 오픈 소스 (open-source) 툴 매니저로, DevCoreX 커뮤니티 채널을 통해 접속할 수 있습니다.

Author's Channel (DevCoreX): https://youtu.be/r3QwU_h8TmY (원본 영상 링크 제공)

Cortermux Project Repository: https://github.com/DevCoreXOfficial/core-termux

Ialaf Laboratory (Iván 3): https://github.com/ivan3bycinderela/Ialaf 또는 https://github.com/ivan3-by-cinderela/Ialaf (개발자 Iván 3의 GitHub 사용자 이름 변형에 따라 다름).

Base Tool (UDocker): https://github.com/indigo-dc/udocker (루트 (root) 권한 없이 컨테이너 (container)를 실행하는 데 사용되는 언급된 도구).