OpenCode 中文社区

Appearance

K. OpenCode Zen ​

💡 一句话总结：OpenCode 官方提供的免费验证模型服务

什么是 Zen？ ​

OpenCode Zen 是 OpenCode 官方提供的 AI 模型验证服务，旨在帮助用户：

  • 测试 OpenCode 功能
  • 验证配置是否正确
  • 体验基础对话能力

快速开始 ​

获取 Zen API Key ​

  1. 访问 opencode.ai/auth
  2. 注册/登录账号
  3. 在控制台生成 API Key
  4. 复制 API Key 到剪贴板

配置 OpenCode ​

bash
# 在 OpenCode 中设置
/connect

# 或使用环境变量
export OPENCODE_ZEN_API_KEY=your-api-key

Zen 模型列表 ​

可用模型 ​

模型 ID说明适用场景
zen-core基础对话模型日常对话、简单问答
zen-code代码专用模型代码生成、调试
zen-reasoner推理增强模型复杂逻辑分析

模型特点 ​

模型上下文长度速度能力
zen-core32K快基础对话
zen-code64K中编程任务
zen-reasoner128K慢深度推理

使用限制 ​

配额说明 ​

套餐每日请求数每月请求数
免费版501000
基础版50010000
专业版无限制无限制

速率限制 ​

套餐每分钟请求数每秒请求数
免费版101
基础版605
专业版30030

常见问题 ​

Q: Zen 和其他模型有什么区别？ ​

A: Zen 是 OpenCode 官方验证模型：

  • 免费使用（有一定配额）
  • 专为基础功能测试设计
  • 不适合生产环境

建议：测试完成后，切换到 DeepSeek、Claude 等完整模型。

Q: Zen 配额用完了怎么办？ ​

A: 有以下选择：

  1. 升级套餐：在 opencode.ai 控制台升级
  2. 切换模型：使用其他模型提供商
  3. 等待重置：每日配额会在 UTC 0:00 重置

Q: Zen 模型能力如何？ ​

A: Zen 适合：

✅ 适合：

  • 功能测试
  • 配置验证
  • 简单对话
  • 基础编程

❌ 不适合：

  • 复杂项目开发
  • 大规模代码生成
  • 生产环境部署

Q: 如何查看 Zen 使用量？ ​

bash
# 查看配额使用情况
opencode zen status

# 或在控制台查看
# 访问 https://opencode.ai/dashboard

配置示例 ​

最小配置 ​

json
{
  "model": "zen-core",
  "provider": {
    "opencode-zen": {
      "options": {
        "apiKey": "{env:OPENCODE_ZEN_API_KEY}"
      }
    }
  }
}

完整配置 ​

json
{
  "model": "zen-code",
  "provider": {
    "opencode-zen": {
      "options": {
        "apiKey": "{env:OPENCODE_ZEN_API_KEY}",
        "temperature": 0.7,
        "maxTokens": 4096
      }
    }
  },
  "settings": {
    "autoCompact": true,
    "contextLimit": 30000
  }
}

最佳实践 ​

开发测试流程 ​

1. 使用 Zen 快速测试功能
   ↓
2. 验证配置正确性
   ↓
3. 切换到生产模型（如 Claude）
   ↓
4. 开始实际开发

Zen 适合的场景 ​

场景推荐模型
第一次使用 OpenCodeZen（快速验证）
学习新功能Zen（无成本试错）
简单脚本编写Zen
大型项目开发Claude / DeepSeek
复杂推理任务Claude Opus

故障排除 ​

Q: 提示 "Invalid API Key" ​

A: 检查以下步骤：

  1. API Key 是否正确复制

    • 确保没有多余空格
    • 检查大小写

  2. 环境变量是否设置

    bash
    echo $OPENCODE_ZEN_API_KEY

  3. API Key 是否激活

    • 访问控制台确认状态

Q: 提示 "Quota Exceeded" ​

A:

  1. 检查使用量：opencode zen status
  2. 等待重置或升级套餐
  3. 或切换到其他模型

Q: 响应速度慢 ​

A: Zen 不是高性能模型，响应较慢是正常的。

建议：

  • 测试时使用 zen-core
  • 生产环境使用其他模型

升级到完整模型 ​

推荐模型对比 ​

场景推荐模型说明
国内首选DeepSeek性价比高，国内直连
最强推理Claude Opus 4业界最强
编程首选Claude Sonnet 4代码能力优秀
综合体验Claude平衡之选

切换模型 ​

bash
# 使用 /connect 命令重新配置
/connect

# 或修改配置文件
opencode.json

相关资源 ​

反馈与支持 ​

报告问题 ​

遇到 Zen 相关问题：

  1. 检查 常见问题 是否已有解答
  2. 在 GitHub Discussions 中搜索
  3. 新建 Issue 报告问题

建议反馈 ​

对 Zen 服务有建议？

  • 在 GitHub Discussions 中提出
  • 发送邮件给团队：support@opencode.ai
微信群