Skip to content

README.ru.md

Latest commit

 

History

History
281 lines (214 loc) · 13.1 KB

README.ru.md

File metadata and controls

281 lines (214 loc) · 13.1 KB
Raw

Codg

Последний релиз Статус сборки GoDoc Присоединяйтесь к чату Discord на https://discord.gg/Dy5QZRbaND

Следующее поколение простой AI-системы-харнесса агентов для кода и работы: автоматическая и асинхронная, с высокой конкурентностью и производительностью, эффективная и точная.

English | 繁體中文 | 简体中文 | 日本語 | 한국어 | Français | Deutsch | Español | Português | Русский | العربية

Демо Codg Демо Codg

Установка

Mac и Linux:

# Homebrew
brew install vcaesar/tap/codg

# NPM
# npm install -g @vcaesar/codg

Windows (PowerShell):

# Winget
# winget install vcaesar.codg

# YOLO (нативный установщик для PowerShell)
irm https://raw.githubusercontent.com/vcaesar/codg/main/demo/boot.ps1 | iex

Все (macOS, Linux или Windows через Git Bash / MSYS2 / Cygwin / WSL):

# YOLO
curl -fsSL https://raw.githubusercontent.com/vcaesar/codg/main/demo/boot.sh | bash

Или перейдите напрямую на страницу Releases, чтобы скачать и запустить.

Перейдите в каталог проекта, выполните codg и используйте «/init» для инициализации проекта. «/yolo» переключает автоматический режим и режим подтверждения; разрешения настраиваются в codg.toml.

Возможности

  • Автоматическая и асинхронная, высоко конкурентная и высокопроизводительная система агентов с низким потреблением памяти
  • Поддержка многочисленных провайдеров моделей (40+ провайдеров API и Pro, Custom URL API) и локальных моделей через openai-compat или claude-compat; поддержка бесплатных моделей Openrouter, Ollama, Nvidia и других; используйте их через «/connect», «/models» или «codg auth»
  • Асинхронные правила и правила моделей для мультиагентов
  • Сжатие ввода/вывода, контекста и промптов для экономии токенов; кэш и правила для снижения затрат
  • Поддержка любого терминала и ОС, в том числе веб-терминалов
  • Удобство: TUI доступен повсюду и близок к GUI; Desktop- и Web-версии находятся в стадии BETA
  • Клик или «/xxx» для переключения сессий; всё в TUI кликабельно
  • Клик по «Modified Files» или «/diff» и «/diff git» — просмотр diff-файлов в TUI как в VSCode
  • Автодополнение английских букв и коротких фраз
  • Более удобная система Agents, Skills и MCP, поддержка пользовательских Agents и Skills
  • Поддержка каналов и функций как в OpenClaw
  • Полная поддержка веб-интерфейса, удалённого TUI и настольного приложения
  • Поддержка плагинов Claude Code/Codex

Desktop-приложение (BETA); некоторые функции ожидают тестирования и исправления ошибок, затем релиза.

Провайдеры

Atom, Copilot, Anthropic, Anthropic API, OpenAI, OpenAI API, Gemini, Gemini API, OpenRouter, Antigravity, Cursor, Kiro, xAI, Azure, Bedrock, Vertex AI, Nvidia, HuggingFace, Vercel, Ollama Cloud, Cloudflare Workers, GitHub, Poe, Meta, Groq, IO.net, OpenCode Zen, OpenCode Go, Windsurf, Cerebras.

Китай: Z.ai, Zhipu, Zhipu Coding, Kimi, Kimi Coding, DeepSeek, MiniMax, MiniMax China, Qwen, MiMo, Qiniu Cloud, Ali Coding, Ali Coding CN, Tencent Coding.

Бенчмарк

Использование ОЗУ

Инструмент 1 активная сессия 10 активных сессий Доп. PSS на каждую добавленную сессию
Codg 65 МБ 165 МБ ~10 МБ
Codex CLI 140.0 МБ 334.8 МБ ~21.6 МБ
Cursor Agent 214.9 МБ 1632.4 МБ ~157.5 МБ
GitHub Copilot CLI 333.3 МБ 1756.5 МБ ~158.1 МБ
OpenCode 371.5 МБ 3237.2 МБ ~318.4 МБ
Claude Code 386.6 МБ 2300.6 МБ ~212.7 МБ

Сообщение об ошибках:

Откройте Github Issues

Как мы используем ваши данные:

В данный момент никакие данные и телеметрия не собираются, поддерживаются 100% локальные модели; при использовании API смотрите политику соответствующего провайдера.

По использованию TUI см. документацию команд TUI и введите /help в TUI, чтобы посмотреть горячие клавиши и другую справку.

CLI-команды

Использование: codg -h

