mclaude-headless

分类: 数据与AI | 上传者: leogomide | 下载: 0 | 版本: v1.0（最新）

通过 mclaude 以无头（非交互）模式启动 Claude Code，绕过 TUI。当用户要求使用特定提供程序运行 Claude Code、自动化 Claude Code 调用或使用 mclaude 编写脚本时，请使用此技能。当用户询问如何在没有 TUI 的情况下从命令行使用 mclaude 或想要了解可用的提供程序和模型时，也可以使用。

更新日志: Source: GitHub https://github.com/leogomide/multi-claude

目录结构

当前层级: tree/master/.claude/skills/mclaude-headless/

📁 references/
- 📄 claude-code-cli.md 7.4 KB
📄 SKILL.md 4.5 KB

SKILL.md

---
name: mclaude-headless
description: Launch Claude Code via mclaude in headless (non-interactive) mode, bypassing the TUI. Use this skill when the user asks to run Claude Code with a specific provider, when automating Claude Code invocations, or when scripting with mclaude. Also use when the user asks how to use mclaude from the command line without the TUI, or wants to know available providers and models.
---

# mclaude Headless Mode

Launch Claude Code non-interactively via `mclaude`, skipping the TUI and going straight to execution.

## Discovery

Before running headless, discover available providers, models, and installations:

```bash
mclaude --list
```

Output is JSON:
```json
{
  "providers": [
    { "cliId": "deepseek", "name": "DeepSeek", "templateId": "deepseek", "type": "api", "models": ["deepseek-chat", "deepseek-reasoner"] }
  ],
  "installations": [
    { "cliId": "default", "name": "Default" }
  ],
  "usage": "mclaude --provider <cliId> [--model <model>] [--installation <cliId>] [claude-flags...]"
}
```

Always run `mclaude --list` first to get valid `cliId` values before constructing headless commands.

## Usage

```
mclaude --provider <cliId> [--model <model>] [--installation <name>] [claude-code-flags...]
```

### Required

- `--provider <cliId>` - Provider to use (from `mclaude --list` output). Accepts: templateId, provider name, or slug.

### Optional

- `--model <model>` - Model name. Auto-selects first available if omitted.
- `--installation <name>` - Installation name. Uses "default" if omitted.
- `--master-password <password>` - Master password, if configured. Also accepts `MCLAUDE_MASTER_PASSWORD` env var. Flag takes priority over env var.

### Claude Code flags

All other flags pass through directly to Claude Code. Most important for headless/scripting:

| Flag | Description |
|------|-------------|
| `-p "query"` | Print mode (non-interactive, exits after response) |
| `-c` | Continue most recent conversation |
| `--resume <id>` | Resume specific session |
| `--max-turns N` | Limit agentic turns (print mode only) |
| `--max-budget-usd N` | Max dollar spend before stopping (print mode only) |
| `--output-format json` | JSON output for programmatic parsing |
| `--json-schema '{...}'` | Validate output against JSON Schema (print mode only) |
| `--allowedTools "..."` | Pre-approve specific tools without prompts |
| `--dangerously-skip-permissions` | Skip all permission prompts |
| `--append-system-prompt "..."` | Add instructions to system prompt |
| `--system-prompt "..."` | Replace entire system prompt |
| `-w <name>` | Run in isolated git worktree |

For the complete Claude Code CLI reference with all flags, see [references/claude-code-cli.md](references/claude-code-cli.md).

## Examples

```bash
# Interactive query via print mode
mclaude --provider deepseek --model deepseek-chat -p "explain this function"

# Continue last conversation
mclaude --provider ollama --model llama3 -c

# Scripting with JSON output
mclaude --provider deepseek --model deepseek-chat -p --output-format json "list all TODO comments"

# Autonomous agent with turn limit
mclaude --provider openrouter --model anthropic/claude-sonnet-4 -p --max-turns 5 "fix the failing tests"

# With specific installation
mclaude --provider anthropic --installation work -p "review this PR"

# Auto-select model (uses first available)
mclaude --provider deepseek -p "hello"
```

## Security — Credential Encryption

API keys are encrypted at rest using AES-256-GCM. Encryption is transparent — mclaude decrypts credentials automatically when loading config.

### Master password

If the user has configured a master password (via Settings in the TUI), headless mode requires it to be provided:

```bash
# Via flag
mclaude --provider deepseek --master-password yourPassword -p "hello"

# Via environment variable (more secure — not visible in ps)
MCLAUDE_MASTER_PASSWORD=yourPassword mclaude --provider deepseek -p "hello"
```

If master password is required but not provided, mclaude exits with an error message indicating both options.

## Workflow for Agents

When an agent needs to invoke mclaude headless:

1. Run `mclaude --list` to get available providers and models
2. Parse the JSON output to find the target provider's `cliId` and pick a model from its `models` array
3. Construct the command with `--provider`, `--model`, and any Claude Code flags
4. If master password is configured, include `--master-password` or set `MCLAUDE_MASTER_PASSWORD`
5. Execute and capture output (use `-p` for non-interactive + `--output-format json` for structured output)

登录后下载/点赞/收藏 ❤ 11 | ★ 0

mclaude-headless

目录结构

SKILL.md

举报内容

提示