@anthropic-ai/claude-code 2.1.287 → 2.1.288

package/install.cjs

@@ -5,9 +5,13 @@
 // and copies it over the bin/claude.exe placeholder. After this runs, `claude` execs
 // the native binary directly — no Node.js process stays resident.
 //
-// If the native package isn't present (--omit=optional), prints instructions and
-// leaves the placeholder stub in place. cli-wrapper.cjs (same directory) can be
-// invoked manually as a fallback that keeps working via require.resolve + spawn.
+// If the native package isn't present (or this release channel doesn't ship one
+// for the platform), prints instructions and leaves the placeholder stub in
+// place; builds that set FAIL_ON_MISSING_NATIVE also exit 1 so npm removes the
+// non-working install — and, on an update, puts the previous version back —
+// instead of leaving the stub as `claude` (failInstallUnlessOptionalOmitted).
+// cli-wrapper.cjs (same directory) can be invoked manually as a fallback that
+// keeps working via require.resolve + spawn.
 //
 // Platform detection + PLATFORMS map is duplicated in cli-wrapper.cjs — keep in sync.
 
@@ -27,6 +31,8 @@ const path = require('path')
 // Replaced at build time via sed. Keep the literals below as markers.
 const PACKAGE_PREFIX = '@anthropic-ai/claude-code'
 const BINARY_NAME = 'claude'
+// Substituted to 'true' or 'false'; an unsubstituted marker reads as false.
+const FAIL_ON_MISSING_NATIVE = 'false' === 'true'
 const WRAPPER_NAME = require('./package.json').name
 
 const PLATFORMS = {
@@ -138,6 +144,24 @@ function placeBinary(src, dest) {
   }
 }
 
+// See the header: FAIL_ON_MISSING_NATIVE builds fail an install that cannot
+// produce a working `claude`. A user who passed --omit=optional (or has
+// omit=optional in npmrc) asked for that outcome, so theirs stays soft; npm
+// hands that setting to lifecycle scripts as npm_config_omit (the deprecated
+// optional=false / --no-optional spelling is never exported).
+function failInstallUnlessOptionalOmitted() {
+  if (
+    !FAIL_ON_MISSING_NATIVE ||
+    (process.env.npm_config_omit || '').includes('optional')
+  ) {
+    return
+  }
+  console.error(
+    '  Failing this install so npm does not leave a non-working claude in place.',
+  )
+  process.exitCode = 1
+}
+
 function main() {
   const platformKey = getPlatformKey()
   const info = PLATFORMS[platformKey]
@@ -165,6 +189,7 @@ function main() {
         .map(p => p.replace(PACKAGE_PREFIX + '-', ''))
         .join(', ')}`,
     )
+    failInstallUnlessOptionalOmitted()
     return
   }
 
@@ -194,12 +219,13 @@ function main() {
       return
     }
     console.error(
-      '  This happens with --omit=optional or when the download failed.',
+      '  This happens with --omit=optional or when the download failed; re-run the install to fetch it.',
     )
     console.error(
       '  The `claude` command will print instructions when invoked.',
     )
     console.error('  Fallback: node ' + path.join(__dirname, 'cli-wrapper.cjs'))
+    failInstallUnlessOptionalOmitted()
     return
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/claude-code",
-  "version": "2.1.287",
+  "version": "2.1.288",
   "bin": {
     "claude": "bin/claude.exe"
   },
@@ -21,14 +21,14 @@
   },
   "dependencies": {},
   "optionalDependencies": {
-    "@anthropic-ai/claude-code-darwin-arm64": "2.1.287",
-    "@anthropic-ai/claude-code-darwin-x64": "2.1.287",
-    "@anthropic-ai/claude-code-linux-x64": "2.1.287",
-    "@anthropic-ai/claude-code-linux-arm64": "2.1.287",
-    "@anthropic-ai/claude-code-linux-x64-musl": "2.1.287",
-    "@anthropic-ai/claude-code-linux-arm64-musl": "2.1.287",
-    "@anthropic-ai/claude-code-win32-x64": "2.1.287",
-    "@anthropic-ai/claude-code-win32-arm64": "2.1.287"
+    "@anthropic-ai/claude-code-darwin-arm64": "2.1.288",
+    "@anthropic-ai/claude-code-darwin-x64": "2.1.288",
+    "@anthropic-ai/claude-code-linux-x64": "2.1.288",
+    "@anthropic-ai/claude-code-linux-arm64": "2.1.288",
+    "@anthropic-ai/claude-code-linux-x64-musl": "2.1.288",
+    "@anthropic-ai/claude-code-linux-arm64-musl": "2.1.288",
+    "@anthropic-ai/claude-code-win32-x64": "2.1.288",
+    "@anthropic-ai/claude-code-win32-arm64": "2.1.288"
   },
   "files": [
     "bin/claude.exe",