⚡
OpenCodeDocs

Cài đặt OpenCode

Yêu cầu

Cài đặt

Cách nhanh nhất

curl -fsSL https://opencode.ai/install | bash

Sử dụng npm/bun/pnpm

npm install -g opencode-ai
# hoặc
bun install -g opencode-ai
# hoặc
pnpm install -g opencode-ai

Sử dụng Homebrew (macOS/Linux)

brew install anomalyco/tap/opencode

Windows

# Chocolatey
choco install opencode

# Scoop
scoop install opencode

# npm
npm install -g opencode-ai

Download binary

Tải trực tiếp từ GitHub Releases.

Cấu hình Provider

OpenCode Zen (Khuyến nghị cho người mới)

OpenCode Zen là danh sách models đã được test và verify bởi team OpenCode.

  1. Chạy /connect trong TUI, chọn opencode
  2. Truy cập opencode.ai/auth
  3. Đăng nhập, thêm billing, copy API key
  4. Paste API key vào terminal

Anthropic Claude

/connect

Chọn Anthropic → Chọn Claude Pro/Max hoặc nhập API key.

OpenAI GPT

/connect

Chọn OpenAI → Chọn ChatGPT Plus/Pro hoặc nhập API key.

Google Gemini

Đặt environment variables:

export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json
export GOOGLE_CLOUD_PROJECT=your-project-id

Ollama (Local)

Thêm vào opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama (local)",
      "options": {
        "baseURL": "http://localhost:11434/v1"
      },
      "models": {
        "llama2": {
          "name": "Llama 2"
        }
      }
    }
  }
}

Khởi động

cd /path/to/project
opencode

Khởi tạo project

Lần đầu chạy trong project, chạy:

/init

OpenCode sẽ phân tích project và tạo file AGENTS.md chứa thông tin về codebase.

Kiểm tra models

/models

Chọn model phù hợp với task của bạn.

Cấu trúc thư mục

~/.config/opencode/          # Config global
└── opencode.json            # Config file

~/.local/share/opencode/     # Data
├── auth.json                # API keys
└── sessions/                # Conversation history

./opencode.json              # Config per-project (optional)
./AGENTS.md                  # Project context

Troubleshooting

Kiểm tra auth

opencode auth list

Không thấy models

  1. Kiểm tra API key đã được thêm chưa: /connect
  2. Kiểm tra provider config trong opencode.json

Terminal hiển thị lỗi

Đảm bảo dùng terminal emulator hỗ trợ TUI:

  • WezTerm, Alacritty, Ghostty, Kitty
  • Tránh dùng terminal mặc định của Windows

Links