Trợ lý lập trình AI mã nguồn mở.
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.
Bản fork này chạy opencode hiện có một cách native trên Android: điện thoại chạy máy chủ thật, agent, phiên làm việc và giao diện packages/app không thay đổi (qua loopback trong WebView). Không cần PC, Termux, máy chủ từ xa và không thay đổi giao thức.
Những gì chúng tôi thêm vào (phần còn lại là opencode upstream):
| Đường dẫn | Nội dung |
|---|---|
packages/android |
Host Android: dự án Gradle, Activity WebView, máy chủ nhúng, tinh chỉnh UI di động |
script/android |
Build tái lập: build-apk.sh cùng script cho máy chủ, ripgrep, runtime git và bản dịch |
docs/android |
Tài liệu kỹ thuật: build, chính sách thực thi, phụ thuộc native, bản vá upstream |
Chỉ năm tệp upstream được sửa (mục tiêu build Android và tương thích runtime); mỗi thay đổi đều có lý do trong docs/android/UPSTREAM_PATCHES.md.
Cách hoạt động: Activity khởi động máy chủ nhúng (libopencode.so serve --hostname=127.0.0.1) và tải http://127.0.0.1:<port>/ trong WebView. Công cụ chạy từ nativeLibraryDir của ứng dụng: /system/bin/sh, git, rg đi kèm và runtime Bun được công khai là bun/node.
- Tải xuống: releases (
app-release.apk, arm64, Android 8.0+) - Build:
./script/android/build-apk.sh— xemdocs/android/BUILD.md - Lần chạy đầu: cấp quyền truy cập tệp (phiên lưu trong
/sdcard/OpenCode/homevà tồn tại qua cài đặt lại), sau đó Cài đặt → Nhà cung cấp → kết nối nhà cung cấp và thêm dự án (~/workspace) - Hoạt động: máy chủ và giao diện web, phiên, git với diff và tô sáng cú pháp (Changes), trình duyệt tệp dự án (Files), bảng mức sử dụng ngữ cảnh (Usage), chạy lệnh và JS/TS
- Hạn chế: không có terminal PTY, LSP/trình định dạng hay tiến trình MCP cục bộ; file watcher native không khả dụng (tìm kiếm dùng
rg) - Giấy phép: MIT, giống bản gốc
# YOLO
curl -fsSL https://opencode.ai/install | bash
# Các trình quản lý gói (Package managers)
npm i -g opencode-ai@latest # hoặc bun/pnpm/yarn
scoop install opencode # Windows
choco install opencode # Windows
brew install anomalyco/tap/opencode # macOS và Linux (khuyên dùng, luôn cập nhật)
brew install opencode # macOS và Linux (công thức brew chính thức, ít cập nhật hơn)
sudo pacman -S opencode # Arch Linux (Bản ổn định)
paru -S opencode-bin # Arch Linux (Bản mới nhất từ AUR)
mise use -g opencode # Mọi hệ điều hành
nix run nixpkgs#opencode # hoặc github:anomalyco/opencode cho nhánh dev mới nhấtTip
Hãy xóa các phiên bản cũ hơn 0.1.x trước khi cài đặt.
OpenCode cũng có sẵn dưới dạng ứng dụng desktop. Tải trực tiếp từ trang releases hoặc opencode.ai/download.
| Nền tảng | Tải xuống |
|---|---|
| macOS (Apple Silicon) | opencode-desktop-mac-arm64.dmg |
| macOS (Intel) | opencode-desktop-mac-x64.dmg |
| Windows | opencode-desktop-windows-x64.exe |
| Linux | .deb, .rpm, hoặc AppImage |
OpenCode cũng chạy trên Android dưới dạng APK native được build từ fork này. Ứng dụng chứa máy chủ thật và cùng giao diện web; phiên, khóa nhà cung cấp và dự án lưu trong /sdcard/OpenCode/home và tồn tại qua cài đặt lại.
| Nền tảng | Tải xuống | Ghi chú |
|---|---|---|
| Android 8.0+ (arm64) | app-release.apk |
BETA — cấp quyền truy cập tệp ở lần chạy đầu |
| Build từ mã nguồn | ./script/android/build-apk.sh |
xem packages/android/README.md |
# macOS (Homebrew)
brew install --cask opencode-desktop
# Windows (Scoop)
scoop bucket add extras; scoop install extras/opencode-desktopTập lệnh cài đặt tuân theo thứ tự ưu tiên sau cho đường dẫn cài đặt:
$OPENCODE_INSTALL_DIR- Thư mục cài đặt tùy chỉnh$XDG_BIN_DIR- Đường dẫn tuân thủ XDG Base Directory Specification$HOME/bin- Thư mục nhị phân tiêu chuẩn của người dùng (nếu tồn tại hoặc có thể tạo)$HOME/.opencode/bin- Mặc định dự phòng
# Ví dụ
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 bao gồm hai agent được tích hợp sẵn mà bạn có thể chuyển đổi bằng phím Tab.
- build - Agent mặc định, có toàn quyền truy cập cho công việc lập trình
- plan - Agent chỉ đọc dùng để phân tích và khám phá mã nguồn
- Mặc định từ chối việc chỉnh sửa tệp
- Hỏi quyền trước khi chạy các lệnh bash
- Lý tưởng để khám phá các codebase lạ hoặc lên kế hoạch thay đổi
Ngoài ra còn có một subagent general dùng cho các tìm kiếm phức tạp và tác vụ nhiều bước.
Agent này được sử dụng nội bộ và có thể gọi bằng cách dùng @general trong tin nhắn.
Tìm hiểu thêm về agents.
Để biết thêm thông tin về cách cấu hình OpenCode, hãy truy cập tài liệu của chúng tôi.
Nếu bạn muốn đóng góp cho OpenCode, vui lòng đọc tài liệu hướng dẫn đóng góp trước khi gửi pull request.
Nếu bạn đang làm việc trên một dự án liên quan đến OpenCode và sử dụng "opencode" như một phần của tên dự án, ví dụ "opencode-dashboard" hoặc "opencode-mobile", vui lòng thêm một ghi chú vào README của bạn để làm rõ rằng dự án đó không được xây dựng bởi đội ngũ OpenCode và không liên kết với chúng tôi dưới bất kỳ hình thức nào.