OpenCode 俄语版 README 全解安装渠道、安装目录优先级与内置 Agent 体系【免费下载链接】opencodeThe open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/openc/opencode本文以 俄语版 README 为骨架系统梳理 OpenCode开源 AI 编程 Agent的全部安装方式、安装目录选择策略、桌面应用BETA获取途径以及 build / plan / general 三种 Agent 模式的职责边界与权限差异。读完后你将能够在 macOS、Linux、Windows 上选择最合适的渠道安装 OpenCode 并正确配置 PATH理解安装脚本在仓库中的真实实现逻辑并在终端会话中熟练切换内置 Agent 完成“规划—实施”分离的开发流程。一、安装一键脚本与包管理器俄语版 README 给出的安装命令覆盖了从“一步到位”到“包管理器托管”的完整光谱完整继承如下# YOLO一键脚本安装 curl -fsSL https://opencode.ai/install | bash # 包管理器 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 公式更新较少 sudo pacman -S opencode # Arch LinuxStable paru -S opencode-bin # Arch LinuxAUR 最新版 mise use -g opencode # 任意操作系统 nix run nixpkgs#opencode # 或 github:anomalyco/opencode 获取最新 dev 分支各渠道的定位区别值得注意anomalyco/tap/opencode这个 Homebrew tap 是官方推荐路径更新最及时而brew install opencode走的是 Homebrew 官方公式同步频率较低但稳定性更高Nix 用户除nixpkgs#opencode外还可以直接钉住 dev 分支做尝鲜。[!TIP] 安装前请删除 0.1.x 之前的旧版本README 原文明确提示这一点。旧版本与新版本的命令行接口、数据目录不兼容残留的旧二进制可能导致opencode命令行为异常。1.1 安装脚本支持的参数仓库根目录保留了安装脚本本体 install。从源码看该脚本并非只有“下载最新版”一种行为它支持以下命令行选项见 install 中的 usage 定义选项作用-h, --help显示帮助信息-v, --version 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/opencode1.2 脚本内部的平台适配逻辑结合 install 源码脚本在下载前做了几件对生产环境很有意义的事操作系统与架构归一化将uname -s/uname -m的原始输出归一为darwin/linux/windows与x64/arm64仅接受linux-x64|linux-arm64|darwin-x64|darwin-arm64|windows-x64这五种组合其余直接报错退出见 install。Rosetta 检测在 macOS x64 上通过sysctl.proc_translated判断是否运行在 Rosetta 转译环境若是则改用 arm64 构建避免在 Apple Silicon 上装到 Intel 二进制。musl 检测Linux 下通过/etc/alpine-release或ldd --version输出识别 musl libc如 Alpine追加-musl目标后缀。AVX2 baseline 检测x64 平台上若 CPU 不支持 AVX2Linux 查/proc/cpuinfomacOS 查hw.optional.avx2_0Windows 调IsProcessorFeaturePresent(40)则回退到-baseline构建保证老 CPU 可运行。下载与解压Linux 使用.tar.gztar其余平台使用.zipunzip并在 TTY 环境下渲染带进度条的下载过程非 TTY 或 Windows 环境回退到标准curl -#。版本校验若已存在opencode命令且版本一致脚本直接跳过安装退出见 install。安装完成后脚本会按当前 shellfish/zsh/bash/ash/sh向对应的 rc 文件追加export PATH或fish_add_path语句且做了幂等处理已存在则跳过在 GitHub Actions 环境中则自动写入$GITHUB_PATH见 install。仓库内的脚本将默认安装目录写死为$HOME/.opencode/bininstall这与下文 README 描述的优先级体系中的 fallback 一致。1.3 安装目录的优先级顺序README 中“Каталог установки”安装目录一节明确了安装脚本选择安装路径的四级优先级$OPENCODE_INSTALL_DIR—— 自定义安装目录$XDG_BIN_DIR—— 符合 XDG Base Directory Specification 的路径$HOME/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这条优先级链对团队统一部署很有价值例如在 CI 机器上统一指向/usr/local/bin或在遵循 XDG 规范的发行版上放入~/.local/bin而普通用户则自动落回~/.opencode/bin且不污染系统目录。二、桌面应用BETAOpenCode 除终端形态外还提供桌面应用BETA 状态。README 给出的平台与下载物对照表如下平台下载物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桌面应用的产物命名规则在仓库中有源码级印证electron-builder 打包配置 中artifactName被定义为opencode-desktop-${os}-${arch}.${ext}与上表中的文件名完全一致打包产物收尾脚本 还会处理opencode-desktop-mac-arm64.app.tar.gz等 macOS 自动更新包。也就是说README 表格并非营销文案而是可直接在打包配置中逐一对应的真实产物。三、内置 Agentsbuild、plan 与 general 子代理这是 README 技术含量最高的部分。OpenCode 内置两个可用Tab键切换的一级 Agent另有一个内部子代理build—— 默认 Agent拥有完整权限面向开发工作写代码、改文件、跑命令。plan—— 只读 Agent用于代码分析与探索默认拒绝文件编辑执行 bash 命令前请求许可适合研究陌生代码库或规划改动方案。general—— 面向复杂检索和多步任务的子代理供内部调用也可以在消息中通过general显式唤起。从源码结构看这套“双 Agent 子代理”的设计在 Agent 服务定义 中有明确落点agent.ts 中的默认 Agent 集合 定义了build与plan两个内置 Agent并通过permission字段PermissionV1.Ruleset声明各自的权限集plan默认file_edit: deny仅在计划文件路径Global.Path.data/plans/*、.opencode/plans/*.md上放开写权限且对plan_enter/plan_exit等模式切换权限做 allow/deny 区分默认 Agent 的选择逻辑 显示除非配置了default_agent否则默认值就是build与 README“build 是默认 Agent”的描述一致Agent 的mode字段支持subagent | primary | all见 Info Schema从源码结构看general正是以 subagent 形态注册、可被general呼出的plan模式下限制 bash 的配套工具实现位于 plan 工具。这一权限体系的实际价值在于面对陌生代码库时先切到plan让 Agent 只读地梳理架构、产出改动计划计划落盘到 plans 目录确认无误后按Tab切回build执行从而把“分析”与“修改”两种风险等级不同的操作隔离开。四、文档、贡献与“基于 OpenCode 构建”的命名约定配置文档关于如何进一步配置 OpenCodeREADME 指向官方文档站opencode.ai/docs。仓库内文档源码位于 docs 目录其中 quickstart.mdx、development.mdx 与 openapi.json 可作为深入阅读入口俄语版 README 的英文主版本见 README.md。贡献流程向 OpenCode 提交 pull request 前应先阅读 贡献指南。命名规范Building on OpenCode 一节README 特别约定——如果你的项目与 OpenCode 相关且名称中包含 “opencode”例如 “opencode-dashboard”、“opencode-mobile”务必在自己的 README 中注明该项目并非由 OpenCode 团队开发、与官方无任何隶属关系。这是对开源生态中“蹭名项目”的一种自律性规范第三方集成者在发布前应对照检查。五、小结俄语版 README 虽然篇幅不长但信息密度很高它用一组命令覆盖了 9 种安装渠道用四级优先级OPENCODE_INSTALL_DIR→XDG_BIN_DIR→$HOME/bin→$HOME/.opencode/bin定义了跨平台安装目录策略并用 build / plan / general 三个 Agent 勾勒出 OpenCode“规划与执行分离、权限随角色收敛”的核心工作范式。配合仓库中的 安装脚本、Agent 源码 与 桌面打包配置文档中每一条承诺都能在源码中找到对应实现这也是阅读 OpenCode 多语言 README 时值得借鉴的“文档—代码互证”方式。【免费下载链接】opencodeThe open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/openc/opencode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/5 16:38:11 · 阅读 1.2k OpenCode 俄语版 README 全解：安装渠道、安装目录优先级与内置 Agent 体系
OpenCode 俄语版 README 全解安装渠道、安装目录优先级与内置 Agent 体系【免费下载链接】opencodeThe open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/openc/opencode本文以 俄语版 README 为骨架系统梳理 OpenCode开源 AI 编程 Agent的全部安装方式、安装目录选择策略、桌面应用BETA获取途径以及 build / plan / general 三种 Agent 模式的职责边界与权限差异。读完后你将能够在 macOS、Linux、Windows 上选择最合适的渠道安装 OpenCode 并正确配置 PATH理解安装脚本在仓库中的真实实现逻辑并在终端会话中熟练切换内置 Agent 完成“规划—实施”分离的开发流程。一、安装一键脚本与包管理器俄语版 README 给出的安装命令覆盖了从“一步到位”到“包管理器托管”的完整光谱完整继承如下# YOLO一键脚本安装 curl -fsSL https://opencode.ai/install | bash # 包管理器 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 公式更新较少 sudo pacman -S opencode # Arch LinuxStable paru -S opencode-bin # Arch LinuxAUR 最新版 mise use -g opencode # 任意操作系统 nix run nixpkgs#opencode # 或 github:anomalyco/opencode 获取最新 dev 分支各渠道的定位区别值得注意anomalyco/tap/opencode这个 Homebrew tap 是官方推荐路径更新最及时而brew install opencode走的是 Homebrew 官方公式同步频率较低但稳定性更高Nix 用户除nixpkgs#opencode外还可以直接钉住 dev 分支做尝鲜。[!TIP] 安装前请删除 0.1.x 之前的旧版本README 原文明确提示这一点。旧版本与新版本的命令行接口、数据目录不兼容残留的旧二进制可能导致opencode命令行为异常。1.1 安装脚本支持的参数仓库根目录保留了安装脚本本体 install。从源码看该脚本并非只有“下载最新版”一种行为它支持以下命令行选项见 install 中的 usage 定义选项作用-h, --help显示帮助信息-v, --version 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/opencode1.2 脚本内部的平台适配逻辑结合 install 源码脚本在下载前做了几件对生产环境很有意义的事操作系统与架构归一化将uname -s/uname -m的原始输出归一为darwin/linux/windows与x64/arm64仅接受linux-x64|linux-arm64|darwin-x64|darwin-arm64|windows-x64这五种组合其余直接报错退出见 install。Rosetta 检测在 macOS x64 上通过sysctl.proc_translated判断是否运行在 Rosetta 转译环境若是则改用 arm64 构建避免在 Apple Silicon 上装到 Intel 二进制。musl 检测Linux 下通过/etc/alpine-release或ldd --version输出识别 musl libc如 Alpine追加-musl目标后缀。AVX2 baseline 检测x64 平台上若 CPU 不支持 AVX2Linux 查/proc/cpuinfomacOS 查hw.optional.avx2_0Windows 调IsProcessorFeaturePresent(40)则回退到-baseline构建保证老 CPU 可运行。下载与解压Linux 使用.tar.gztar其余平台使用.zipunzip并在 TTY 环境下渲染带进度条的下载过程非 TTY 或 Windows 环境回退到标准curl -#。版本校验若已存在opencode命令且版本一致脚本直接跳过安装退出见 install。安装完成后脚本会按当前 shellfish/zsh/bash/ash/sh向对应的 rc 文件追加export PATH或fish_add_path语句且做了幂等处理已存在则跳过在 GitHub Actions 环境中则自动写入$GITHUB_PATH见 install。仓库内的脚本将默认安装目录写死为$HOME/.opencode/bininstall这与下文 README 描述的优先级体系中的 fallback 一致。1.3 安装目录的优先级顺序README 中“Каталог установки”安装目录一节明确了安装脚本选择安装路径的四级优先级$OPENCODE_INSTALL_DIR—— 自定义安装目录$XDG_BIN_DIR—— 符合 XDG Base Directory Specification 的路径$HOME/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这条优先级链对团队统一部署很有价值例如在 CI 机器上统一指向/usr/local/bin或在遵循 XDG 规范的发行版上放入~/.local/bin而普通用户则自动落回~/.opencode/bin且不污染系统目录。二、桌面应用BETAOpenCode 除终端形态外还提供桌面应用BETA 状态。README 给出的平台与下载物对照表如下平台下载物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桌面应用的产物命名规则在仓库中有源码级印证electron-builder 打包配置 中artifactName被定义为opencode-desktop-${os}-${arch}.${ext}与上表中的文件名完全一致打包产物收尾脚本 还会处理opencode-desktop-mac-arm64.app.tar.gz等 macOS 自动更新包。也就是说README 表格并非营销文案而是可直接在打包配置中逐一对应的真实产物。三、内置 Agentsbuild、plan 与 general 子代理这是 README 技术含量最高的部分。OpenCode 内置两个可用Tab键切换的一级 Agent另有一个内部子代理build—— 默认 Agent拥有完整权限面向开发工作写代码、改文件、跑命令。plan—— 只读 Agent用于代码分析与探索默认拒绝文件编辑执行 bash 命令前请求许可适合研究陌生代码库或规划改动方案。general—— 面向复杂检索和多步任务的子代理供内部调用也可以在消息中通过general显式唤起。从源码结构看这套“双 Agent 子代理”的设计在 Agent 服务定义 中有明确落点agent.ts 中的默认 Agent 集合 定义了build与plan两个内置 Agent并通过permission字段PermissionV1.Ruleset声明各自的权限集plan默认file_edit: deny仅在计划文件路径Global.Path.data/plans/*、.opencode/plans/*.md上放开写权限且对plan_enter/plan_exit等模式切换权限做 allow/deny 区分默认 Agent 的选择逻辑 显示除非配置了default_agent否则默认值就是build与 README“build 是默认 Agent”的描述一致Agent 的mode字段支持subagent | primary | all见 Info Schema从源码结构看general正是以 subagent 形态注册、可被general呼出的plan模式下限制 bash 的配套工具实现位于 plan 工具。这一权限体系的实际价值在于面对陌生代码库时先切到plan让 Agent 只读地梳理架构、产出改动计划计划落盘到 plans 目录确认无误后按Tab切回build执行从而把“分析”与“修改”两种风险等级不同的操作隔离开。四、文档、贡献与“基于 OpenCode 构建”的命名约定配置文档关于如何进一步配置 OpenCodeREADME 指向官方文档站opencode.ai/docs。仓库内文档源码位于 docs 目录其中 quickstart.mdx、development.mdx 与 openapi.json 可作为深入阅读入口俄语版 README 的英文主版本见 README.md。贡献流程向 OpenCode 提交 pull request 前应先阅读 贡献指南。命名规范Building on OpenCode 一节README 特别约定——如果你的项目与 OpenCode 相关且名称中包含 “opencode”例如 “opencode-dashboard”、“opencode-mobile”务必在自己的 README 中注明该项目并非由 OpenCode 团队开发、与官方无任何隶属关系。这是对开源生态中“蹭名项目”的一种自律性规范第三方集成者在发布前应对照检查。五、小结俄语版 README 虽然篇幅不长但信息密度很高它用一组命令覆盖了 9 种安装渠道用四级优先级OPENCODE_INSTALL_DIR→XDG_BIN_DIR→$HOME/bin→$HOME/.opencode/bin定义了跨平台安装目录策略并用 build / plan / general 三个 Agent 勾勒出 OpenCode“规划与执行分离、权限随角色收敛”的核心工作范式。配合仓库中的 安装脚本、Agent 源码 与 桌面打包配置文档中每一条承诺都能在源码中找到对应实现这也是阅读 OpenCode 多语言 README 时值得借鉴的“文档—代码互证”方式。【免费下载链接】opencodeThe open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/openc/opencode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考