claude-code-termux-runbook

Indexed Reference Map

• @[SKILL.md#L1-L78] Frontmatter, trigger rules, SOP, output contract.
• @[references/INDEX.md#L1-L21] Reading order + task routing map.
• @[references/QUICK_REFERENCE.md#L1-L51] Quick command setup/check/verify.
• @[references/CORE_API.md#L1-L37] Principle of model alias vs provider catalog + auth mode.
• @[references/PATTERNS.md#L1-L33] Standard pattern and anti-pattern when manipulating.
• @[references/EXAMPLES.md#L1-L56] Playbooks end-to-end theo symptom.
• @[references/AI_WORKFLOW.md#L1-L38] The process executes when the user requests an operation.

Scope

• In-scope:
  • Claude Code on Termux (Android) runs through ANTHROPIC_BASE_URL local proxy.
  • Env mapping ANTHROPIC_DEFAULT_{HAIKU|SONNET|OPUS}_MODEL, ANTHROPIC_MODEL.
  • Triage error Not logged in, auth conflict, provider/model mismatch.
  • Hotfix local cli.js theo backup-first + verify + rollback.
• Out-of-scope:
  • Write upstream patches or reverse-engineer the entire bundle.
  • Automatically operate beyond the user's request.
  • Hard-delete artifact when there is no rollback path.

Reading Order

1. references/INDEX.md
2. references/QUICK_REFERENCE.md
3. references/CORE_API.md
4. references/PATTERNS.md
5. references/EXAMPLES.md
6. references/AI_WORKFLOW.md

Coverage Matrix

• Setup runtime env + model mapping -> QUICK_REFERENCE.md, CORE_API.md
• Diagnose login/auth/provider mismatch -> CORE_API.md, EXAMPLES.md
• Patch/rollback cli.js secure -> PATTERNS.md, EXAMPLES.md
• The assistant process operates according to user requests -> AI_WORKFLOW.md

Trigger Rules

• Positive:
  • User requests "audit Claude Code Termux", "fix model mapping", "fix cli.js", "why does it say Not logged in even though there is an API key", "use cliproxy".
  • Log contains unknown provider for model, Not logged in, Auth conflict.
• Negative:
  • Task unrelated to Claude Code/Termux/model routing.
  • Requires a coding feature unrelated to the Claude runtime.
• Escalation:
  • Any changes to the runtime file (cli.js, launcher) must be backup-first and report a rollback path.
  • If the operation requires a scope outside the runbook, stop and request a direction lock.

SOP

1. Confirm symptom + expected behavior.
2. Collect minimal evidence: claude --version, active env, actual error.
3. Classify errors by CORE_API.md (env missing / provider mismatch / auth conflict / code drift).
4. Prioritize light fixes (env mapping, shell load) before patching the runtime.
5. If you need to patch cli.js: backup-first -> minimum patch -> verify runtime -> save rollback.
6. Report completion according to evidence (scope, path change, verify PASS/FAIL, rollback, risk).

Error Handling

• Not logged in:
  • Check whether the shell loads env; verify ANTHROPIC_API_KEY + ANTHROPIC_BASE_URL.
• unknown provider for model:
  • Check the alias mapping ANTHROPIC_DEFAULT_* and model catalog of the proxy.
• Auth conflict:
  • Not runtime-fail; Handle with the old logout session if you want to clear the warning.
• Patch failure or syntax break:
  • Restore right from backup and report FAIL + cause.

Output Contract

• Artifact:
  • Important command outputs, changed file/path, backup path.
• Validation:
  • Minimum 1 runtime probe (claude -p --model <mapped-model> ...) + exit code.
• Compliance Verdict:
  • PASS|PARTIAL|FAIL + brief reason.