@freeclaude/cli 3.0.0 → 3.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +586 -126
- package/dist/cli.bundle.mjs +5459 -3002
- package/dist/cli.bundle.mjs.map +24 -16
- package/dist/cli.mjs +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,16 +1,17 @@
|
|
|
1
1
|
<div align="center">
|
|
2
2
|
|
|
3
|
-
# 🆓 FreeClaude v3
|
|
3
|
+
# 🆓 FreeClaude v3.0.0
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
**Бесплатный AI-ассистент для разработки — Fallback Chain, Semantic Memory, Voice, MCP, PM Tools**
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
Форк Claude Code без привязки к OAuth. Работает с любым OpenAI-совместимым провайдером.
|
|
8
8
|
|
|
9
9
|
[](https://github.com/alexgrebeshok-coder/freeclaude/releases)
|
|
10
10
|
[](https://github.com/alexgrebeshok-coder/freeclaude)
|
|
11
|
-
[](https://github.com/alexgrebeshok-coder/freeclaude)
|
|
12
|
+
[](https://github.com/alexgrebeshok-coder/freeclaude/tree/main/desktop)
|
|
13
13
|
[](https://github.com/alexgrebeshok-coder/freeclaude/tree/main/extension)
|
|
14
|
+
[](https://github.com/alexgrebeshok-coder/freeclaude/tree/main/mcp-servers)
|
|
14
15
|
[](LICENSE)
|
|
15
16
|
|
|
16
17
|
[English](#english) · [Русский](#русский)
|
|
@@ -21,173 +22,500 @@ Fork of Claude Code without OAuth lock-in. Works with any OpenAI-compatible prov
|
|
|
21
22
|
|
|
22
23
|
## 🇷🇺 Русский
|
|
23
24
|
|
|
24
|
-
###
|
|
25
|
+
### Зачем FreeClaude
|
|
25
26
|
|
|
26
|
-
|
|
27
|
-
|------|-------|--------|
|
|
28
|
-
| **Phase 0** | 🔧 Quality foundation, branding, CI/CD | ✅ |
|
|
29
|
-
| **Phase 1** | 🗂️ `/undo`, `/repo-map`, Voice, Fallback, Memory, Cost tracking | ✅ |
|
|
30
|
-
| **Phase 2** | 🪝 Hooks (26 types), Plugins (20K+ lines), Desktop App (Tauri) | ✅ |
|
|
31
|
-
| **Phase 3** | 💻 VS Code Extension, MCP servers, Background Agents | ✅ |
|
|
32
|
-
| **Phase 4** | 🚀 Launch: npm, Homebrew, Docker | ✅ |
|
|
27
|
+
Claude Code — мощный инструмент, но он привязан к подписке Anthropic ($20/мес) и требует OAuth-авторизацию. FreeClaude снимает эти ограничения: вы используете любые модели от бесплатных (ZAI, Ollama, Gemini) до платных (OpenAI, DeepSeek) с автоматическим переключением при сбоях.
|
|
33
28
|
|
|
34
|
-
|
|
29
|
+
**Что вы получаете бесплатно, что у конкурентов платно или отсутствует:**
|
|
35
30
|
|
|
36
|
-
-
|
|
37
|
-
-
|
|
38
|
-
-
|
|
39
|
-
-
|
|
40
|
-
-
|
|
41
|
-
-
|
|
31
|
+
- 🔄 Автоматическое переключение между провайдерами (Fallback Chain)
|
|
32
|
+
- 🧠 Семантическая память между сессиями (GBrain)
|
|
33
|
+
- 🎙️ Голосовой режим (STT + TTS, бесплатно)
|
|
34
|
+
- 🏗️ Управление проектами через MCP (EVM, CPI, SPI)
|
|
35
|
+
- 🏢 Доступ к данным 1С:Предприятие через OData
|
|
36
|
+
- 🖥 Нативное десктоп-приложение (Tauri)
|
|
37
|
+
- 💻 Расширение для VS Code
|
|
38
|
+
- 🪝 Система хуков (26 типов событий)
|
|
39
|
+
- 🇷🇺 Полная поддержка русского языка
|
|
42
40
|
|
|
43
|
-
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
### Установка
|
|
44
|
+
|
|
45
|
+
**Способ 1 — npm (рекомендуется):**
|
|
46
|
+
```bash
|
|
47
|
+
npm install -g @freeclaude/cli
|
|
48
|
+
freeclaude
|
|
49
|
+
```
|
|
44
50
|
|
|
51
|
+
**Способ 2 — из исходников:**
|
|
45
52
|
```bash
|
|
46
|
-
# 1. Clone & build
|
|
47
53
|
git clone https://github.com/alexgrebeshok-coder/freeclaude.git
|
|
48
54
|
cd freeclaude
|
|
49
55
|
bun install && bun run build
|
|
56
|
+
node dist/cli.mjs
|
|
57
|
+
```
|
|
50
58
|
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
59
|
+
**Десктоп-приложение (Tauri):**
|
|
60
|
+
```bash
|
|
61
|
+
git clone https://github.com/alexgrebeshok-coder/freeclaude.git
|
|
62
|
+
cd freeclaude/desktop
|
|
63
|
+
npm install && npm run tauri dev
|
|
64
|
+
```
|
|
54
65
|
|
|
55
|
-
|
|
56
|
-
|
|
66
|
+
**Расширение VS Code:**
|
|
67
|
+
```bash
|
|
68
|
+
git clone https://github.com/alexgrebeshok-coder/freeclaude.git
|
|
69
|
+
cd freeclaude/extension
|
|
70
|
+
npm install && npm run compile
|
|
71
|
+
# Затем загрузите папку extension/ в VS Code: Extensions → ... → Load from Directory
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
---
|
|
75
|
+
|
|
76
|
+
### Быстрый старт (3 шага)
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
# 1. Установите
|
|
80
|
+
npm install -g @freeclaude/cli
|
|
81
|
+
|
|
82
|
+
# 2. Настройте провайдера (минимум один)
|
|
83
|
+
freeclaude
|
|
84
|
+
> /setup free # покажет бесплатные варианты
|
|
85
|
+
> /setup zai # добавит ZAI (ключ берёт из ZAI_API_KEY)
|
|
86
|
+
|
|
87
|
+
# 3. Пишите код!
|
|
88
|
+
> Напиши REST API для блога на FastAPI
|
|
57
89
|
```
|
|
58
90
|
|
|
59
|
-
|
|
91
|
+
---
|
|
60
92
|
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
93
|
+
### Конфигурация
|
|
94
|
+
|
|
95
|
+
Файл `~/.freeclaude.json` — главный конфиг. Поддерживает синтаксис `env:KEY_NAME` для ключей из переменных окружения:
|
|
96
|
+
|
|
97
|
+
```json
|
|
98
|
+
{
|
|
99
|
+
"providers": [
|
|
100
|
+
{
|
|
101
|
+
"name": "zai",
|
|
102
|
+
"baseUrl": "https://api.z.ai/api/coding/paas/v4",
|
|
103
|
+
"apiKey": "env:ZAI_API_KEY",
|
|
104
|
+
"model": "glm-4.7-flash",
|
|
105
|
+
"priority": 1,
|
|
106
|
+
"timeout": 30000
|
|
107
|
+
},
|
|
108
|
+
{
|
|
109
|
+
"name": "ollama",
|
|
110
|
+
"baseUrl": "http://localhost:11434/v1",
|
|
111
|
+
"apiKey": "ollama",
|
|
112
|
+
"model": "qwen2.5:7b",
|
|
113
|
+
"priority": 2,
|
|
114
|
+
"timeout": 60000
|
|
115
|
+
}
|
|
116
|
+
]
|
|
117
|
+
}
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
---
|
|
69
121
|
|
|
70
122
|
### Управление провайдерами и моделями
|
|
71
123
|
|
|
72
|
-
|
|
124
|
+
FreeClaude поддерживает **19+ провайдеров** с единым интерфейсом. Вы можете использовать одновременно несколько бесплатных и платных провайдеров — система автоматически переключится при сбое текущего.
|
|
125
|
+
|
|
126
|
+
#### Просмотр и переключение моделей
|
|
127
|
+
|
|
73
128
|
```
|
|
74
|
-
/model
|
|
75
|
-
/model 1
|
|
76
|
-
/model openrouter
|
|
129
|
+
/model — список всех провайдеров и моделей
|
|
130
|
+
/model 1 — переключиться на провайдера #1
|
|
131
|
+
/model openrouter — переключиться по имени провайдера
|
|
77
132
|
/model openrouter anthropic/claude-sonnet-4 — сменить модель внутри провайдера
|
|
78
133
|
```
|
|
79
134
|
|
|
80
|
-
|
|
135
|
+
**Зачем:** Один проект — разные задачи. Быстрые модели для рефакторинга, мощные — для архитектуры. Переключайтесь одной командой.
|
|
136
|
+
|
|
137
|
+
#### Добавление провайдеров
|
|
138
|
+
|
|
81
139
|
```
|
|
82
|
-
/setup
|
|
83
|
-
/setup free
|
|
84
|
-
/setup local
|
|
85
|
-
/setup paid
|
|
86
|
-
/setup router
|
|
87
|
-
/setup ollama
|
|
88
|
-
/setup openrouter
|
|
89
|
-
/setup zai
|
|
90
|
-
/setup add 2 API_KEY
|
|
91
|
-
/setup remove 2
|
|
140
|
+
/setup — главное меню (все категории)
|
|
141
|
+
/setup free — только бесплатные провайдеры
|
|
142
|
+
/setup local — локальные (Ollama, LM Studio)
|
|
143
|
+
/setup paid — платные (OpenAI, DeepSeek, Anthropic)
|
|
144
|
+
/setup router — роутеры (OpenRouter — 200+ моделей)
|
|
145
|
+
/setup ollama — быстрое добавление Ollama (без ключа)
|
|
146
|
+
/setup openrouter — быстрое добавление OpenRouter
|
|
147
|
+
/setup zai — быстрое добавление ZAI
|
|
148
|
+
/setup add 2 API_KEY — добавить провайдера #2 с ключом
|
|
149
|
+
/setup remove 2 — удалить провайдера #2
|
|
92
150
|
```
|
|
93
151
|
|
|
94
|
-
|
|
152
|
+
**Зачем:** Не нужно помнить URL и формат конфига — `/setup` всё сделает сам.
|
|
153
|
+
|
|
154
|
+
#### Тестирование подключения
|
|
155
|
+
|
|
95
156
|
```
|
|
96
|
-
/providers test
|
|
157
|
+
/providers test — пинг всех провайдеров с отображением latency
|
|
97
158
|
```
|
|
98
159
|
|
|
160
|
+
**Зачем:** Проверьте, что ключи работают и серверы доступны, прежде чем начать работу.
|
|
161
|
+
|
|
162
|
+
---
|
|
163
|
+
|
|
99
164
|
### Бесплатные провайдеры
|
|
100
165
|
|
|
101
|
-
| Провайдер | Ключ | Регистрация | Скорость |
|
|
102
|
-
|
|
103
|
-
| 🇷🇺 ZAI (GLM-5
|
|
104
|
-
|
|
|
105
|
-
|
|
|
106
|
-
|
|
|
107
|
-
|
|
|
108
|
-
|
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
#
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
166
|
+
| Провайдер | Модели | Ключ | Регистрация | Скорость |
|
|
167
|
+
|-----------|--------|------|-------------|----------|
|
|
168
|
+
| 🇷🇺 **ZAI (GLM)** | glm-4.7-flash, glm-5-turbo, **glm-5.1** | `ZAI_API_KEY` | [open.bigmodel.cn](https://open.bigmodel.cn/) | ~15с (reasoning) |
|
|
169
|
+
| 🏠 **Ollama** | qwen2.5:7b, llama3, any local | Не нужен | `ollama pull qwen2.5:7b` | ~1-2с |
|
|
170
|
+
| 🌐 **Google Gemini** | gemini-2.5-flash-lite | `GEMINI_API_KEY` | [aistudio.google.com](https://aistudio.google.com/apikey) | ~3с |
|
|
171
|
+
| ⚡ **Groq** | llama-3.3-70b, mixtral | `GROQ_API_KEY` | [console.groq.com](https://console.groq.com/keys) | ~1с |
|
|
172
|
+
| 🚀 **Cerebras** | llama-3.3-70b | `CEREBRAS_API_KEY` | [cloud.cerebras.ai](https://cloud.cerebras.ai) | ~0.5с |
|
|
173
|
+
| 🇨🇳 **Qwen/DashScope** | qwen-plus, qwen-max | `DASHSCOPE_API_KEY` | [dashscope.console.aliyun.com](https://dashscope.console.aliyun.com/) | ~3с |
|
|
174
|
+
|
|
175
|
+
**Пример — подключение ZAI за 1 минуту:**
|
|
176
|
+
```bash
|
|
177
|
+
# 1. Получите ключ на open.bigmodel.cn (бесплатная регистрация)
|
|
178
|
+
# 2. Добавьте в ~/.zshrc
|
|
179
|
+
echo 'export ZAI_API_KEY=ваш-ключ' >> ~/.zshrc && source ~/.zshrc
|
|
180
|
+
# 3. В FreeClaude:
|
|
181
|
+
freeclaude
|
|
182
|
+
> /setup zai
|
|
183
|
+
> /model zai
|
|
184
|
+
```
|
|
185
|
+
|
|
186
|
+
**Пример — локальная модель через Ollama:**
|
|
187
|
+
```bash
|
|
188
|
+
# 1. Установите Ollama: curl -fsSL https://ollama.ai/install.sh | sh
|
|
189
|
+
# 2. Скачайте модель: ollama pull qwen2.5:7b
|
|
117
190
|
# 3. В FreeClaude:
|
|
118
|
-
|
|
119
|
-
/
|
|
191
|
+
freeclaude
|
|
192
|
+
> /setup ollama
|
|
193
|
+
> /model ollama
|
|
120
194
|
```
|
|
121
195
|
|
|
122
|
-
|
|
196
|
+
---
|
|
123
197
|
|
|
124
|
-
|
|
125
|
-
|---------|----------|
|
|
126
|
-
| `/model` | Переключить провайдера/модель |
|
|
127
|
-
| `/setup` | Добавить/удалить провайдера |
|
|
128
|
-
| `/commit` | AI-коммит с анализом изменений |
|
|
129
|
-
| `/diff` | Просмотр незакоммиченных изменений |
|
|
130
|
-
| `/undo [N]` | Откат последних N коммитов (soft reset) |
|
|
131
|
-
| `/repo-map` | Обзор структуры репозитория |
|
|
132
|
-
| `/providers test` | Пинг всех провайдеров (latency) |
|
|
133
|
-
| `/cost` | Статистика стоимости (today/week/month) |
|
|
134
|
-
| `/remember <key> <value>` | Сохранить факт в память |
|
|
135
|
-
| `/recall <key>` | Найти в памяти |
|
|
136
|
-
| `/forget <key>` | Удалить из памяти |
|
|
137
|
-
| `/memories` | Список всех сохранённых фактов |
|
|
138
|
-
| `/run <task>` | Запустить фоновую AI-задачу |
|
|
139
|
-
| `/jobs` | Список фоновых задач |
|
|
140
|
-
| `/job <id>` | Результат фоновой задачи |
|
|
141
|
-
| `/hooks` | Управление хуками (26 типов событий) |
|
|
142
|
-
| `/memory` | Редактировать CLAUDE.md файлы |
|
|
143
|
-
| `/status` | Текущая сессия и провайдер |
|
|
144
|
-
|
|
145
|
-
### Hook System
|
|
146
|
-
|
|
147
|
-
FreeClaude includes 5 pre-configured safety hooks:
|
|
148
|
-
|
|
149
|
-
- 🛡️ `prevent-secret-commit` — warns before committing .env/credentials
|
|
150
|
-
- 🗑️ `prevent-rm-without-trash` — blocks `rm -rf`, suggests `trash`
|
|
151
|
-
- ✨ `auto-format-check` — suggests formatting after code edits
|
|
152
|
-
- 📝 `git-commit-tracker` — tracks AI commits for `/undo`
|
|
153
|
-
- ⏰ `long-task-notify` — notifications for slow tasks
|
|
198
|
+
### Multi-Provider Fallback Chain
|
|
154
199
|
|
|
155
|
-
|
|
200
|
+
**Что это:** Если текущий провайдер не отвечает, таймаутит или возвращает ошибку — FreeClaude автоматически переключается на следующий по приоритету. Приоритет задаётся полем `priority` в конфиге (1 = высший).
|
|
156
201
|
|
|
157
|
-
|
|
158
|
-
`pm_project_create`, `pm_project_list`, `pm_task_create`, `pm_task_update`, `pm_evm`, `pm_status`
|
|
202
|
+
**Зачем:** Вы не теряете рабочий контекст из-за сбоя одного провайдера. Система переключается незаметно и продолжает работу.
|
|
159
203
|
|
|
160
|
-
|
|
161
|
-
|
|
204
|
+
**Как настроить:**
|
|
205
|
+
```json
|
|
206
|
+
{
|
|
207
|
+
"providers": [
|
|
208
|
+
{ "name": "zai", "priority": 1 },
|
|
209
|
+
{ "name": "ollama", "priority": 2 },
|
|
210
|
+
{ "name": "gemini", "priority": 3 }
|
|
211
|
+
]
|
|
212
|
+
}
|
|
213
|
+
```
|
|
214
|
+
Если ZAI упадёт — переключится на Ollama, затем на Gemini. Все три бесплатные.
|
|
215
|
+
|
|
216
|
+
---
|
|
217
|
+
|
|
218
|
+
### Slash Commands (все команды)
|
|
219
|
+
|
|
220
|
+
| Команда | Описание | Пример |
|
|
221
|
+
|---------|----------|--------|
|
|
222
|
+
| `/model` | Список / переключение провайдера и модели | `/model openrouter` |
|
|
223
|
+
| `/setup` | Добавление, удаление, настройка провайдеров | `/setup free` |
|
|
224
|
+
| `/commit` | AI-коммит с анализом diff | `/commit` |
|
|
225
|
+
| `/diff` | Просмотр незакоммиченных изменений | `/diff` |
|
|
226
|
+
| `/undo [N]` | Откат последних N коммитов (soft reset) | `/undo 3` |
|
|
227
|
+
| `/repo-map` | Обзор структуры репозитория | `/repo-map` |
|
|
228
|
+
| `/providers test` | Пинг всех провайдеров с latency | `/providers test` |
|
|
229
|
+
| `/cost` | Статистика стоимости (сегодня / неделя / месяц) | `/cost` |
|
|
230
|
+
| `/remember <key> <value>` | Сохранить факт в память | `/remember db postgres` |
|
|
231
|
+
| `/recall <key>` | Поиск в памяти по ключу или смыслу | `/recall database` |
|
|
232
|
+
| `/forget <key>` | Удалить факт из памяти | `/forget db` |
|
|
233
|
+
| `/memories` | Список всех сохранённых фактов | `/memories` |
|
|
234
|
+
| `/run <task>` | Запустить фоновую AI-задачу | `/run напиши тесты для auth.ts` |
|
|
235
|
+
| `/jobs` | Список фоновых задач со статусами | `/jobs` |
|
|
236
|
+
| `/job <id>` | Результат конкретной фоновой задачи | `/job 3` |
|
|
237
|
+
| `/hooks` | Управление хуками | `/hooks` |
|
|
238
|
+
| `/memory` | Редактировать CLAUDE.md файлы проекта | `/memory` |
|
|
239
|
+
| `/status` | Текущая сессия, провайдер, модель | `/status` |
|
|
240
|
+
| `/daily` | Итоги дня | `/daily` |
|
|
241
|
+
|
|
242
|
+
---
|
|
243
|
+
|
|
244
|
+
### Память (GBrain Semantic Memory)
|
|
245
|
+
|
|
246
|
+
**Что это:** Система, которая запоминает факты о вашем проекте между сессиями. Использует локальные эмбеддинги для семантического поиска — вы можете найти информацию даже по описанию, а не только по точному ключу.
|
|
247
|
+
|
|
248
|
+
**Зачем:** Не нужно каждый раз объяснять AI, что вы используете PostgreSQL, что API на FastAPI, что проект монорепо и т.д. Память сохраняется локально и работает между сессиями.
|
|
249
|
+
|
|
250
|
+
**Как пользоваться:**
|
|
251
|
+
```
|
|
252
|
+
> /remember db postgres # Запомнить: база данных — PostgreSQL
|
|
253
|
+
> /remember framework fastapi # Запомнить: фреймворк — FastAPI
|
|
254
|
+
> /remember style black # Запомнить: стиль кода — Black
|
|
255
|
+
|
|
256
|
+
> /recall database # Найти: "database" или "база данных"
|
|
257
|
+
> /recall фреймворк # Семантический поиск по смыслу
|
|
258
|
+
|
|
259
|
+
> /memories # Показать все сохранённые факты
|
|
260
|
+
> /forget db # Удалить конкретный факт
|
|
261
|
+
```
|
|
262
|
+
|
|
263
|
+
---
|
|
264
|
+
|
|
265
|
+
### Голосовой режим (Voice Mode)
|
|
266
|
+
|
|
267
|
+
**Что это:** Говорите с FreeClaude голосом. Распознавание речи через OpenAI Whisper (STT), озвучка ответов через Microsoft Edge TTS (TTS). Всё работает бесплатно и локально.
|
|
268
|
+
|
|
269
|
+
**Зачем:** Не нужно печатать длинные описания задач — просто скажите. Удобно, когда руки заняты или вы обсуждаете архитектуру вслух.
|
|
270
|
+
|
|
271
|
+
**Как включить:** Голосовой режим активируется через соответствующие настройки в интерфейсе (поддерживается в CLI и Desktop App).
|
|
272
|
+
|
|
273
|
+
---
|
|
274
|
+
|
|
275
|
+
### Фоновые агенты (Background Agents)
|
|
276
|
+
|
|
277
|
+
**Что это:** Запускайте AI-задачи в фоне, пока продолжаете работать в основной сессии. Агент выполнит задачу самостоятельно и сохранит результат.
|
|
278
|
+
|
|
279
|
+
**Зачем:** Не ждите, пока AI напишет тесты — отправьте задачу в фон и продолжайте кодить. Проверьте результат позже.
|
|
280
|
+
|
|
281
|
+
**Как пользоваться:**
|
|
282
|
+
```
|
|
283
|
+
> /run напиши unit-тесты для src/auth.ts # Запустить фоновую задачу
|
|
284
|
+
> /jobs # Список задач со статусами
|
|
285
|
+
> /job 3 # Показать результат задачи #3
|
|
286
|
+
```
|
|
287
|
+
|
|
288
|
+
---
|
|
289
|
+
|
|
290
|
+
### Хуки (Hook System)
|
|
291
|
+
|
|
292
|
+
**Что это:** Система из 26 типов событий, на которые можно реагировать автоматически. FreeClaude включает 5 предустановленных хуков безопасности.
|
|
293
|
+
|
|
294
|
+
**Зачем:** Автоматизация рутинных проверок: запрет коммита секретов, автопроверка форматирования, уведомления о долгих задачах.
|
|
295
|
+
|
|
296
|
+
**Предустановленные хуки:**
|
|
297
|
+
- 🛡️ **prevent-secret-commit** — предупреждает перед коммитом `.env` и файлов с кредами
|
|
298
|
+
- 🗑️ **prevent-rm-without-trash** — блокирует `rm -rf`, предлагает `trash` вместо этого
|
|
299
|
+
- ✨ **auto-format-check** — предлагает форматирование после редактирования кода
|
|
300
|
+
- 📝 **git-commit-tracker** — отслеживает AI-коммиты для `/undo`
|
|
301
|
+
- ⏰ **long-task-notify** — уведомления о задачах, которые выполняются слишком долго
|
|
302
|
+
|
|
303
|
+
**Как управлять:**
|
|
304
|
+
```
|
|
305
|
+
> /hooks # Показать список хуков и их статусы
|
|
306
|
+
```
|
|
307
|
+
|
|
308
|
+
---
|
|
309
|
+
|
|
310
|
+
### Стоимость (Cost Tracking)
|
|
311
|
+
|
|
312
|
+
**Что это:** FreeClaude считает стоимость каждого запроса на основе токенов и цены модели. Данные доступны по команде `/cost`.
|
|
313
|
+
|
|
314
|
+
**Зачем:** Контролируйте расходы, особенно при использовании платных моделей. Понимайте, сколько стоит каждая сессия, день, неделя.
|
|
315
|
+
|
|
316
|
+
**Как пользоваться:**
|
|
317
|
+
```
|
|
318
|
+
> /cost # Статистика: сегодня / неделя / месяц / всего
|
|
319
|
+
```
|
|
320
|
+
|
|
321
|
+
---
|
|
322
|
+
|
|
323
|
+
### Команды для работы с Git
|
|
324
|
+
|
|
325
|
+
```
|
|
326
|
+
> /commit # AI анализирует git diff и создаёт осмысленный коммит
|
|
327
|
+
> /diff # Показать незакоммиченные изменения
|
|
328
|
+
> /undo 3 # Откатить последние 3 коммита (soft reset, без потери кода)
|
|
329
|
+
> /repo-map # Обзор структуры репозитория (папки, файлы, зависимости)
|
|
330
|
+
```
|
|
331
|
+
|
|
332
|
+
**Зачем:** Не нужно думать над сообщением коммита — AI сам проанализирует изменения и напишет описательный коммит. `/undo` — страховка от ошибочных коммитов.
|
|
333
|
+
|
|
334
|
+
---
|
|
335
|
+
|
|
336
|
+
### MCP Серверы (Model Context Protocol)
|
|
337
|
+
|
|
338
|
+
MCP — протокол для подключения внешних инструментов к AI-ассистенту. FreeClaude включает два готовых MCP-сервера.
|
|
339
|
+
|
|
340
|
+
#### CEOClaw PM — Управление проектами
|
|
341
|
+
|
|
342
|
+
**Что это:** Инструменты для управления проектами на основе EVM (Earned Value Management) — методологии оценки прогресса через стоимость выполненных работ.
|
|
343
|
+
|
|
344
|
+
**Зачем:** Планируйте задачи, отслеживайте бюджет и сроки прямо в чате с AI. Получайте метрики CPI (стоимость) и SPI (расписание) в реальном времени.
|
|
345
|
+
|
|
346
|
+
**Инструменты (7):**
|
|
347
|
+
|
|
348
|
+
| Инструмент | Описание |
|
|
349
|
+
|-----------|----------|
|
|
350
|
+
| `pm_project_create` | Создать проект (название, бюджет, валюта) |
|
|
351
|
+
| `pm_project_list` | Список проектов с количеством задач |
|
|
352
|
+
| `pm_task_create` | Создать задачу (проект, название, приоритет, часы) |
|
|
353
|
+
| `pm_task_update` | Обновить задачу (статус, затраченные часы, ответственный) |
|
|
354
|
+
| `pm_evm` | Метрики EVM (CPI, SPI, EAC, здоровье проекта) |
|
|
355
|
+
| `pm_evm_record` | Записать данные PV/EV/AC |
|
|
356
|
+
| `pm_status` | Обзорная панель всех проектов |
|
|
357
|
+
|
|
358
|
+
**Установка и запуск:**
|
|
359
|
+
```bash
|
|
360
|
+
cd mcp-servers/ceoclaw-pm
|
|
361
|
+
npm install && npm start
|
|
362
|
+
```
|
|
363
|
+
|
|
364
|
+
**Данные хранятся локально:**
|
|
365
|
+
- `~/.freeclaude/pm/projects.json` — проекты
|
|
366
|
+
- `~/.freeclaude/pm/tasks.json` — задачи
|
|
367
|
+
- `~/.freeclaude/pm/evm.json` — точки данных EVM
|
|
368
|
+
|
|
369
|
+
#### 1С OData — Доступ к данным 1С:Предприятие
|
|
370
|
+
|
|
371
|
+
**Что это:** Только чтение данных из 1С через OData-протокол. Работает с любыми конфигурациями, у которых включён OData-сервис.
|
|
372
|
+
|
|
373
|
+
**Зачем:** Запрашивайте данные из 1С прямо в чате: остатки на складе, документы, справочники, финансовые отчёты — без выхода из IDE.
|
|
374
|
+
|
|
375
|
+
**Совместимые конфигурации:**
|
|
376
|
+
- Альфа-Авто (автодилеры)
|
|
377
|
+
- БАЗИС (строительство)
|
|
378
|
+
- ERP Управление предприятием
|
|
379
|
+
- Бухгалтерия
|
|
380
|
+
- Любая кастомная конфигурация с включённым OData
|
|
381
|
+
|
|
382
|
+
**Инструменты (6):**
|
|
383
|
+
|
|
384
|
+
| Инструмент | Описание |
|
|
385
|
+
|-----------|----------|
|
|
386
|
+
| `odata_config` | Проверить статус конфигурации |
|
|
387
|
+
| `odata_list_entities` | Список всех OData-сущностей |
|
|
388
|
+
| `odata_metadata` | Типы и свойства сущностей |
|
|
389
|
+
| `odata_query` | Запрос с фильтрами, выборкой полей, пагинацией |
|
|
390
|
+
| `odata_count` | Подсчёт записей с фильтром |
|
|
391
|
+
| `odata_financial_summary` | Автообнаружение финансовых сущностей |
|
|
392
|
+
|
|
393
|
+
**Установка и настройка:**
|
|
394
|
+
```bash
|
|
395
|
+
cd mcp-servers/onec-odata
|
|
396
|
+
npm install && npm start
|
|
397
|
+
```
|
|
398
|
+
|
|
399
|
+
Конфигурация — файл `~/.freeclaude/onec-config.json`:
|
|
400
|
+
```json
|
|
401
|
+
{
|
|
402
|
+
"baseUrl": "https://1c.company.ru/your_db/odata/standard.odata",
|
|
403
|
+
"username": "odata_user",
|
|
404
|
+
"password": "odata_password"
|
|
405
|
+
}
|
|
406
|
+
```
|
|
407
|
+
|
|
408
|
+
---
|
|
409
|
+
|
|
410
|
+
### Десктоп-приложение (Tauri)
|
|
411
|
+
|
|
412
|
+
**Что это:** Нативное приложение для macOS, Windows и Linux, построенное на Tauri (Rust + Web). Включает чат-интерфейс, панель статуса провайдеров и дашборд стоимости.
|
|
413
|
+
|
|
414
|
+
**Зачем:** Альтернатива терминалу для тех, кому удобнее оконный интерфейс. Легче Electron, быстрее запускается, меньше потребляет ресурсов.
|
|
415
|
+
|
|
416
|
+
**Запуск:**
|
|
417
|
+
```bash
|
|
418
|
+
cd desktop
|
|
419
|
+
npm install && npm run tauri dev
|
|
420
|
+
```
|
|
421
|
+
|
|
422
|
+
**Сборка:**
|
|
423
|
+
```bash
|
|
424
|
+
cd desktop
|
|
425
|
+
npm run tauri build
|
|
426
|
+
```
|
|
427
|
+
|
|
428
|
+
---
|
|
429
|
+
|
|
430
|
+
### Расширение VS Code
|
|
431
|
+
|
|
432
|
+
**Что это:** Интеграция FreeClaude прямо в VS Code. Чат, объяснение кода и исправление ошибок — без переключения между окнами.
|
|
433
|
+
|
|
434
|
+
**Зачем:** Не нужно открывать отдельный терминал — задавайте вопросы AI прямо в редакторе.
|
|
435
|
+
|
|
436
|
+
**Установка:**
|
|
437
|
+
```bash
|
|
438
|
+
cd extension
|
|
439
|
+
npm install && npm run compile
|
|
440
|
+
# VS Code → Extensions → ⋯ → Load from Directory → выбрать папку extension/
|
|
441
|
+
```
|
|
442
|
+
|
|
443
|
+
---
|
|
162
444
|
|
|
163
445
|
### Сравнение с конкурентами
|
|
164
446
|
|
|
165
|
-
| Фича | FreeClaude | Claude Code | Cline | Aider |
|
|
166
|
-
|
|
167
|
-
|
|
|
168
|
-
| Fallback Chain | ✅
|
|
169
|
-
| Semantic Memory | ✅ GBrain | ❌ | ❌ | ❌ |
|
|
170
|
-
| Voice Mode | ✅ | 🔒
|
|
171
|
-
| PM Tools | ✅ MCP | ❌ | ❌ | ❌ |
|
|
172
|
-
| 1С
|
|
173
|
-
|
|
|
174
|
-
|
|
|
447
|
+
| Фича | FreeClaude | Claude Code | Cline | Aider |
|
|
448
|
+
|-------|-----------|-------------|-------|-------|
|
|
449
|
+
| **Цена** | 🆓 Бесплатно | $20/мес | Бесплатно | Бесплатно |
|
|
450
|
+
| **Fallback Chain** | ✅ Авто | ❌ | ❌ | ❌ |
|
|
451
|
+
| **Semantic Memory** | ✅ GBrain | ❌ | ❌ | ❌ |
|
|
452
|
+
| **Voice Mode** | ✅ Бесплатно | 🔒 Платно | ❌ | ❌ |
|
|
453
|
+
| **PM Tools (EVM)** | ✅ MCP | ❌ | ❌ | ❌ |
|
|
454
|
+
| **1С Интеграция** | ✅ OData MCP | ❌ | ❌ | ❌ |
|
|
455
|
+
| **Хуки** | ✅ 26 типов | Частично | ❌ | ❌ |
|
|
456
|
+
| **Desktop App** | ✅ Tauri | ❌ | ❌ | ❌ |
|
|
457
|
+
| **VS Code** | ✅ Extension | ✅ | ✅ | ✅ |
|
|
458
|
+
| **Провайдеры** | 19+ | 1 (Anthropic) | 15+ | 10+ |
|
|
459
|
+
| **Русский язык** | ✅ | ❌ | ❌ | ❌ |
|
|
460
|
+
| **Cost Tracking** | ✅ | ❌ | ❌ | ❌ |
|
|
175
461
|
|
|
176
462
|
---
|
|
177
463
|
|
|
178
464
|
## 🇬🇧 English
|
|
179
465
|
|
|
180
|
-
###
|
|
466
|
+
### Why FreeClaude
|
|
467
|
+
|
|
468
|
+
Claude Code is powerful, but it's locked behind a $20/month subscription and requires OAuth. FreeClaude removes these constraints: use any model from free providers (ZAI, Ollama, Gemini) to paid ones (OpenAI, DeepSeek) with automatic failover.
|
|
181
469
|
|
|
470
|
+
### Installation
|
|
471
|
+
|
|
472
|
+
**Via npm (recommended):**
|
|
473
|
+
```bash
|
|
474
|
+
npm install -g @freeclaude/cli
|
|
475
|
+
freeclaude
|
|
476
|
+
```
|
|
477
|
+
|
|
478
|
+
**From source:**
|
|
182
479
|
```bash
|
|
183
480
|
git clone https://github.com/alexgrebeshok-coder/freeclaude.git
|
|
184
481
|
cd freeclaude
|
|
185
482
|
bun install && bun run build
|
|
186
|
-
cp .freeclaude.example.json ~/.freeclaude.json
|
|
187
483
|
node dist/cli.mjs
|
|
188
484
|
```
|
|
189
485
|
|
|
190
|
-
|
|
486
|
+
**Desktop App (Tauri):**
|
|
487
|
+
```bash
|
|
488
|
+
cd desktop && npm install && npm run tauri dev
|
|
489
|
+
```
|
|
490
|
+
|
|
491
|
+
**VS Code Extension:**
|
|
492
|
+
```bash
|
|
493
|
+
cd extension && npm install && npm run compile
|
|
494
|
+
# Then: VS Code → Extensions → ⋯ → Load from Directory → select extension/
|
|
495
|
+
```
|
|
496
|
+
|
|
497
|
+
---
|
|
498
|
+
|
|
499
|
+
### Quick Start (3 steps)
|
|
500
|
+
|
|
501
|
+
```bash
|
|
502
|
+
# 1. Install
|
|
503
|
+
npm install -g @freeclaude/cli
|
|
504
|
+
|
|
505
|
+
# 2. Configure a provider
|
|
506
|
+
freeclaude
|
|
507
|
+
> /setup free # show free options
|
|
508
|
+
> /setup zai # add ZAI (uses ZAI_API_KEY from env)
|
|
509
|
+
|
|
510
|
+
# 3. Start coding!
|
|
511
|
+
> Write a REST API for a blog using FastAPI
|
|
512
|
+
```
|
|
513
|
+
|
|
514
|
+
---
|
|
515
|
+
|
|
516
|
+
### Configuration
|
|
517
|
+
|
|
518
|
+
File: `~/.freeclaude.json`. Supports `env:KEY_NAME` syntax for environment variables:
|
|
191
519
|
|
|
192
520
|
```json
|
|
193
521
|
{
|
|
@@ -195,26 +523,158 @@ node dist/cli.mjs
|
|
|
195
523
|
{
|
|
196
524
|
"name": "zai",
|
|
197
525
|
"baseUrl": "https://api.z.ai/api/coding/paas/v4",
|
|
198
|
-
"apiKey": "
|
|
526
|
+
"apiKey": "env:ZAI_API_KEY",
|
|
199
527
|
"model": "glm-4.7-flash",
|
|
200
528
|
"priority": 1,
|
|
201
529
|
"timeout": 30000
|
|
530
|
+
},
|
|
531
|
+
{
|
|
532
|
+
"name": "ollama",
|
|
533
|
+
"baseUrl": "http://localhost:11434/v1",
|
|
534
|
+
"apiKey": "ollama",
|
|
535
|
+
"model": "qwen2.5:7b",
|
|
536
|
+
"priority": 2,
|
|
537
|
+
"timeout": 60000
|
|
202
538
|
}
|
|
203
539
|
]
|
|
204
540
|
}
|
|
205
541
|
```
|
|
206
542
|
|
|
207
|
-
|
|
543
|
+
---
|
|
544
|
+
|
|
545
|
+
### Provider Management
|
|
546
|
+
|
|
547
|
+
FreeClaude supports **19+ providers** with a unified interface. Use multiple free and paid providers simultaneously — the system auto-switches on failure.
|
|
548
|
+
|
|
549
|
+
**View and switch:**
|
|
550
|
+
```
|
|
551
|
+
/model — list all providers and models
|
|
552
|
+
/model 1 — switch to provider #1
|
|
553
|
+
/model openrouter — switch by provider name
|
|
554
|
+
/model openrouter anthropic/claude-sonnet-4 — change model within provider
|
|
555
|
+
```
|
|
556
|
+
|
|
557
|
+
**Add providers:**
|
|
558
|
+
```
|
|
559
|
+
/setup — main menu (all categories)
|
|
560
|
+
/setup free — free providers only
|
|
561
|
+
/setup local — local (Ollama, LM Studio)
|
|
562
|
+
/setup paid — paid (OpenAI, DeepSeek, Anthropic)
|
|
563
|
+
/setup router — routers (OpenRouter — 200+ models)
|
|
564
|
+
/setup add 2 API_KEY — add provider #2 with key
|
|
565
|
+
/setup remove 2 — remove provider #2
|
|
566
|
+
```
|
|
567
|
+
|
|
568
|
+
**Test connectivity:**
|
|
569
|
+
```
|
|
570
|
+
/providers test — ping all providers with latency
|
|
571
|
+
```
|
|
572
|
+
|
|
573
|
+
---
|
|
574
|
+
|
|
575
|
+
### Free Providers
|
|
576
|
+
|
|
577
|
+
| Provider | Models | Key | Register | Speed |
|
|
578
|
+
|----------|--------|-----|----------|-------|
|
|
579
|
+
| 🇷🇺 **ZAI (GLM)** | glm-4.7-flash, glm-5-turbo, **glm-5.1** | `ZAI_API_KEY` | [open.bigmodel.cn](https://open.bigmodel.cn/) | ~15s (reasoning) |
|
|
580
|
+
| 🏠 **Ollama** | qwen2.5:7b, llama3, any local | None needed | `ollama pull qwen2.5:7b` | ~1-2s |
|
|
581
|
+
| 🌐 **Google Gemini** | gemini-2.5-flash-lite | `GEMINI_API_KEY` | [aistudio.google.com](https://aistudio.google.com/apikey) | ~3s |
|
|
582
|
+
| ⚡ **Groq** | llama-3.3-70b, mixtral | `GROQ_API_KEY` | [console.groq.com](https://console.groq.com/keys) | ~1s |
|
|
583
|
+
| 🚀 **Cerebras** | llama-3.3-70b | `CEREBRAS_API_KEY` | [cloud.cerebras.ai](https://cloud.cerebras.ai) | ~0.5s |
|
|
584
|
+
| 🇨🇳 **Qwen/DashScope** | qwen-plus, qwen-max | `DASHSCOPE_API_KEY` | [dashscope.console.aliyun.com](https://dashscope.console.aliyun.com/) | ~3s |
|
|
585
|
+
|
|
586
|
+
---
|
|
587
|
+
|
|
588
|
+
### Key Features
|
|
589
|
+
|
|
590
|
+
#### Multi-Provider Fallback Chain
|
|
591
|
+
If the current provider fails, times out, or returns an error, FreeClaude automatically switches to the next one by priority (`priority` field in config, 1 = highest). Your workflow is never interrupted.
|
|
592
|
+
|
|
593
|
+
#### GBrain Semantic Memory
|
|
594
|
+
Cross-session memory using local embeddings. Store facts about your project (`/remember`), retrieve them semantically (`/recall`), and list (`/memories`) or delete (`/forget`) them. No need to re-explain your stack every session.
|
|
595
|
+
|
|
596
|
+
#### Voice Mode
|
|
597
|
+
Speech-to-text via OpenAI Whisper, text-to-speech via Microsoft Edge TTS. Free and local. Speak your requests instead of typing.
|
|
598
|
+
|
|
599
|
+
#### Background Agents
|
|
600
|
+
Run AI tasks in the background while you keep coding. Check results later with `/jobs` and `/job <id>`.
|
|
601
|
+
|
|
602
|
+
#### Hook System (26 event types)
|
|
603
|
+
5 pre-configured safety hooks: prevent secret commits, block `rm -rf`, auto-format check, git commit tracking, long-task notifications. Extend with custom hooks.
|
|
604
|
+
|
|
605
|
+
#### Cost Tracking
|
|
606
|
+
Real-time cost tracking per session, day, week, and month. Works with all providers that report token usage.
|
|
607
|
+
|
|
608
|
+
#### Git Integration
|
|
609
|
+
AI-powered commits (`/commit`), diff viewing (`/diff`), safe rollback (`/undo N`), and repo structure overview (`/repo-map`).
|
|
610
|
+
|
|
611
|
+
---
|
|
612
|
+
|
|
613
|
+
### Slash Commands
|
|
614
|
+
|
|
615
|
+
| Command | Description |
|
|
616
|
+
|---------|-------------|
|
|
617
|
+
| `/model` | Switch provider/model |
|
|
618
|
+
| `/setup` | Add/remove providers |
|
|
619
|
+
| `/commit` | AI commit with diff analysis |
|
|
620
|
+
| `/diff` | View unstaged changes |
|
|
621
|
+
| `/undo [N]` | Rollback last N commits (soft reset) |
|
|
622
|
+
| `/repo-map` | Repository structure overview |
|
|
623
|
+
| `/providers test` | Ping all providers with latency |
|
|
624
|
+
| `/cost` | Cost stats (today/week/month) |
|
|
625
|
+
| `/remember <key> <value>` | Save fact to memory |
|
|
626
|
+
| `/recall <key>` | Search memory |
|
|
627
|
+
| `/forget <key>` | Delete from memory |
|
|
628
|
+
| `/memories` | List all saved facts |
|
|
629
|
+
| `/run <task>` | Run background AI task |
|
|
630
|
+
| `/jobs` | List background tasks |
|
|
631
|
+
| `/job <id>` | Background task result |
|
|
632
|
+
| `/hooks` | Manage hooks |
|
|
633
|
+
| `/memory` | Edit CLAUDE.md files |
|
|
634
|
+
| `/status` | Current session and provider |
|
|
635
|
+
| `/daily` | Daily summary |
|
|
636
|
+
|
|
637
|
+
---
|
|
638
|
+
|
|
639
|
+
### MCP Servers
|
|
640
|
+
|
|
641
|
+
#### CEOClaw PM — Project Management
|
|
642
|
+
EVM-powered project management with 7 tools: create/list projects, create/update tasks, EVM metrics (CPI, SPI, EAC), and a status dashboard.
|
|
643
|
+
|
|
644
|
+
```bash
|
|
645
|
+
cd mcp-servers/ceoclaw-pm && npm install && npm start
|
|
646
|
+
```
|
|
647
|
+
|
|
648
|
+
#### 1С OData — 1C:Enterprise Data Access
|
|
649
|
+
Read-only access to 1C via OData protocol. Compatible with Альфа-Авто, БАЗИС, ERP, Бухгалтерия, and any custom config with OData enabled.
|
|
650
|
+
|
|
651
|
+
```bash
|
|
652
|
+
cd mcp-servers/onec-odata && npm install && npm start
|
|
653
|
+
```
|
|
654
|
+
|
|
655
|
+
Config: `~/.freeclaude/onec-config.json`
|
|
656
|
+
|
|
657
|
+
---
|
|
658
|
+
|
|
659
|
+
### Comparison with Competitors
|
|
208
660
|
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
661
|
+
| Feature | FreeClaude | Claude Code | Cline | Aider |
|
|
662
|
+
|---------|-----------|-------------|-------|-------|
|
|
663
|
+
| **Price** | 🆓 Free | $20/mo | Free | Free |
|
|
664
|
+
| **Fallback Chain** | ✅ Auto | ❌ | ❌ | ❌ |
|
|
665
|
+
| **Semantic Memory** | ✅ GBrain | ❌ | ❌ | ❌ |
|
|
666
|
+
| **Voice Mode** | ✅ Free | 🔒 Paid | ❌ | ❌ |
|
|
667
|
+
| **PM Tools (EVM)** | ✅ MCP | ❌ | ❌ | ❌ |
|
|
668
|
+
| **1C Integration** | ✅ OData MCP | ❌ | ❌ | ❌ |
|
|
669
|
+
| **Hooks** | ✅ 26 types | Partial | ❌ | ❌ |
|
|
670
|
+
| **Desktop App** | ✅ Tauri | ❌ | ❌ | ❌ |
|
|
671
|
+
| **Providers** | 19+ | 1 (Anthropic) | 15+ | 10+ |
|
|
212
672
|
|
|
213
673
|
---
|
|
214
674
|
|
|
215
675
|
## 📄 License
|
|
216
676
|
|
|
217
|
-
MIT — use freely,
|
|
677
|
+
MIT — use freely, contributions welcome.
|
|
218
678
|
|
|
219
679
|
---
|
|
220
680
|
|