OpenCode 開源編碼代理安裝通道、目錄優先級與 build / plan / general Agent 體系詳解【免費下載鏈接】opencodeThe open source coding agent.項目地址: https://gitcode.com/GitHub_Trending/openc/opencode本文基于 OpenCode 倉庫根目錄的丹麥語版 READMEREADME.da.md及其對應的真實實現展開覆蓋三條主線OpenCode 的完整安裝通道一鍵腳本與各包管理器、安裝腳本的目錄優先級與 PATH 處理邏輯、以及內置 build / plan 雙 Agent 加 general 子代理的權限模型。讀完后你可以獨立完成安裝與升級、理解二進制落盤位置并能從源碼層面解釋每個 Agent 的權限邊界。1. OpenCode 是什么OpenCode 自稱 “The open source AI-kodeagent”開源 AI 編碼代理。它的主入口是一個終端 TUI在項目目錄中運行opencode命令即可進入交互式編碼會話同時項目提供了一個處于 BETA 階段的桌面應用。本倉庫是多包 monorepo核心實現位于 packages/opencode 包中本文涉及的關鍵證據包括安裝腳本install倉庫根目錄的 bash 腳本Agent 定義packages/opencode/src/agent/agent.tsAgent 行為測試packages/opencode/test/agent/agent.test.ts卸載命令packages/opencode/src/cli/cmd/uninstall.ts2. 安裝方式README 提供了“YOLO”式一鍵安裝與各包管理器安裝兩大類通道以下完整繼承原文檔內容。2.1 一鍵安裝腳本# YOLO curl -fsSL https://opencode.ai/install | bash倉庫根目錄的 install 腳本即該類安裝器的參考實現。從腳本的usage()幫助文本install#L10-L27可以看到它實際支持的參數參數說明-h, --help顯示幫助信息-v, --version version安裝指定版本例如1.0.180-b, --binary path從本地二進制安裝跳過所有下載與檢測邏輯--no-modify-path不修改 shell 配置文件.zshrc、.bashrc 等對應的調用形態為curl -fsSL https://opencode.ai/install | bash -s -- --version 1.0.180 ./install --binary /path/to/opencode腳本內部還有幾個值得注意的健壯性設計均為源碼可確認事實平臺矩陣僅接受linux-x64、linux-arm64、darwin-x64、darwin-arm64、windows-x64五種組合其余直接報錯退出install#L103-L110。Rosetta 檢測在 Intel 轉譯運行的 macOSsysctl.proc_translated 1上會自動改用 arm64 二進制。AVX2 baseline 檢測x64 平臺上若 CPU 不支持 AVX2Linux 查/proc/cpuinfo、macOS 查hw.optional.avx2_0、Windows 通過 PowerShell 調IsProcessorFeaturePresent(40)下載目標會自動追加-baseline后綴。musl 檢測Alpine 或ldd --version輸出含 musl 的 Linux 會下載-musl變體。版本校驗check_version()會先執行已安裝的opencode --version若目標版本已安裝則直接退出install#L221-L235指定版本時還會先對 release 做 HEAD 請求404 則報 “Release vX not found”。PATH 自動寫入腳本按當前 shellfish / zsh / bash / ash / sh選擇對應配置文件追加 PATH 語句已有相同內容則跳過在 GitHub Actions 環境中會額外寫入$GITHUB_PATHinstall#L362-L444。2.2 包管理器安裝npm i -g opencode-ailatest # 或用 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 (AUR 最新版) mise use -g opencode # 所有操作系統 nix run nixpkgs#opencode # 或 github:anomalyco/opencode 獲取最新 dev 分支提示原文檔 TIP安裝前先移除 0.1.x 之前的舊版本。倉庫中的卸載命令 packages/opencode/src/cli/cmd/uninstall.ts 會清理.opencode/bin相關的 PATH 配置行包括 bash 的export PATH、fish 的fish_add_path以及# opencode標記注釋可作為移除舊安裝的參考實現。2.3 桌面應用BETAOpenCode 也以桌面應用形式發布可從 releases 頁或官網下載頁獲取。各平臺安裝包命名如下原文檔表格平臺下載文件macOS (Apple Silicon)opencode-desktop-mac-arm64.dmgmacOS (Intel)opencode-desktop-mac-x64.dmgWindowsopencode-desktop-windows-x64.exeLinux.deb、.rpm或 AppImage包管理器渠道# macOS (Homebrew) brew install --cask opencode-desktop # Windows (Scoop) scoop bucket add extras; scoop install extras/opencode-desktop桌面端源碼位于 packages/desktop其主進程在 WSL 場景下還會探測$HOME/.opencode/bin/opencode這一典型安裝路徑見 packages/desktop/src/main/wsl/runtime.ts與下文安裝目錄的默認 fallback 相互印證。3. 安裝目錄的優先級README 指出安裝腳本按以下順序確定安裝路徑$OPENCODE_INSTALL_DIR—— 自定義安裝目錄$XDG_BIN_DIR—— 遵循 XDG Base Directory Specification 的目錄$HOME/bin—— 標準用戶 bin 目錄若存在或可創建$HOME/.opencode/bin—— 默認 fallback配合環境變量的用法示例原文檔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 | bash需要說明的證據邊界倉庫根目錄的 install 腳本當前將安裝目錄硬編碼為$HOME/.opencode/binINSTALL_DIR$HOME/.opencode/bin并mkdir -p。因此上述四級優先級描述的是官方https://opencode.ai/install托管安裝器的行為約定而本倉庫腳本可確認的是默認落盤位置、PATH 寫入邏輯與 GITHUB_PATH 處理。若你在 CI 或受限環境中安裝以$HOME/.opencode/bin作為二進制落盤位置做后續引用如桌面端 WSL 探測邏輯是最穩妥的假設。4. Agent 體系build、plan 與 generalREADME 描述了 OpenCode 的兩個內置 Agent——可在會話中用Tab鍵切換——以及一個內部子代理build—— 默認 Agent擁有完整的開發工作權限plan—— 只讀 Agent用于分析與代碼探索默認拒絕文件編輯執行 bash 命令前會請求許可適合探索陌生代碼庫或規劃改動general—— 面向復雜搜索與多步任務的子代理內部使用可通過在消息中general調用這段描述與源碼高度吻合。三個原生 Agent 在 packages/opencode/src/agent/agent.ts 中以mode: primarybuild、plan和mode: subagentgeneral的方式注冊其權限由Permission.merge分層合并4.1 build默認 Agentbuild 在默認權限之上放開了兩個動作agent.ts#L141-L155question: allow—— 允許 Agent 主動向用戶提問plan_enter: allow—— 允許進入 plan 模式默認權限基線agent.ts#L119-L136本身已包含若干安全約束doom_loop: ask、外部目錄寫入ask、讀取*.env/*.env.*需要確認*.env.example除外、question默認deny、plan_enter/plan_exit默認deny。build 之所以“全權限”是相對這些收緊項的放開而非無任何約束。用戶配置cfg.permission始終通過Permission.merge疊加在最上層可覆蓋上述默認值。4.2 plan寫保護 Agentplan Agent 的權限覆蓋agent.ts#L156-L181精確對應 README 的“拒絕文件編輯”描述edit: { *: deny }—— 拒絕一切編輯但允許寫兩個“計劃文件”例外路徑.opencode/plans/*.md與全局數據目錄下的plans/*.md即 plan 模式可以落盤規劃文檔只是不能改代碼task: { general: deny }—— plan 模式下默認禁止調用 general 子代理plan_exit: allow—— 允許退出 plan 模式返回 build。測試用例直接驗證了這些行為packages/opencode/test/agent/agent.test.ts 斷言 “plan agent denies the general subagent by default”Permission.evaluate(task, general, plan.permission)返回deny并在特定規則集下返回allow。4.3 general多步子代理general 的定義agent.ts#L182-L195描述為 “General-purpose agent for researching complex questions and executing multi-step tasks”其唯一額外收緊項是todowrite: deny子代理不寫 TODO 清單。從源碼結構看CLI 的 run 命令在執行子任務時默認subagent_type即general見 packages/opencode/src/cli/cmd/run/tool.ts這與 README “通過general在消息中調用” 的說明一致。此外源碼中還存在一個未在 README 展開的explore只讀搜索子代理agent.ts#L196-L218其權限僅開放 grep / glob / list / read / web 檢索等只讀工具可作為 plan 模式探索場景的補充參考。5. 貢獻與衍生項目命名約定README 最后給出兩條社區規范貢獻提交 pull request 前應先閱讀 CONTRIBUTING.md。衍生項目聲明如果你的項目名包含 “opencode”例如 “opencode-dashboard”、“opencode-mobile”但并非 OpenCode 團隊開發應在你的 README 中明確注明該項目與 OpenCode 團隊無隸屬關系。6. 延伸閱讀路徑主題倉庫路徑安裝腳本含參數、平臺檢測、PATH 寫入installAgent 注冊與權限合并packages/opencode/src/agent/agent.tsAgent 權限測試packages/opencode/test/agent/agent.test.ts卸載 / PATH 清理packages/opencode/src/cli/cmd/uninstall.ts桌面端BETA含 WSL 集成packages/desktop貢獻規范CONTRIBUTING.md多語言 README 索引README.md【免費下載鏈接】opencodeThe open source coding agent.項目地址: https://gitcode.com/GitHub_Trending/openc/opencode創作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考 OpenCode 開源編碼代理：安裝通道、目錄優先級與 build / plan / general Agent 體系詳解
OpenCode 開源編碼代理安裝通道、目錄優先級與 build / plan / general Agent 體系詳解【免費下載鏈接】opencodeThe open source coding agent.項目地址: https://gitcode.com/GitHub_Trending/openc/opencode本文基于 OpenCode 倉庫根目錄的丹麥語版 READMEREADME.da.md及其對應的真實實現展開覆蓋三條主線OpenCode 的完整安裝通道一鍵腳本與各包管理器、安裝腳本的目錄優先級與 PATH 處理邏輯、以及內置 build / plan 雙 Agent 加 general 子代理的權限模型。讀完后你可以獨立完成安裝與升級、理解二進制落盤位置并能從源碼層面解釋每個 Agent 的權限邊界。1. OpenCode 是什么OpenCode 自稱 “The open source AI-kodeagent”開源 AI 編碼代理。它的主入口是一個終端 TUI在項目目錄中運行opencode命令即可進入交互式編碼會話同時項目提供了一個處于 BETA 階段的桌面應用。本倉庫是多包 monorepo核心實現位于 packages/opencode 包中本文涉及的關鍵證據包括安裝腳本install倉庫根目錄的 bash 腳本Agent 定義packages/opencode/src/agent/agent.tsAgent 行為測試packages/opencode/test/agent/agent.test.ts卸載命令packages/opencode/src/cli/cmd/uninstall.ts2. 安裝方式README 提供了“YOLO”式一鍵安裝與各包管理器安裝兩大類通道以下完整繼承原文檔內容。2.1 一鍵安裝腳本# YOLO curl -fsSL https://opencode.ai/install | bash倉庫根目錄的 install 腳本即該類安裝器的參考實現。從腳本的usage()幫助文本install#L10-L27可以看到它實際支持的參數參數說明-h, --help顯示幫助信息-v, --version version安裝指定版本例如1.0.180-b, --binary path從本地二進制安裝跳過所有下載與檢測邏輯--no-modify-path不修改 shell 配置文件.zshrc、.bashrc 等對應的調用形態為curl -fsSL https://opencode.ai/install | bash -s -- --version 1.0.180 ./install --binary /path/to/opencode腳本內部還有幾個值得注意的健壯性設計均為源碼可確認事實平臺矩陣僅接受linux-x64、linux-arm64、darwin-x64、darwin-arm64、windows-x64五種組合其余直接報錯退出install#L103-L110。Rosetta 檢測在 Intel 轉譯運行的 macOSsysctl.proc_translated 1上會自動改用 arm64 二進制。AVX2 baseline 檢測x64 平臺上若 CPU 不支持 AVX2Linux 查/proc/cpuinfo、macOS 查hw.optional.avx2_0、Windows 通過 PowerShell 調IsProcessorFeaturePresent(40)下載目標會自動追加-baseline后綴。musl 檢測Alpine 或ldd --version輸出含 musl 的 Linux 會下載-musl變體。版本校驗check_version()會先執行已安裝的opencode --version若目標版本已安裝則直接退出install#L221-L235指定版本時還會先對 release 做 HEAD 請求404 則報 “Release vX not found”。PATH 自動寫入腳本按當前 shellfish / zsh / bash / ash / sh選擇對應配置文件追加 PATH 語句已有相同內容則跳過在 GitHub Actions 環境中會額外寫入$GITHUB_PATHinstall#L362-L444。2.2 包管理器安裝npm i -g opencode-ailatest # 或用 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 (AUR 最新版) mise use -g opencode # 所有操作系統 nix run nixpkgs#opencode # 或 github:anomalyco/opencode 獲取最新 dev 分支提示原文檔 TIP安裝前先移除 0.1.x 之前的舊版本。倉庫中的卸載命令 packages/opencode/src/cli/cmd/uninstall.ts 會清理.opencode/bin相關的 PATH 配置行包括 bash 的export PATH、fish 的fish_add_path以及# opencode標記注釋可作為移除舊安裝的參考實現。2.3 桌面應用BETAOpenCode 也以桌面應用形式發布可從 releases 頁或官網下載頁獲取。各平臺安裝包命名如下原文檔表格平臺下載文件macOS (Apple Silicon)opencode-desktop-mac-arm64.dmgmacOS (Intel)opencode-desktop-mac-x64.dmgWindowsopencode-desktop-windows-x64.exeLinux.deb、.rpm或 AppImage包管理器渠道# macOS (Homebrew) brew install --cask opencode-desktop # Windows (Scoop) scoop bucket add extras; scoop install extras/opencode-desktop桌面端源碼位于 packages/desktop其主進程在 WSL 場景下還會探測$HOME/.opencode/bin/opencode這一典型安裝路徑見 packages/desktop/src/main/wsl/runtime.ts與下文安裝目錄的默認 fallback 相互印證。3. 安裝目錄的優先級README 指出安裝腳本按以下順序確定安裝路徑$OPENCODE_INSTALL_DIR—— 自定義安裝目錄$XDG_BIN_DIR—— 遵循 XDG Base Directory Specification 的目錄$HOME/bin—— 標準用戶 bin 目錄若存在或可創建$HOME/.opencode/bin—— 默認 fallback配合環境變量的用法示例原文檔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 | bash需要說明的證據邊界倉庫根目錄的 install 腳本當前將安裝目錄硬編碼為$HOME/.opencode/binINSTALL_DIR$HOME/.opencode/bin并mkdir -p。因此上述四級優先級描述的是官方https://opencode.ai/install托管安裝器的行為約定而本倉庫腳本可確認的是默認落盤位置、PATH 寫入邏輯與 GITHUB_PATH 處理。若你在 CI 或受限環境中安裝以$HOME/.opencode/bin作為二進制落盤位置做后續引用如桌面端 WSL 探測邏輯是最穩妥的假設。4. Agent 體系build、plan 與 generalREADME 描述了 OpenCode 的兩個內置 Agent——可在會話中用Tab鍵切換——以及一個內部子代理build—— 默認 Agent擁有完整的開發工作權限plan—— 只讀 Agent用于分析與代碼探索默認拒絕文件編輯執行 bash 命令前會請求許可適合探索陌生代碼庫或規劃改動general—— 面向復雜搜索與多步任務的子代理內部使用可通過在消息中general調用這段描述與源碼高度吻合。三個原生 Agent 在 packages/opencode/src/agent/agent.ts 中以mode: primarybuild、plan和mode: subagentgeneral的方式注冊其權限由Permission.merge分層合并4.1 build默認 Agentbuild 在默認權限之上放開了兩個動作agent.ts#L141-L155question: allow—— 允許 Agent 主動向用戶提問plan_enter: allow—— 允許進入 plan 模式默認權限基線agent.ts#L119-L136本身已包含若干安全約束doom_loop: ask、外部目錄寫入ask、讀取*.env/*.env.*需要確認*.env.example除外、question默認deny、plan_enter/plan_exit默認deny。build 之所以“全權限”是相對這些收緊項的放開而非無任何約束。用戶配置cfg.permission始終通過Permission.merge疊加在最上層可覆蓋上述默認值。4.2 plan寫保護 Agentplan Agent 的權限覆蓋agent.ts#L156-L181精確對應 README 的“拒絕文件編輯”描述edit: { *: deny }—— 拒絕一切編輯但允許寫兩個“計劃文件”例外路徑.opencode/plans/*.md與全局數據目錄下的plans/*.md即 plan 模式可以落盤規劃文檔只是不能改代碼task: { general: deny }—— plan 模式下默認禁止調用 general 子代理plan_exit: allow—— 允許退出 plan 模式返回 build。測試用例直接驗證了這些行為packages/opencode/test/agent/agent.test.ts 斷言 “plan agent denies the general subagent by default”Permission.evaluate(task, general, plan.permission)返回deny并在特定規則集下返回allow。4.3 general多步子代理general 的定義agent.ts#L182-L195描述為 “General-purpose agent for researching complex questions and executing multi-step tasks”其唯一額外收緊項是todowrite: deny子代理不寫 TODO 清單。從源碼結構看CLI 的 run 命令在執行子任務時默認subagent_type即general見 packages/opencode/src/cli/cmd/run/tool.ts這與 README “通過general在消息中調用” 的說明一致。此外源碼中還存在一個未在 README 展開的explore只讀搜索子代理agent.ts#L196-L218其權限僅開放 grep / glob / list / read / web 檢索等只讀工具可作為 plan 模式探索場景的補充參考。5. 貢獻與衍生項目命名約定README 最后給出兩條社區規范貢獻提交 pull request 前應先閱讀 CONTRIBUTING.md。衍生項目聲明如果你的項目名包含 “opencode”例如 “opencode-dashboard”、“opencode-mobile”但并非 OpenCode 團隊開發應在你的 README 中明確注明該項目與 OpenCode 團隊無隸屬關系。6. 延伸閱讀路徑主題倉庫路徑安裝腳本含參數、平臺檢測、PATH 寫入installAgent 注冊與權限合并packages/opencode/src/agent/agent.tsAgent 權限測試packages/opencode/test/agent/agent.test.ts卸載 / PATH 清理packages/opencode/src/cli/cmd/uninstall.ts桌面端BETA含 WSL 集成packages/desktop貢獻規范CONTRIBUTING.md多語言 README 索引README.md【免費下載鏈接】opencodeThe open source coding agent.項目地址: https://gitcode.com/GitHub_Trending/openc/opencode創作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考