免费模型指南

使用 OpenCode 与完全免费的 LLM 模型。无需 API 密钥或信用卡。

免费模型选项

Provider	模型	免费额度	要求
Google Gemini	Gemini 2.5 Flash	250 请求/天	Google 账户
Groq	Llama 3.1 8B	免费额度	Groq 账户
Ollama	多种本地模型	无限	推荐 GPU
GitHub Copilot	GPT-4o	免费额度	GitHub 账户

选项 1：Google Gemini（推荐）

Google Gemini 每天提供 250 次免费请求，无需信用卡。

获取你的免费 API 密钥

1. 前往 Google AI Studio
2. 使用 Google 账户登录
3. 点击”获取 API 密钥”
4. 复制你的 API 密钥

配置 OpenCode

# 启动 TUI
opencode tui

# 然后配置你的 provider
/connect

# 选择 Google 并输入你的 API 密钥

或从命令行进行身份验证：

opencode auth login --provider google

推荐模型

# 使用 Gemini 启动 OpenCode
opencode tui --model google/gemini-2.5-flash

选项 2：Ollama（100% 本地、无限）

在与互联网断开的情况下完全本地运行 AI 模型。

安装 Ollama

macOS/Linux：

curl -fsSL https://ollama.com/install.sh | sh

Windows： 从 ollama.com 下载

下载模型

# 下载 Qwen 2.5 Coder（推荐用于编码）
ollama pull qwen2.5-coder

# 或下载 Llama 3.1
ollama pull llama3.1

# 或下载 Code Llama
ollama pull codellama

配置 OpenCode

# 启动 TUI
opencode tui

# 将 Ollama 配置为你的 provider
/connect

# 选择 Ollama（默认在 localhost:11434 运行）

开始编码

opencode tui --model ollama/qwen2.5-coder

选项 3：Groq（免费额度）

Groq 通过其 API 提供对快速模型的免费访问。

获取你的 API 密钥

1. 前往 console.groq.com
2. 注册免费账户
3. 创建 API 密钥
4. 复制你的 API 密钥

配置 OpenCode

# 启动 TUI
opencode tui

# 配置 Groq
/connect

# 选择 Groq 并输入你的 API 密钥

开始编码

opencode tui --model groq/llama-3.1-8b-instant

选项 4：GitHub Copilot

如果你有 GitHub 账户，你可以将 GitHub Copilot 与 OpenCode 一起使用。

配置 OpenCode

# 启动 TUI
opencode tui

# 配置 GitHub Copilot
/connect

# 选择 GitHub 并通过浏览器进行身份验证

免费选项比较

功能	Google Gemini	Ollama	Groq	GitHub Copilot
免费额度	250 请求/天	无限	有限	免费额度
隐私	云端	本地	云端	云端
速度	快	取决于硬件	非常快	快
模型质量	优秀	良好	良好	优秀
离线	❌	✅	❌	❌

使用免费模型的技巧

1. 从 Gemini 开始：它最容易设置，有最慷慨的免费额度
2. 使用 Ollama 保护隐私：让你的代码完全保持本地
3. 切换模型：为不同任务使用不同模型
4. 监控使用：检查 opencode stats 查看你的 API 使用情况

故障排除

速率限制

如果你遇到速率限制：

• 等待限制重置
• 切换到不同的免费 provider
• 使用 Ollama 获得无限本地使用

性能慢

如果模型很慢：

• 尝试不同的模型（Gemini Flash 比 Pro 更快）
• 使用 Groq 获得最快的响应时间
• 对于 Ollama，确保你有好的 GPU

身份验证问题

如果身份验证失败：

• 检查你的 API 密钥是否正确
• 验证你的账户是否活跃
• 尝试使用 /connect 重新进行身份验证

下一步

• 快速入门指南 - 开始使用 OpenCode
• 模型文档 - 探索所有可用模型
• 配置 - 自定义你的设置