Mini Claude Code
Manji1233/Manji1233-mini-claude-code
Agent CLI local com tool-use loop e camada de segurança
Ver no GitHubAgent 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-code1 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
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