安装方式
# YOLO
curl -fsSL https://opencode.ai/install | bash
# Package managers
npm i -g opencode-ai@latest # or bun/pnpm/yarn
scoop install opencode # Windows
choco install opencode # Windows
brew install anomalyco/tap/opencode # macOS and Linux (recommended, always up to date)
brew install opencode # macOS and Linux (official brew formula, updated less)
sudo pacman -S opencode # Arch Linux (Stable)
paru -S opencode-bin # Arch Linux (Latest from AUR)
mise use -g opencode # Any OS
nix run nixpkgs#opencode # or github:anomalyco/opencode for latest dev branchmint虚拟机部署
最快安装
curl -fsSL https://opencode.ai/install | bash opencode --version opencode #启动进命令行,输入下面内容让ai自己安装 Install and configure oh-my-opencode by following the instructions here: https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/docs/guide/installation.md
本地化
~/.config/opencode/opencode.json
{ "$schema": "https://opencode.ai/config.json", "provider": { "myprovider": { "npm": "@ai-sdk/openai-compatible", "name": "JieKou", "options": { "baseURL": "https://api.jiekou.ai/openai/v1" }, "models": { "claude-sonnet-4-5-20250929": { "name": "claude-sonnet-4-5-20250929" }, "gpt-5.2": { "name": "gpt-5.2" }, } } } }环境变量
# 目录文件 export OPENCODE_CONFIG_DIR=/www/opencode/data/teams export OPENCODE_CONFIG=/www/opencode/data/teams/default.json # claude行为开关 export OPENCODE_DISABLE_CLAUDE_CODE=1 # Disable all export OPENCODE_DISABLE_CLAUDE_CODE_PROMPT=1 # Disable only ~/.claude/CLAUDE.md export OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 # Disable only .claude/skills
团队设置
运行模式设置
# vi default.json { "team_mode": true, "offline": true, "workspace": "./opencode-projects", "git_auto_commit": true, "git_init_if_missing": true <--- 【没有仓库也自动创建】 "models": { "local-api": { "provider": "openai", "base_url": "http://localhost:8000/v1", // 改成本地 API 地址 "api_key": "sk-anything", "timeout": 120 } }, "agents": { "architect": { "model": "local-api:code-model", "role": "architect", "temperature": 0.1 }, "tech_lead": { "model": "local-api:code-model", "role": "tech_lead", "temperature": 0.2 }, "dev1": { "model": "local-api:code-model", "role": "developer", "temperature": 0.3 }, "dev2": { "model": "local-api:code-model", "role": "developer", "temperature": 0.3 }, "tester": { "model": "local-api:code-model", "role": "tester", "temperature": 0.2 } } }opencode # 团队 + 离线 (默认配置) opencode --online # 团队 + 在线 opencode --no-team # 单例 + 离线 opencode --no-team --online # 单例 + 在线 ----------------启动日志--------------- [team] enabled [offline] mode enabled [config] loaded team: default [model] using local-openai (http://localhost:1234/v1) [workspace] /workspace [git] auto commit enabled