codg auth/login               # Аутентификация (Atom, OpenAI, GitHub...)
codg web                      # Запустить web-UI на порту 4096
codg desktop                  # Запустить desktop-приложение (Wails)
codg claw                     # Запустить мессенджер-агента (Telegram/Discord/Slack)
codg gateway --private-only   # Запустить защищённый шлюз
codg models claude            # Список моделей, соответствующих «claude»
codg runm start Qwen/Qwen3-8B-GGUF   # Запустить локальную модель
codg runm download user/model # Скачать модель GGUF
codg plugin install repo/name # Установить плагин
codg plugin list              # Список установленных плагинов
codg install repo/name        # Сокращённо для plugin install
codg mcp add myserver cmd     # Добавить MCP-сервер
codg mcp list                 # Список настроенных MCP-серверов
codg skill url add <url>      # Добавить URL источника навыков
codg themes set catppuccin    # Переключить тему
# codg logs -f                # Отслеживать логи приложения
codg toml                     # Показать всю конфигурацию
codg stats/s                  # Показать статистику использования
codg dirs                     # Вывести пути каталогов данных/конфига
codg projects                 # Список отслеживаемых каталогов проектов
codg lite 2                   # Установить уровень lite-режима (0-4)
codg merge origin main        # Безопасный git merge с бэкапом v1/
codg migrate                  # Миграция конфига из .claude/.opencode
codg vm build                 # Сборка на удалённой VM
codg vm run -- make test      # Выполнить команду на VM
codg sandbox run -- ./test.sh # Запуск в песочнице
codg sandbox status           # Проверить доступность песочницы
codg used                          # Показать лимиты использования и статистику API для всех провайдеров
codg update                   # Обновить версию codg
codg updatep                  # Обновить определения провайдеров

Плагин Claude-Code/Codex

# Codg
codg plugin marketplace add earthtojake/text-to-cad
codg plugin add cad@text-to-cad

Примеры использования

Неинтерактивный режим (codg run)

# Передать ввод от другой команды по конвейеру.
cat errors.log | codg run "Что вызывает эти ошибки?"
# Подробный режим (отладочный вывод в stderr).
codg run -v "Отладить эту функцию"

Web UI

# Запустить web-UI на порту по умолчанию 4096.
codg web
# Пользовательский порт.
codg web -p 8080

# Режим только API (без фронтенда и браузера).
codg web 0, codg api

Управление плагинами

# Установить плагин из Git-репозитория.
codg install github.com/user/codg-xxx-auth

Пользовательские агенты и навыки:

Скопируйте xx_agent.md (.codg/agents/templates) или SKILL.md (.codg/skills) в соответствующий каталог

Система конфигурации

Создайте codg.toml в корне проекта (или ~/.codg/config/codg.toml для глобальных настроек):

# codg.toml — Минимальная конфигурация проекта.
[options]
lite_mode = 2          # 0 = все агенты, 2 = стандартный облегчённый набор, 4 = единственный агент
locale    = "en"       # Язык UI: en, zh-CN, ja
ctx_resize = true
token_save = 2

[options.tui]
theme     = "catppuccin"
dark_mode = true
compact_mode = false

[tools.grep]
backends = ["rg", "sg", "csearch", "ngram", "regex"]

Настройка провайдера

# Использовать API-ключ (поддерживает развёртывание $ENV_VAR).
[providers.anthropic]
api_key = "$ANTHROPIC_API_KEY"

# Использовать OAuth (настраивается через `codg auth`).
[providers.openai]
oauth = true

# Пользовательский / самостоятельно размещаемый провайдер.
[providers.local]
name     = "My Local LLM"
type     = "openai-compat"
base_url = "http://localhost:8080/v1"
api_key  = "not-needed"

Настройка агентов

# Краткая форма: назначить тип модели.
agents.coder = "large"
agents.task  = "small"

# Полная форма: тонкая настройка агента.
[agents.advisor]
model           = "large"
temperature     = 0.3
thinking_budget = 32000

MCP-серверы

# HTTP MCP-сервер.
[mcp.websearch]
type = "http"
url  = "https://mcp.exa.ai/mcp?tools=web_search_exa"

Навыки

# Автозагрузка и скачивание в TUI или через codg skill
[option]
skill_urls = ["https://github.com/user/skills"]

Локальные модели (llama.cpp)

[llama]
port     = 8090
host     = "127.0.0.1"
ctx_size = 32000
gpu      = "auto"          # auto, cuda, off

Каналы сообщений

[channels.telegram]
enabled     = true
token       = "$TELEGRAM_BOT_TOKEN"
allowed_ids = ["123456789"]

[channels.discord]
enabled  = true
token    = "$DISCORD_BOT_TOKEN"

Разрешения

[permissions]
allowed_tools = ["bash", "edit", "view", "glob", "grep"]
allowed_dirs = ["**x"] # все каталоги