---

🎯 Что это?

Claw Codex — это полная переработка на Python Claude Code, основанная на реальном исходном коде TypeScript.

⚠️ Важно: Это НЕ просто исходный код

В отличие от утечки исходного кода TypeScript, Claw Codex — это полностью функциональный инструмент CLI:

• ✅ Работающий CLI — Не просто код, а полностью функциональный инструмент командной строки, который вы можете использовать сегодня
• ✅ Основан на реальном коде — Портирован с фактической реализации Claude Code на TypeScript
• ✅ Максимальная точность — Сохраняет оригинальную архитектуру при оптимизации
• ✅ Родной Python — Чистый, идиоматичный Python с полными аннотациями типов
• ✅ Удобство использования — Простая настройка, интерактивный REPL, полная документация
• ✅ Постоянное улучшение — Улучшенная обработка ошибок, тестирование, документация

🚀 Попробуйте сейчас! Форкните, изменяйте, сделайте своим! Pull requests приветствуются!

---

🌿 Сжатие токенов /eco — -80% на выводе Bash, измерено

Включите /eco, и ClawCodex сжимает отправляемое модели представление каждого результата Bash детерминированными фильтрами, портированными из RTK: сводки тестов с фокусом на падениях, срезание церемониального шума (git/pip/npm), дедупликация логов и восстановимое усечение — полный сырой вывод остаётся на диске за исполняемой подсказкой. Гарантия никогда не хуже: сжатие, не превосходящее сырой вывод, отбрасывается, а строки ошибок всегда сохраняются.

Измерено (токены tiktoken cl100k_base) на 27 реальных операциях, проигранных через производственный конвейер:

Операция	Сырой	/eco	Экономия
pytest (с падениями)	1,347	390	-71%
git clone --progress	6,868	18	-99%
ls -R src	9,088	225	-97%
log show --last 90s (34k строк)	10,512	1,977	-81%
Весь корпус (27 операций)	92,989	17,767	-80%

Полные таблицы и методология: eval/eco/.

⭐ Star History

✨ Возможности

Поддержка нескольких провайдеров

providers = [
    # Нативные / специфичные протоколы
    "anthropic", "minimax", "deepseek", "zai", "openrouter", "openai", "gemini",
    # OpenAI-совместимые провайдеры
    "nvidia-nim", "atlascloud", "wanjie-ark", "volcengine", "xiaomi-mimo",
    "novita", "fireworks", "siliconflow", "siliconflow-cn", "arcee", "moonshot",
    "huggingface", "together", "stepfun", "deepinfra",
    # Локальные серверы (ключ API не требуется)
    "ollama", "vllm", "sglang",
]  # 25 провайдеров; псевдонимы вроде nim, kimi, hf разрешаются автоматически

Интерактивный REPL

>>> Привет!
Assistant: Привет! Я Claw Codex, повторная реализация на Python...

>>> /help         # Показать команды
>>> /             # Показать команды и skills
>>> /save         # Сохранить сессию
>>> /multiline    # Многострочный режим
>>> Tab           # Автозаполнение
>>> /explain-code qsort.py   # Запустить skill

Skills (Slash Commands)

See README.md for a quick tutorial on creating skills under .clawcodex/skills/<skill-name>/SKILL.md.

Полный CLI

clawcodex --dangerously-skip-permissions              # Запустить REPL
clawcodex login        # Настроить API
clawcodex --version    # Проверить версию
clawcodex config       # Просмотреть настройки

---

📊 Статус

Компонент	Статус	Количество
Команды	✅ Завершено	150+
Инструменты	✅ Завершено	100+
Покрытие тестами	✅ 90%+	75+ тестов
Документация	✅ Завершено	10+ документов

---

🚀 Быстрый старт

Установка

# Установка из PyPI (рекомендуется). Пакет называется clawcodex-cli,
# а установленная команда по-прежнему называется `clawcodex`.
pipx install clawcodex-cli
# Или: uv tool install clawcodex-cli
# Или в активированном виртуальном окружении: pip install clawcodex-cli

clawcodex --help

Для разработки из исходного кода:

git clone https://github.com/agentforce314/clawcodex.git
cd clawcodex

# Создать venv (рекомендуется uv)
uv venv --python 3.11
source .venv/bin/activate

# Установить пакет и инструменты разработки
uv pip install -e ".[dev]"

Файл конфигурации сохраняется в ~/.clawcodex/config.json. Минимальный пример:

{
  "default_provider": "deepseek",
  "providers": {
    "deepseek": {
      "api_key": "xxx-xxx",
      "base_url": "https://api.deepseek.com",
      "default_model": "deepseek-v4-pro"
    }
  },
  "env": {
    "TAVILY_API_KEY": "tvly-YOUR-TAVILY-API-KEY"
  }
}

Примечание: TAVILY_API_KEY требуется для инструмента WebSearch — получите ключ на tavily.com.

Блоки session, settings и env необязательны — при их отсутствии применяются разумные значения по умолчанию (полная структура ниже).

