chore(claude): silence native install check for mise-managed install#38
Merged
Conversation
~/.claude.json records installMethod:native, so Claude Code's doctor
probes ~/.local/bin/claude and warns on every startup — but claude is
installed via mise/aqua, not the native installer:
installMethod is native, but claude command not found at ~/.local/bin/claude
Set two recognized env vars in settings instead of faking the native
layout:
- DISABLE_INSTALLATION_CHECKS=1 — the install-integrity checks early-return,
so the warning (and npm-deprecation / install-mismatch notices) is gone.
This is the intended escape hatch for externally-managed installs.
- DISABLE_AUTOUPDATER=1 — the native self-updater stays off; mise/aqua owns
versioning (mise upgrade aqua-anthropics-claude-code).
00d6ab1 to
aeecdd5
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
~/.claude.jsonrecordsinstallMethod: native, so Claude Code's startup/doctor check (rLq) probes~/.local/bin/claudeand warns on every launch. Butclaudeis installed via mise/aqua (binary under~/.local/share/mise/installs/..., on PATH via mise activation), so the native path is empty:Fix
Instead of faking the native layout with a symlink, set two recognized env vars in
.chezmoitemplates/claude-settings-base.json→~/.claude/settings.json:DISABLE_INSTALLATION_CHECKS=1— verified against the binary: the check function early-returns (if (DISABLE_INSTALLATION_CHECKS) return []) before building any warning, so the native-mismatch warning and npm-deprecation / install-mismatch notices are suppressed. This is the intended escape hatch for externally-managed installs.DISABLE_AUTOUPDATER=1— native self-updater stays off; mise/aqua owns versioning (mise upgrade aqua-anthropics-claude-code).autoUpdates:falsewas already set per-machine; this makes it portable.Why not a symlink / not editing installMethod
~/.local/bin/claude→ mise-shim symlink works but is a fake-native-layout hack.installMethodto a non-native value is worse: the binary's cleanup pathY08runs wheninstallMethod !== "native"and unlinks~/.local/bin/claude— and~/.claude.jsonis runtime-rewritten and not chezmoi-managed (non-portable).Notes
claudestill resolves via mise's activated install dir.DISABLE_INSTALLATION_CHECKSalso silences npm-deprecation notices — desired for an externally-managed install.