已归档：项目已迁移

此存储库不再维护，仅作为存档保留以记录历史。

该项目已由原作者与 Charm 团队以 Crush 的名称继续开发。

请关注 Crush 以获取后续更新。

⌬ OpenCode

⚠️ 早期开发阶段通知： 本项目处于早期开发阶段，尚未达到生产就绪状态。功能可能会发生变更、中断或不完整。使用风险自负。

一个强大的终端 AI 开发助手，直接在你的终端中提供智能编码辅助。

概述

OpenCode 是一个基于 Go 语言的 CLI 应用程序，旨在为终端引入 AI 辅助功能。它提供了一个 TUI（终端用户界面），用于与各种 AI 模型进行交互，从而协助处理编码任务、调试等工作。

观看快速概览视频，请查看： OpenCode + Gemini 2.5 Pro: BYE Claude Code! I'm SWITCHING To the FASTEST AI Coder!

特性

交互式 TUI：基于 Bubble Tea 构建，提供流畅的终端体验
多 AI 提供商支持：支持 OpenAI、Anthropic Claude、Google Gemini、AWS Bedrock、Groq、Azure OpenAI 和 OpenRouter
会话管理：保存并管理多个对话会话
工具集成：AI 可以执行命令、搜索文件及修改代码
类似 Vim 的编辑器：集成的编辑器，具备文本输入能力
持久化存储：使用 SQLite 数据库存储对话和会话
LSP 集成：支持 Language Server Protocol 以实现代码智能提示
文件变更跟踪：在会话期间跟踪并可视化文件变更
外部编辑器支持：可调用你偏好的编辑器来编写消息
自定义命令命名参数：支持通过多个命名占位符创建强大的自定义命令

安装

使用安装脚本

# 安装最新版本
curl -fsSL https://raw.githubusercontent.com/opencode-ai/opencode/refs/heads/main/install | bash

# 安装特定版本
curl -fsSL https://raw.githubusercontent.com/opencode-ai/opencode/refs/heads/main/install | VERSION=0.1.0 bash

使用 Homebrew (macOS 和 Linux)

brew install opencode-ai/tap/opencode

使用 AUR (Arch Linux)

# 使用 yay
yay -S opencode-ai-bin

# 使用 paru
paru -S opencode-ai-bin

使用 Go

go install github.com/opencode-ai/opencode@latest

配置

OpenCode 会在以下位置查找配置文件：

$HOME/.opencode.json
$XDG_CONFIG_HOME/opencode/.opencode.json
./.opencode.json (当前本地目录)

自动压缩功能

OpenCode 包含一项自动压缩功能，当对话接近模型的上下文窗口限制时，它会自动对对话进行摘要。启用此功能（默认设置）后：

监控对话期间的 Token 使用量
当使用量达到模型上下文窗口的 95% 时，自动触发摘要生成
创建包含摘要的新会话，让你无需丢失上下文即可继续工作
有助于防止长对话中可能出现的“超出上下文 (out of context)”错误

你可以在配置文件中启用或禁用此功能：

{
  "autoCompact": true // 默认为 true
}

环境变量

你可以通过环境变量配置 OpenCode：

环境变量	用途
`ANTHROPIC_API_KEY`	用于 Claude 模型
`OPENAI_API_KEY`	用于 OpenAI 模型
`GEMINI_API_KEY`	用于 Google Gemini 模型
`GITHUB_TOKEN`	用于 Github Copilot 模型 (参考使用 Github Copilot)
`VERTEXAI_PROJECT`	用于 Google Cloud VertexAI (Gemini)
`VERTEXAI_LOCATION`	用于 Google Cloud VertexAI (Gemini)
`GROQ_API_KEY`	用于 Groq 模型
`AWS_ACCESS_KEY_ID`	用于 AWS Bedrock (Claude)
`AWS_SECRET_ACCESS_KEY`	用于 AWS Bedrock (Claude)
`AWS_REGION`	用于 AWS Bedrock (Claude)
`AZURE_OPENAI_ENDPOINT`	用于 Azure OpenAI 模型
`AZURE_OPENAI_API_KEY`	用于 Azure OpenAI 模型