opencode

在终端里用 AI 写代码，自动改文件跑命令

opencode 是一个运行在终端中的 AI 编程代理，用 Go 语言开发。它旨在将强大的 AI 编码能力直接带入命令行环境，解决开发者在 IDE 之外难以获得智能辅助的问题。核心能力包括：理解自然语言指令并自动生成代码、在终端中执行命令并观察结果、多文件编辑与重构、以及通过终端 UI 提供交互式反馈。它支持多种主流 AI 模型，如 Claude、GPT 等，并允许用户自定义配置。通过将 AI 代理与终端深度结合，opencode 让开发者无需离开终端即可完成从代码生成到测试运行的完整开发循环，提升了开发效率和自动化水平。

开源 free 开源模型

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 13762

维护状态低维护

是否开源是

定价模式 free

项目数据

分类开源模型

开发团队opencode-ai

所属国家

官网地址

GitHubhttps://github.com/opencode-ai/opencode

定价模式free

价格说明开源项目，MIT许可证，完全免费，可自行部署使用。

访问状态

是否开源是

开源协议MIT

主要语言Go

技术栈/模型ai,claude,code,llm,openai

GitHub 星标★ 13762

30天Star增速

HF 下载量

上线时间2025-03-16 00:00:00

最近更新2026-09-22 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

类 Unix 终端环境，可用 curl 与 bash 执行安装脚本
网络可访问 GitHub（raw.githubusercontent.com）
至少一个 AI 提供商的 API Key（OpenAI、Anthropic、Groq、OpenRouter 等）
注意：该仓库已归档，官方建议改用 Charm 团队的 Crush 项目

安装与启动步骤

1运行安装脚本

用 curl 拉取官方 install 脚本并通过 bash 执行，安装最新版 opencode，需能访问 GitHub 原始文件地址。
```
curl -fsSL https://raw.githubusercontent.com/opencode-ai/opencode/refs/heads/main/install | bash
```
2安装指定版本

如需固定版本，用 VERSION 环境变量指定，README 示例为 0.1.0，替换即得其他版本。
```
curl -fsSL https://raw.githubusercontent.com/opencode-ai/opencode/refs/heads/main/install | VERSION=0.1.0 bash
```
3创建配置文件

在 $HOME/.opencode.json、$XDG_CONFIG_HOME/opencode/.opencode.json 或当前目录 ./.opencode.json 任选一处新建配置文件。
4填入密钥与模型

配置 providers 中至少一个提供商的 apiKey，并在 agents 里指定 coder/task/title 使用的模型名称。
5单次提问运行

用 -p 直接传入提示词，程序处理完打印结果到标准输出后退出，该会话内所有权限自动批准。
```
opencode -p "Explain the use of context in Go"
```
6静默模式调用

加 -q 或 --quiet 关闭等待时的 spinner 动画，适合在脚本或自动化流程中调用。
```
opencode -p "Explain the use of context in Go" -q
```
7启动交互式 TUI

直接运行可执行文件进入终端交互界面，需先切换到二进制所在目录。
```
./opencode
```

关键配置

配置项	必填	说明	示例
`providers.anthropic.apiKey`	是	Anthropic 密钥，providers 下至少要配好一个提供商的密钥	`sk-ant-xxxxxxxx`
`providers.openai.apiKey`	否	OpenAI 提供商密钥，disabled 设为 false 时启用	`sk-xxxxxxxx`
`agents.coder.model`	是	coder 代理使用的模型名称，决定代码生成能力来源	`claude-3.7-sonnet`
`data.directory`	否	存放 opencode 数据的目录名	`.opencode`
`shell.path`	否	bash 工具使用的 shell，默认取 SHELL 变量，未设置则用 /bin/bash	`/bin/zsh`
`debug`	否	是否开启调试输出	`false`

如何确认成功

执行 opencode -p "Explain the use of context in Go" 后，终端直接输出 AI 回答并正常退出，即说明安装与配置成功。

常见问题

Q：这个仓库还能继续用吗？

A：README 明确说明仓库已归档、不再维护，项目已由原作者与 Charm 团队以 Crush 为名继续开发，长期使用建议迁移到 Crush。

Q：配置文件应该放在哪里？

A：可放在 $HOME/.opencode.json、$XDG_CONFIG_HOME/opencode/.opencode.json，或当前目录的 ./.opencode.json，三处任选其一即可。

Q：怎样在脚本里调用而不显示动画？

A：加上 -q 或 --quiet 参数即可关闭等待时的 spinner 动画，例如 opencode -p "你的问题" -q。

Q：必须配置 API Key 吗？

A：需要至少配置一个提供商（如 anthropic、openai、groq、openrouter）的 apiKey，或启用 copilot 提供商，否则模型无法调用。

注意事项

该项目 README 顶部已标注 Archived，不再维护，生产环境使用风险自负。
README 同时标注处于早期开发阶段，功能可能变更、失效或不完整。
API Key 属于敏感信息，不要把含密钥的 .opencode.json 提交到公开仓库。
MCP 工具配置后会与内置工具一样需要用户逐次授权才能执行。

核心亮点

原生终端体验，无需离开命令行即可完成编码任务，适合服务器环境
支持多文件编辑和命令执行，能自主完成从写代码到运行测试的闭环
基于 Go 开发，性能好且部署简单，单二进制文件即可运行

不足之处

终端 UI 交互相对 IDE 插件仍显简陋，复杂调试场景支持有限
文档/社区待观察

适用场景

在远程服务器或容器中直接进行 AI 辅助开发
自动化代码生成、重构和测试的脚本化工作流
偏好命令行工作流、追求极简开发环境的开发者

替代项目

Aider、Open Interpreter、Cline

项目介绍

opencode 是编程开发领域的开源项目，由 opencode-ai 开发，2025 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（13,762）位列前 4%，在编程开发分类的 490 个项目里位列前 7%。

近 41 天，它的 GitHub 星标从 13,636 增加到 13,762，净增 126。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-22。MIT许可证，完全免费，可自行部署使用。

它主要面向的使用场景是：在远程服务器或容器中直接进行AI辅助开发。同类可对比的替代方案包括 Aider、Open Interpreter、Cline。

上一篇：plandex

下一篇：forgecode