OpenCode 卸载与重装指南¶

状态: ✅ 已完成

创建日期: 2026-02-21 最后更新: 2026-02-21

文件分布总览¶

路径	内容	卸载时
`~/.opencode/`	主程序安装目录（binary）	删除
`~/.local/bin/opencode`	指向主程序的软链接	删除
`~/.local/share/opencode/`	数据目录（auth、DB、日志）	按需保留
`~/.local/state/opencode`	状态（模型选择、prompt 历史）	按需保留
`~/.config/opencode/`	配置（settings、plugins）	按需保留
`~/.cache/opencode`	运行缓存	删除
`~/.cache/oh-my-opencode`	oh-my-opencode 缓存	删除
`~/.bun/bin/oh-my-opencode`	oh-my-opencode bun 全局包	删除
`~/.bun/install/cache/oh-my-opencode*`	bun 包缓存（历史版本）	可选删除
`~/.bun/install/cache/opencode-*`	bun 包缓存	可选删除
`~/Library/WebKit/ai.opencode.desktop`	WebKit 存储	可选删除
`~/Library/Logs/DiagnosticReports/opencode-*.ips`	崩溃日志	可选删除
`~/.zshrc` 中的 PATH/alias 条目	Shell 环境变量	手动清理

登录信息存储位置¶

核心文件：~/.local/share/opencode/auth.json

包含三个账号的登录凭证：

opencode — OpenCode 账号 key
openai — OpenAI OAuth token（refresh + access + expires）
anthropic — Anthropic OAuth token（refresh + access + expires）

卸载方案¶

方案一：仅卸载程序（保留所有数据和登录）¶

适合重装场景，重装后无需重新登录：

# 删除主程序
rm -rf ~/.opencode

# 删除软链接
rm -f ~/.local/bin/opencode

# 删除 oh-my-opencode
rm -f ~/.bun/bin/oh-my-opencode

# 删除运行缓存
rm -rf ~/.cache/opencode
rm -rf ~/.cache/oh-my-opencode

方案二：完全卸载（彻底清除）¶

彻底删除所有内容（登录、数据、缓存全部清除）：

# 程序本体
rm -rf ~/.opencode
rm -f ~/.local/bin/opencode

# oh-my-opencode
rm -f ~/.bun/bin/oh-my-opencode
rm -rf ~/.bun/install/cache/oh-my-opencode*
rm -rf ~/.bun/install/cache/opencode-*
rm -rf ~/.bun/install/cache/@opencode-ai

# 配置
rm -rf ~/.config/opencode

# 数据（含登录凭证、会话历史 ~1GB）
rm -rf ~/.local/share/opencode

# 状态（模型选择、prompt 历史）
rm -rf ~/.local/state/opencode

# 缓存
rm -rf ~/.cache/opencode
rm -rf ~/.cache/oh-my-opencode

# macOS 系统残留（可选）
rm -rf ~/Library/WebKit/ai.opencode.desktop
rm -f ~/Library/Application\ Support/CrashReporter/opencode_*.plist
rm -f ~/Library/Logs/DiagnosticReports/opencode-*.ips

最后手动清理 ~/.zshrc 中的相关条目：

# 删除这些行：
# export PATH=/Users/pengxin/.opencode/bin:...
# alias wikiai="... opencode"
# alias aiup="opencode-upgrade.sh"
# # opencode

重装并保留登录的完整流程¶

1. 备份登录凭证¶

cp ~/.local/share/opencode/auth.json ~/auth.json.bak

2. 执行方案一卸载（仅卸载程序）¶

rm -rf ~/.opencode
rm -f ~/.local/bin/opencode
rm -f ~/.bun/bin/oh-my-opencode
rm -rf ~/.cache/opencode ~/.cache/oh-my-opencode

3. 重新安装 OpenCode¶

4. 还原登录凭证¶

cp ~/auth.json.bak ~/.local/share/opencode/auth.json

重启 OpenCode，三个账号自动恢复登录，无需重新认证。