:::warning Content Under Development

This page is still being written. Some sections may be incomplete or subject to change.

:::

OpenCode + NocoBase: Open Source, Free, Vendor-Unlocked NocoBase Building

OpenCode is an open-source terminal AI Agent — supporting 75+ models (Claude, GPT, Gemini, DeepSeek, etc.), not locked to any vendor, letting you freely choose the best model for your needs. After connecting it to NocoBase, you can use natural language to create data tables, build pages, configure workflows, while maintaining full control over model selection and costs.

What Is OpenCode

OpenCode is developed by Anomaly Innovations (GitHub 140k+ Stars), positioned as "a vendor-unlocked terminal AI Agent." Written in Go, it provides a beautiful TUI interface. Core features:

• 75+ model support — Claude, GPT, Gemini, DeepSeek, local models, and more — freely switch between them
• Zero vendor lock-in — Bring your own API Key, pay by actual usage, no extra subscriptions needed
• Multi-Agent architecture — Built-in Build, Plan, Review, Debug, and Docs Agent roles
• Privacy-first — Doesn't store code or context, all data stays local

OpenCode also supports integration with VS Code, JetBrains, Zed, Neovim, and other editors, as well as a standalone desktop application.

Why Choose OpenCode

If you're deciding which AI Agent to use for operating NocoBase, here are the scenarios where OpenCode fits best:

• Don't want to be locked to a single model — Use Claude today, switch to GPT tomorrow, try DeepSeek the day after — one tool handles it all
• Care about cost control — Bring your own API Key and pay per usage; supports using existing ChatGPT Plus subscriptions
• Have privacy requirements — Code and context don't go through third parties; supports local models
• Like high customizability — YAML configuration for custom Agent behavior, meeting team-specific needs

How It Connects

OpenCode works with NocoBase in the following way:

You (Terminal / VS Code / JetBrains / ...)
  |
  └─→ OpenCode
        |
        ├── NocoBase Skills (enables Agent to understand NocoBase configuration system)
        |
        └── NocoBase CLI (executes create, modify, deploy, and other operations)
              |
              └─→ NocoBase Service (your business system)

• NocoBase Skills — Domain knowledge packages that tell OpenCode how to operate NocoBase
• NocoBase CLI — Command-line tool that actually executes data modeling, page building, and other operations
• NocoBase Service — Your running NocoBase instance

Prerequisites

Before starting, make sure you have the following environment ready:

• OpenCode installed (installation guide)
• Node.js >= 22 (for running NocoBase CLI and Skills)
• If you already have a NocoBase instance, AI capabilities are evolving rapidly. The minimum required version is NocoBase 2.1.0, and we recommend updating to the latest version.

Quick Start

One-Click AI Installation

Copy the prompt below to OpenCode, and it will automatically complete NocoBase CLI installation, initialization, and environment configuration:

Help me install NocoBase CLI and complete initialization: https://docs.nocobase.com/ai/ai-quick-start.md (please read the linked content directly)

Manual Installation

npm install -g @nocobase/cli
nb init --ui

The browser will automatically open a visual configuration page, guiding you to install NocoBase Skills, configure the database, and start the application. For detailed steps, see Quick Start.

After installation is complete, run nb env list to confirm the environment status:

nb env list

Confirm the output shows the configured environment and its running status.

FAQ

Related Links

• NocoBase CLI — Command-line tool for installing and managing NocoBase
• NocoBase Skills — Domain knowledge packages installable into AI Agents
• AI Building Quick Start — Build NocoBase applications from scratch with AI
• OpenCode Official Documentation — OpenCode complete user guide
• Claude Code + NocoBase — Anthropic's official AI coding assistant
• Codex + NocoBase — OpenAI's official AI coding assistant