OpenCode安装指南
opencode是一个“open source AI coding agent”(开源 AI 编码代理),用于终端、IDE 和桌面等环境的开发辅助工具。是一个 “open source”(开源) 项目。
一、安装opencode
终端输入下面指令:
curl -fsSL https://opencode.ai/install | bash
第一步:验证安装是否成功
首先确认 OpenCode 已经正确安装并加入环境变量,操作如下:
- 保持当前终端窗口打开(或重新打开一个新终端,避免安装脚本的环境未生效);
3. 若终端输出类似 opencode x.x.x(x.x.x 为版本号),说明安装成功;若提示「命令未找到」,可关闭终端重新打开再试(一键脚本已自动配置环境变量,重启终端即可生效)。
第二步:启动 OpenCode 并配置 AI 模型
这是核心步骤,配置完成后才能让 OpenCode 提供 AI 编程服务,优先推荐新手使用内置免费模型(无需 API 密钥,零配置):
1. 启动 OpenCode 终端界面(TUI)终端直接输入以下命令,回车后会进入 OpenCode 的交互式界面(深色终端界面,底部有输入提示):
2. 选择并配置免费模型(无需 API 密钥)
3.(可选)对接第三方模型(如 GPT-4、Claude,需 API 密钥)若你有第三方模型的 API 密钥,可输入 /connect 命令,按提示选择模型提供商(如 openai),再粘贴对应的 API 密钥,回车即可完成绑定。
二、测试基础能力
使用免费的模型:minimax-m2.1-free
输入:
你给我用python画一个直方图。数据如下:男:2025年 2.3 2026年:5.2‘ 2027年:34。 女:2025年:3,2026年:5,2027年:7.
直接在我的文件夹下面生成代码和图片
输出:
输入:
三、skills 相关使用
1. 如何让opencode 拥有skills 能力
直接在opencode的对话框输入下面的内容:
1. 安装 oh-my-opencode 插件
2. 安装skill-creator, 辅助创建skill
安装这里的skills https://github.com/anthropics/skills/tree/main/skills/skill-creator
2. 例子
2.1 画布:直接安装别人写好的skill
安装这个skill,项目地址为https://github.com/anthropics/skills/tree/main/skills/canvas-design
输入:
输出:
2.2 爬虫:把一个开源github库封装成skill
我不知道该怎么做,我就直接问opencode
输入:
如果我想把一个github项目封装成skill 该怎么操作
输出:
Thinking: The user wants to know how to package a GitHub project as a skill. This is a general knowledge question, I can answer directly without needing to search for information. I should explain the skill creation process based on the skill-creator skill documentation that was installed earlier.使用 skill-creator skill 来创建 skill,流程如下:1. 进入 OpenCodeopencode2. 描述你的需求告诉 OpenCode 你想封装的项目,例如:- "我想把 https://github.com/some/project 封装成一个 skill,用于处理 JSON 数据"- "帮我把 curlconverter 项目制作成 skill"3. skill-creator 会引导你完成:- 分析项目的功能和使用场景- 规划可复用资源(scripts、references、assets)- 创建 SKILL.md(包含名称、描述、使用说明)- 打包成 .skill 文件4. 手动创建流程(可选):克隆项目到临时目录git clone https://github.com/user/project.git /tmp/my-skill# 创建 skill 结构mkdir -p ~/.config/opencode/skills/my-skillcp -r /tmp/my-skill ~/.config/opencode/skills/# 编辑 SKILL.md 添加 frontmatter# ---# name: my-skill# description: 描述技能用途和触发场景# ---# 添加使用说明到 SKILL.md5. 启动 OpenCode 测试opencode直接运行 opencode 然后描述需求即可,skill-creator 会自动引导你完成整个过程。▣ Build · minimax-m2.1-free · 14.8s
2. 我按照操作进行封装
我想把https://github.com/scrapy 封装成一个skill ,用于爬取网上的数据
它自动安装包、自动写skill所需的文件 ,创建好skill之后,告诉我
xxxx-创建细节功能覆盖:- 基本爬虫创建和运行- CSS/XPath 选择器- 分页处理- Item Pipelines(数据验证、清洗、存储)- JSON API 抓取- 表单提交和登录- 日志和错误处理- 代理配置- JavaScript 页面(Splash)- MongoDB/MySQL 存储使用方式: 运行 opencode,然后说 "帮我写一个爬虫抓取某网站的产品列表",skill 会自动激活并提供 Scrapy 相关指导。
真实使用
输入:
帮我自动爬取下面这个网站的信息:https://quotes.toscrape.com/page/1/
输出:完全正确的代码,并且把数据也爬下来了。
quotes_spider.py
quotes.json