Настройка

Вариант 1: Интерактивный (Рекомендуется)

python -m src.cli login

Этот процесс:

1. попросит вас выбрать провайдера: anthropic / openai / gemini / zai / minimax / openrouter / deepseek, либо любой OpenAI-совместимый провайдер (together, novita, fireworks, moonshot, nvidia-nim, siliconflow, deepinfra, huggingface, …) и локальные серверы (ollama / vllm / sglang)
2. попросит ввести API ключ этого провайдера
3. при необходимости сохранит пользовательский base URL
4. при необходимости сохранит модель по умолчанию
5. установит выбранный провайдер как провайдера по умолчанию

Файл конфигурации сохраняется в ~/.clawcodex/config.json. Пример структуры:

{
  "default_provider": "deepseek",
  "providers": {
    "anthropic": {
      "api_key": "your-api-key",
      "base_url": "https://api.anthropic.com",
      "default_model": "claude-sonnet-4-6"
    },
    "openai": {
      "api_key": "your-api-key",
      "base_url": "https://api.openai.com/v1",
      "default_model": "gpt-5.4"
    },
    "zai": {
      "api_key": "your-api-key",
      "base_url": "https://api.z.ai/api/coding/paas/v4",
      "default_model": "glm-5.2"
    },
    "minimax": {
      "api_key": "your-api-key",
      "base_url": "https://api.minimaxi.com/anthropic",
      "default_model": "MiniMax-M2.7"
    },
    "openrouter": {
      "api_key": "your-api-key",
      "base_url": "https://openrouter.ai/api/v1",
      "default_model": "deepseek/deepseek-v4-pro"
    },
    "deepseek": {
      "api_key": "your-api-key",
      "base_url": "https://api.deepseek.com",
      "default_model": "deepseek-v4-pro"
    }
  },
  "session": {
    "auto_save": true,
    "max_history": 100
  },
  "settings": {
    "advisor_enabled": false,
    "advisor_model": "claude-sonnet-4-6",
    "advisor_client_mode": false,
    "advisor_provider": "openai"
  },
  "env": {
    "TAVILY_API_KEY": "tvly-YOUR-TAVILY-API-KEY"
  }
}

Запуск

python -m src.cli          # Запустить REPL
python -m src.cli --help   # Показать справку

Вот и всё! Начните общаться с ИИ за 3 шага.

---

💡 Использование

Команды REPL

Команда	Описание
/help	Показать все команды
/save	Сохранить сессию
/load <id>	Загрузить сессию
/multiline	Переключить многострочный режим
/clear	Очистить историю
/exit	Выйти из REPL

Пример сессии

---

🎓 Почему Claw Codex?

Основан на реальном исходном коде

• Не клон — Портирован с реальной реализации на TypeScript
• Архитектурная точность — Сохраняет проверенные шаблоны проектирования
• Улучшения — Лучшая обработка ошибок, больше тестов, чище код

Родной Python

• Аннотации типов — Полные аннотации типов
• Современный Python — Использует возможности 3.10+
• Идиоматичный — Чистый Python код

Нацелен на пользователя

• 3-шаговая настройка — Клонировать, настроить, запустить
• Интерактивная настройка — clawcodex login направляет вас
• Богатый REPL — Автозаполнение табуляцией, подсветка синтаксиса
• Сохранение сессий — Никогда не теряйте свою работу

---

📦 Структура проекта

Claw-Codex/
├── src/
│   ├── cli.py           # Точка входа CLI
│   ├── config.py        # Конфигурация
│   ├── repl/            # Интерактивный REPL
│   ├── providers/       # LLM провайдеры
│   └── agent/           # Управление сессиями
├── tests/               # 75+ тестов
└── docs/                # Полная документация

---

🗺️ Дорожная карта

• Python MVP
• Поддержка нескольких провайдеров
• Сохранение сессий
• Аудит безопасности
• Система вызова инструментов
• Пакет PyPI
• Версия на Go

---

🤝 Участие

Мы приветствуем участие!

# Быстрая настройка для разработки
pip install -e .[dev]
python -m pytest tests/ -v

См. CONTRIBUTING.md для руководства.

---

📖 Документация

• SETUP_GUIDE.md — Подробная установка
• CONTRIBUTING.md — Руководство по разработке
• TESTING.md — Руководство по тестированию
• CHANGELOG.md — История версий

---

⚡ Производительность

• Запуск: < 1 секунды
• Память: < 50MB
• Ответ: Потоковая передача (реальное время)

---

🔒 Безопасность

✅ Проверка безопасности пройдена

• Нет конфиденциальных данных в Git
• API ключи зашифрованы в конфигурации
• Файлы .env игнорируются
• Безопасно для продакшена

---

📄 Лицензия

MIT Лицензия — См. LICENSE

---

🙏 Благодарности

• Основано на исходном коде Claude Code TypeScript
• Независимый образовательный проект
• Не связан с Anthropic

---