오픈 소스 AI 코딩 에이전트.
English | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | 日本語 | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | Українська | বাংলা | Ελληνικά | Tiếng Việt
Important
Android data survives reinstall only if all-files access is granted: server data is stored under /sdcard/OpenCode/home; otherwise app-private data is removed on uninstall. You may need to reselect a project after reinstalling. The v0.1.1 source tag predates the Android module; build from main. The uploaded APK has not been verified as a byte-for-byte build of main. See the current Android notes.
이 포크는 기존 opencode를 Android에서 네이티브로 실행합니다. 휴대폰에서 실제 서버, 에이전트, 세션, 그리고 수정하지 않은 packages/app 웹 UI(WebView의 loopback 경유)가 동작합니다. PC, Termux, 원격 서버가 필요 없고 프로토콜 변경도 없습니다.
우리가 upstream에 추가한 것 (나머지는 모두 upstream opencode입니다):
| 경로 | 내용 |
|---|---|
packages/android |
Android 호스트: Gradle 프로젝트, WebView Activity, 내장 서버, 모바일 UI 조정 |
script/android |
재현 가능한 빌드: build-apk.sh와 서버, ripgrep, git 런타임, 번역 스크립트 |
docs/android |
기술 문서: 빌드, 실행 정책, 네이티브 의존성, upstream 패치 |
수정하는 upstream 파일은 다섯 개뿐이며(Android 빌드 타깃과 런타임 호환성), 각 변경의 이유는 docs/android/UPSTREAM_PATCHES.md에 기록되어 있습니다.
동작 방식: Activity가 내장 서버를 시작하고(libopencode.so serve --hostname=127.0.0.1) WebView에서 http://127.0.0.1:<port>/을 로드합니다. 도구는 앱의 nativeLibraryDir에서 실행됩니다: /system/bin/sh, 내장 git, rg, 그리고 bun/node로 노출되는 Bun 런타임.
- 다운로드: releases (
app-release.apk, arm64, Android 8.0+) - 빌드:
./script/android/build-apk.sh—docs/android/BUILD.md참고 - 첫 실행: 파일 접근을 허용하세요(세션은
/sdcard/OpenCode/home에 저장되어 재설치 후에도 유지됩니다). 그런 다음 설정 → 공급자에서 공급자를 연결하고 프로젝트(~/workspace)를 추가하세요 - 동작: 서버와 웹 UI, 세션, diff와 구문 강조가 있는 git(Changes), 프로젝트 파일 브라우저(Files), 컨텍스트 사용량 패널(Usage), 명령 및 JS/TS 실행
- 제한 사항: PTY 터미널, LSP/포매터, 로컬 MCP 프로세스는 없습니다. 네이티브 file watcher는 사용할 수 없습니다(검색은
rg사용) - 라이선스: 원본과 동일한 MIT
# YOLO
curl -fsSL https://opencode.ai/install | bash
# 패키지 매니저
npm i -g opencode-ai@latest # bun/pnpm/yarn 도 가능
scoop install opencode # Windows
choco install opencode # Windows
brew install anomalyco/tap/opencode # macOS 및 Linux (권장, 항상 최신)
brew install opencode # macOS 및 Linux (공식 brew formula, 업데이트 빈도 낮음)
sudo pacman -S opencode # Arch Linux (Stable)
paru -S opencode-bin # Arch Linux (Latest from AUR)
mise use -g opencode # 어떤 OS든
nix run nixpkgs#opencode # 또는 github:anomalyco/opencode 로 최신 dev 브랜치Tip
설치 전에 0.1.x 보다 오래된 버전을 제거하세요.
OpenCode 는 데스크톱 앱으로도 제공됩니다. releases page 에서 직접 다운로드하거나 opencode.ai/download 를 이용하세요.
| 플랫폼 | 다운로드 |
|---|---|
| macOS (Apple Silicon) | opencode-desktop-mac-arm64.dmg |
| macOS (Intel) | opencode-desktop-mac-x64.dmg |
| Windows | opencode-desktop-windows-x64.exe |
| Linux | .deb, .rpm, 또는 AppImage |
OpenCode는 이 포크에서 빌드한 네이티브 APK로 Android에서도 실행됩니다. 실제 서버와 동일한 웹 UI를 포함하며, 세션, 공급자 키, 프로젝트는 /sdcard/OpenCode/home에 저장되어 재설치 후에도 유지됩니다.
| 플랫폼 | 다운로드 | 비고 |
|---|---|---|
| Android 8.0+ (arm64) | app-release.apk |
BETA — 첫 실행 시 파일 접근을 허용하세요 |
| 소스에서 빌드 | ./script/android/build-apk.sh |
packages/android/README.md 참고 |
# macOS (Homebrew)
brew install --cask opencode-desktop
# Windows (Scoop)
scoop bucket add extras; scoop install extras/opencode-desktop설치 스크립트는 설치 경로를 다음 우선순위로 결정합니다.
$OPENCODE_INSTALL_DIR- 사용자 지정 설치 디렉터리$XDG_BIN_DIR- XDG Base Directory Specification 준수 경로$HOME/bin- 표준 사용자 바이너리 디렉터리 (존재하거나 생성 가능할 경우)$HOME/.opencode/bin- 기본 폴백
# 예시
OPENCODE_INSTALL_DIR=/usr/local/bin curl -fsSL https://opencode.ai/install | bash
XDG_BIN_DIR=$HOME/.local/bin curl -fsSL https://opencode.ai/install | bashOpenCode 에는 내장 에이전트 2개가 있으며 Tab 키로 전환할 수 있습니다.
- build - 기본값, 개발 작업을 위한 전체 권한 에이전트
- plan - 분석 및 코드 탐색을 위한 읽기 전용 에이전트
- 기본적으로 파일 편집을 거부
- bash 명령 실행 전에 권한을 요청
- 낯선 코드베이스를 탐색하거나 변경을 계획할 때 적합
또한 복잡한 검색과 여러 단계 작업을 위한 general 서브 에이전트가 포함되어 있습니다.
내부적으로 사용되며, 메시지에서 @general 로 호출할 수 있습니다.
agents 에 대해 더 알아보세요.
OpenCode 설정에 대한 자세한 내용은 문서 를 참고하세요.
OpenCode 에 기여하고 싶다면, Pull Request 를 제출하기 전에 contributing docs 를 읽어주세요.
OpenCode 와 관련된 프로젝트를 진행하면서 이름에 "opencode"(예: "opencode-dashboard" 또는 "opencode-mobile") 를 포함한다면, README 에 해당 프로젝트가 OpenCode 팀이 만든 것이 아니며 어떤 방식으로도 우리와 제휴되어 있지 않다는 점을 명시해 주세요.