opencode配置使用教程

大家好！如果你是编程新手，对AI辅助开发工具感兴趣，但又不知道从哪里入手，这个教程就是为你准备的。我们会一步一步走，从零开始安装、配置，到实际开发使用。整个过程像聊天一样简单，不需要高深的编程知识。

首先，简单介绍一下：

OpenCode：这是一个开源的AI编程助手，像Claude Code的免费替代品。它可以帮你分析代码、生成功能、修改项目，支持多种AI模型（如Claude、ChatGPT、Gemini）。它运行在终端里，超级方便。

第一步：准备前提条件
在开始前，确保你的电脑满足这些：

一个现代终端（命令行窗口）。推荐：
macOS/Linux：用Terminal或安装Alacritty。
Windows：用Windows Terminal（系统自带）或WezTerm。
网络连接（安装时需要下载）。
可选：ChatGPT Plus、Claude Pro或Gemini订阅（免费模型也能用，但付费的更强）。如果你有这些账号，准备好API密钥。
Node.js或Bun（Oh My OpenCode需要）。如果没有，安装脚本会帮你处理。
如果你是纯小白，先打开你的终端（命令行）：

Windows：搜索“cmd”或“PowerShell”。
macOS：搜索“Terminal”。
Linux：Ctrl+Alt+T。

第二步：安装OpenCode
OpenCode安装超级简单，一行命令搞定。

打开终端，运行这个安装脚本：

如果你是Windows，用PowerShell运行：

其他方式（如果curl不行）：
用npm（需先安装Node.js）

macOS用Homebrew：

验证安装：运行

如果显示版本号（如1.0.150或更高），就成功了！如果报错，检查网络或重启终端。

第三步：配置OpenCode
配置主要是设置AI模型的API密钥，让OpenCode能调用AI。
1.运行OpenCode：

这会打开一个终端界面（TUI，像聊天窗口）。
2.在界面里输入命令/connect，选择提供商（如opencode、anthropic、openai、google）。

推荐新手用opencode（官方免费试用）：访问opencode.ai/auth，登录，复制API密钥，粘贴到终端。
如果用Claude：选anthropic，输入你的API密钥（从Claude官网获取）。
ChatGPT：选openai，输入OpenAI API密钥。
Gemini：选google，类似。
配置好后，退出（Ctrl+C），重启opencode测试。如果看到欢迎界面，就OK了。

获取自己的网站

参考配置文件：令牌分组（Token Group）使用教程

3.高级配置（可选，新手可跳过）：编辑配置文件~/.config/opencode/opencode.json（Windows是%APPDATA%\opencode\opencode.json）。比如添加主题或键位。

如果没有opencode.json文件，需要自己创建一个

复制下面的代码，替换里面的apiKey

如果模型能正常回复：

🎉 恭喜你，已经全部配置成功！