Перейти к основному содержанию
OpenCode — это open-source AI‑агент для программирования (Coding Agent), ориентированный на разработчиков и делающий акцент на «терминально‑нативном» опыте: через TUI/CLI прямо в командной строке можно обсуждать требования, генерировать код, выполнять рефакторинг, объяснение и отладку. Он подчеркивает независимость от конкретной модели и может подключаться к сервисам моделей Claude, GPT, Gemini и других провайдеров, а также поддерживает локальные или OpenAI‑совместимые интерфейсы, что позволяет свободно балансировать между стоимостью, качеством и приватностью. OpenCode также предоставляет расширяемый механизм плагинов/инструментов и систему конфигурации, позволяя включать контекст проекта, выполнение команд и другие возможности в автоматизированные процессы. Он подходит активным пользователям терминала и командам, которые хотят настраивать собственные AI‑workflow для программирования.

Установка и подключение

Установка

curl -fsSL https://opencode.ai/install | bash
Другие способы установки см. на официальном сайте OpenCode: https://opencode.ai/docs/#install

Запуск OpenCode

cd /path/to/project  # 进入项目路径

opencode  # 启动 OpenCode

Подключение JieKou API

  • Глобальная конфигурация: ~/.config/opencode/opencode.json
  • Конфигурация проекта: opencode.json в корневом каталоге проекта
(Если opencode.json отсутствует, его можно создать вручную) Конфигурация:
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "myprovider": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "JieKou",
      "options": {
        "baseURL": "https://api.highwayapi.ai/openai/v1"
      },
      "models": {
        "claude-sonnet-4-5-20250929": {
          "name": "claude-sonnet-4-5-20250929"
        },
        "gpt-5.2": {
          "name": "gpt-5.2"
        },
      }
    }
  }
}
При настройке стороннего провайдера важно выбрать правильный npm‑пакет:
npm‑пакетТип APIПодходящие сценарии
@ai-sdk/openai-compatibleChat Completion APIБольшинство моделей, включая GPT, Claude и др.
@ai-sdk/openaiResponse APIМодели серии Codex
Примечание: для моделей Codex (например, gpt-5.1-codex) необходимо использовать @ai-sdk/openai (Response API), для остальных моделей — @ai-sdk/openai-compatible (Chat Completion API).

Настройка KEY

Войдите в opencode, используйте /connect, выберите провайдера, затем введите API KEY и нажмите enter для подтверждения. opencode_input_api_key

Начало работы

После подключения провайдера можно использовать команду /models для выбора модели. opencode_choose_model

Другие способы использования

Пример: локальная конфигурация MCP (на примере вычислительного MCP)

  1. Напишите код mcp server калькулятора с помощью python + MCP SDK и сохраните его в локальный путь.
import asyncio
import math
from mcp.server import Server
from mcp.server.stdio import stdio_server
from mcp.types import Tool, TextContent

# Create server instance
server = Server("calculator")

@server.list_tools()
async def list_tools() -> list[Tool]:
    """List available calculator tools."""
    return [
        Tool(
            name="add",
            description="Add two numbers",
            inputSchema={
                "type": "object",
                "properties": {
                    "a": {"type": "number", "description": "First number"},
                    "b": {"type": "number", "description": "Second number"},
                },
                "required": ["a", "b"],
            },
        ),
        Tool(
            name="subtract",
            description="Subtract second number from first number",
            inputSchema={
                "type": "object",
                "properties": {
                    "a": {"type": "number", "description": "First number"},
                    "b": {"type": "number", "description": "Second number to subtract"},
                },
                "required": ["a", "b"],
            },
        ),
        Tool(
            name="multiply",
            description="Multiply two numbers",
            inputSchema={
                "type": "object",
                "properties": {
                    "a": {"type": "number", "description": "First number"},
                    "b": {"type": "number", "description": "Second number"},
                },
                "required": ["a", "b"],
            },
        ),
        Tool(
            name="divide",
            description="Divide first number by second number",
            inputSchema={
                "type": "object",
                "properties": {
                    "a": {"type": "number", "description": "Dividend"},
                    "b": {"type": "number", "description": "Divisor"},
                },
                "required": ["a", "b"],
            },
        ),
        Tool(
            name="power",
            description="Raise a number to a power",
            inputSchema={
                "type": "object",
                "properties": {
                    "base": {"type": "number", "description": "Base number"},
                    "exponent": {"type": "number", "description": "Exponent"},
                },
                "required": ["base", "exponent"],
            },
        ),
        Tool(
            name="sqrt",
            description="Calculate square root of a number",
            inputSchema={
                "type": "object",
                "properties": {
                    "a": {"type": "number", "description": "Number to calculate square root of"},
                },
                "required": ["a"],
            },
        ),
        Tool(
            name="modulo",
            description="Calculate remainder of division",
            inputSchema={
                "type": "object",
                "properties": {
                    "a": {"type": "number", "description": "Dividend"},
                    "b": {"type": "number", "description": "Divisor"},
                },
                "required": ["a", "b"],
            },
        ),
    ]

@server.call_tool()
async def call_tool(name: str, arguments: dict) -> list[TextContent]:
    """Handle tool calls for calculator operations."""
    try:
        if name == "add":
            result = arguments["a"] + arguments["b"]
        elif name == "subtract":
            result = arguments["a"] - arguments["b"]
        elif name == "multiply":
            result = arguments["a"] * arguments["b"]
        elif name == "divide":
            if arguments["b"] == 0:
                return [TextContent(type="text", text="Error: Division by zero")]
            result = arguments["a"] / arguments["b"]
        elif name == "power":
            result = math.pow(arguments["base"], arguments["exponent"])
        elif name == "sqrt":
            if arguments["a"] < 0:
                return [TextContent(type="text", text="Error: Cannot calculate square root of negative number")]
            result = math.sqrt(arguments["a"])
        elif name == "modulo":
            if arguments["b"] == 0:
                return [TextContent(type="text", text="Error: Modulo by zero")]
            result = arguments["a"] % arguments["b"]
        else:
            return [TextContent(type="text", text=f"Error: Unknown tool '{name}'")]

        return [TextContent(type="text", text=str(result))]

    except Exception as e:
        return [TextContent(type="text", text=f"Error: {str(e)}")]

async def main():
    """Run the calculator MCP server."""
    async with stdio_server() as (read_stream, write_stream):
        await server.run(read_stream, write_stream, server.create_initialization_options())

if __name__ == "__main__":
    asyncio.run(main())

  1. Добавьте локальный mcp в opencode.json
{
  "mcp": {
    "calc_mcp": {
      "type": "local",
      "command": ["python3", "{your_local_path}/calc_mcp.py"],
      "enabled": true
    }
  }
}
  1. Используйте /mcps, чтобы проверить состояние подключения mcp. Когда состояние — Enabled, можно разрешить opencode выполнять вызовы.
opencode_mcp