Skip to content
GuidesAugust 19, 2026

Dùng OpenCode với AnyRouter — CLI launcher hoặc opencode.json

Chỉ coding agent OpenCode vào AnyRouter bằng một lệnh, hoặc thêm nhà cung cấp Chat Completions tùy chỉnh trong opencode.json. Một key sk-ar- tới mọi model catalog, billing và nhật ký request thống nhất.

Đây là gì

OpenCode là coding agent mã nguồn mở cho terminal (và app desktop/IDE). Mặc định nó nói với nhà cung cấp bạn /connect — OpenCode Zen, OpenAI, Anthropic, v.v. Chỉ vào AnyRouter thì mọi phiên chia một key sk-ar-, một hóa đơn, và một nhật ký request với Claude Code, Codex, và phần còn lại của stack.

OpenCode nói OpenAI Chat Completions. AnyRouter phục vụ phương ngữ đó tại https://anyrouter.dev/api/v1, nên đây chỉ là đổi cấu hình: không fork OpenCode, không rebuild.

OpenCode agent không phải OpenCode Zen. Zen là API model bạn gắn như BYOK. Hướng dẫn này là lái OpenCode TUI qua AnyRouter.

Hướng dẫn cài đầy đủ

Đường nhanh nhất: CLI anyr

Cài OpenCode trước (curl -fsSL https://opencode.ai/install | bash, hoặc npm install -g opencode-ai). Rồi một lệnh đăng nhập và mở OpenCode đã chọn AnyRouter:

curl -fsSL https://anyrouter.dev/setup.sh | bash
anyr login
anyr opencode
anyr opencode --model "anthropic/claude-sonnet-4.6"
anyr opencode --model "z-ai/glm-5.2"
anyr opencode --dry-run
Khởi chạy OpenCode qua AnyRouter.
CLI launcher AnyRouter với mục tiêu OpenCode được chọn
Danh sách mục tiêu CLI gồm OpenCode. Lần đầu đăng nhập; lần sau dùng lại ~/.anyrouter/config.yaml.

Launcher không ghi file cấu hình của OpenCode. Nó tiêm một nhà cung cấp AnyRouter chỉ trong phiên (base URL đúng cộng giới hạn context/output catalog) và đặt OPENAI_API_KEY để key nội suy lúc chạy. Thoát OpenCode thì opencode.json toàn cục không đổi. Cùng key đã lưu cũng chạy anyr claude và anyr codex.

Mọi thứ sau -- chuyển nguyên văn cho OpenCode (anyr opencode -- --help).

Cấu hình bền: opencode.json

Khi muốn lệnh opencode trần dùng AnyRouter mọi lúc, đăng ký nó như nhà cung cấp @ai-sdk/openai-compatible tùy chỉnh. Export key trong shell, rồi thêm vào ~/.config/opencode/opencode.json (mọi dự án) hoặc ./opencode.json (repo này):

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anyrouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AnyRouter",
      "options": {
        "baseURL": "https://anyrouter.dev/api/v1",
        "apiKey": "{env:ANYROUTER_API_KEY}"
      },
      "models": {
        "anthropic/claude-sonnet-4.6": {
          "name": "Claude Sonnet 4.6",
          "limit": { "context": 200000, "output": 65536 }
        },
        "z-ai/glm-5.2": {
          "name": "GLM-5.2",
          "limit": { "context": 1000000, "output": 65536 }
        }
      }
    }
  },
  "model": "anyrouter/anthropic/claude-sonnet-4.6"
}
Nhà cung cấp AnyRouter tùy chỉnh. apiKey là tên biến môi trường, không phải bí mật.
  • Tạo key trong dashboard — mọi inference key bắt đầu bằng sk-ar-.
  • export ANYROUTER_API_KEY trước khi chạy. {env:ANYROUTER_API_KEY} là tên biến, đừng dán bí mật vào JSON.
  • Key trong map model phải là id AnyRouter chính xác. Mặc định OpenCode là anyrouter/<id>.
  • Nếu đặt limit, OpenCode 1.18+ đòi cả context và output. Bỏ hẳn limit nếu không biết cửa sổ.
opencode.json với nhà cung cấp AnyRouter tùy chỉnh
Khối nhà cung cấp bền để `opencode` nói với AnyRouter không cần wrapper CLI.

Rồi chạy opencode, mở /models, chọn một id anyrouter/….

OpenCode TUI với model AnyRouter được chọn
TUI gắn nhãn nhà cung cấp AnyRouter. Đổi model bằng /models.

Xác nhận đã billing qua AnyRouter

Gửi bất kỳ prompt nào, rồi mở nhật ký request. Hàng nên hiện model id, token, chi phí và latency trong một hoặc hai giây.

Nhật ký request AnyRouter hiện phiên OpenCode
Có hàng đó thì OpenCode đang route qua AnyRouter — không phải Zen hay key OpenAI sót lại.
  • 401 — process không có key sk-ar- sống. Trong cấu hình bền, echo $ANYROUTER_API_KEY. Với CLI, anyr config get.
  • Model not found — key map phải khớp catalog id Chat Completions, không phải alias Zen hay Anthropic gốc.
  • Nhà cung cấp sai đang trả lời — login /connect cho Zen có thể thắng khi bạn chạy opencode trực tiếp. Chọn anyrouter/… trong /models, hoặc dùng anyr opencode.

Đi tiếp từ đây

Cờ CLI chuẩn ở docs.anyrouter.dev/cli/opencode. Walkthrough kể chuyện ở docs.anyrouter.dev/guides/opencode. Để thêm công cụ AnyRouter (credit, catalog, key) trong cùng chat, dùng công thức MCP tại docs.anyrouter.dev/mcp/opencode.

Cùng key AnyRouter cũng khởi chạy Claude Code và Codex. Một profile, mọi agent.

Khởi chạy OpenCode qua AnyRouter — một key, catalog, nhật ký request.

Mở CLI

Gửi request đầu trong hai phút

Bắt đầu miễn phí với key của bạn, hoặc nạp rồi trả theo token. Go: $4 credit/tháng — $2/tháng, hoặc miễn phí khi góp một provider key.

Bắt đầu miễn phí