convez.ai
AgenteAutomaçãoIntermediário
Manji1233

Mini Claude Code

Manji1233/Manji1233-mini-claude-code

Agent CLI local com tool-use loop e camada de segurança

Ver no GitHub
InicialPluginScore · de 0 a 100

Agent CLI local que implementa um loop tool-use com a API Anthropic Messages, oferecendo um ambiente seguro para executar operações de arquivo, busca, execução de comandos e requisições HTTP via linha de comando interativa.

Instalação

$npx convez-ai Manji1233/Manji1233-mini-claude-code

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Automação de tarefas de desenvolvimento local via prompts em linguagem natural
  • Leitura, busca e edição de arquivos do projeto com confirmação de permissões
  • Executar comandos bash e fazer requisições HTTP com segurança gerenciada

Veredito

Implementação educativa e funcional de um agent baseado em tool-use loop. Oferece casos de uso práticos para automação de desenvolvimento local, com mecanismo de permissões implementado e suporte a múltiplos backends Anthropic-compatíveis.

README

A tradução para o português deste README ainda está na fila.

Mini Claude Code

一个用于学习 Agent 工程的迷你版 Claude Code:本地 CLI + Anthropic Messages API tool-use loop + 安全工具层。

v0.1 能力

  • 读取文件:read_file(支持文本和 .docx,读取工作区外绝对路径时会请求确认)
  • 搜索文件路径:glob
  • 搜索文本:search_text
  • 修改文件:edit_file
  • 写入文件:write_file
  • 执行命令:bash
  • 当前进程临时环境变量:env
  • 通用 HTTP API 调用:http_request
  • 对写文件、执行命令、HTTP、环境变量 set/unset 进行权限确认

安装

npm install

使用

推荐像 Claude Code 一样先进入交互界面,然后直接提问:

mini-claude.cmd

进入后直接输入问题即可:

mini-claude> 读取 package.json 并总结 scripts
mini-claude> 搜索 TODO
mini-claude> 创建 notes/demo.txt,内容为 hello

也可以继续使用 npm 启动 REPL:

npm run dev

如果只想执行一次性任务,也支持:

mini-claude.cmd "读取 package.json 并总结 scripts"

可选:构建后注册成全局命令,这样任何目录都能输入 mini-claude:

npm run build
npm link
mini-claude

环境变量

默认使用 Anthropic 官方 API 时,通过环境变量设置密钥(不要把真实密钥提交到仓库):

# CMD
set ANTHROPIC_API_KEY=<your_anthropic_api_key>

# PowerShell
$env:ANTHROPIC_API_KEY="<your_anthropic_api_key>"

如果你使用 Anthropic-compatible 网关,请使用自己的服务地址和令牌:

set ANTHROPIC_BASE_URL=https://your-anthropic-compatible-endpoint.example.com
set ANTHROPIC_AUTH_TOKEN=<your_bearer_token>
set ANTHROPIC_MODEL=<model_id>
set ANTHROPIC_SMALL_FAST_MODEL=<model_id>

说明:

  • ANTHROPIC_BASE_URL 会作为 SDK base URL。
  • ANTHROPIC_AUTH_TOKEN 会作为 Bearer token。
  • ANTHROPIC_MODEL 会作为默认模型。
  • ANTHROPIC_SMALL_FAST_MODEL 当前预留,v0.1 暂不使用。
  • 当模型 ID 不是 claude-* / anthropic.claude-* 时,程序不会发送 Claude 专用的 thinking / output_config 参数,以兼容非 Claude 网关模型。

env 工具只修改 mini-claude 当前进程内的临时 overlay,以及它启动的子进程环境;不会修改 Windows 用户/系统环境变量。

验证

npm run typecheck
npm test
Ver o original no GitHub

Bom para

Relacionados