claude-code - 💡(How to fix) Fix Add native binary support for linux/riscv64

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Claude Code cannot run on Linux riscv64 platforms because the native binary is only distributed for x86_64 and arm64. There is no @anthropic-ai/claude-code-linux-riscv64 optional dependency.

Error Message

$ npm install -g @anthropic-ai/claude-code $ claude --version Error: claude native binary not installed.

Either postinstall did not run (--ignore-scripts, some pnpm configs) or the platform-native optional dependency was not downloaded (--omit=optional).

Root Cause

RISC-V is a growing platform for edge computing and AI inference workloads. The SpacemiT K1 SoC (used in boards like Banana Pi BPI-F3 and Orange Pi RV2) supports RVV 1.0 (RISC-V Vector extensions) which makes it interesting for on-device AI applications — exactly the kind of workload where Claude Code would be useful as an assistant.

Ubuntu 24.04 has full riscv64 support, Bun has experimental RISC-V support, and the ecosystem is maturing rapidly.

Fix Action

Fix / Workaround

Workaround attempted

Code Example

$ npm install -g @anthropic-ai/claude-code
$ claude --version
Error: claude native binary not installed.

Either postinstall did not run (--ignore-scripts, some pnpm configs)
or the platform-native optional dependency was not downloaded
(--omit=optional).
RAW_BUFFERClick to expand / collapse

Feature Request: Native binary for Linux RISC-V (riscv64)

Summary

Claude Code cannot run on Linux riscv64 platforms because the native binary is only distributed for x86_64 and arm64. There is no @anthropic-ai/claude-code-linux-riscv64 optional dependency.

Platform

  • Board: Orange Pi RV2 (SpacemiT X60/K1 SoC, 8-core RISC-V)
  • OS: Ubuntu 24.04 Noble (riscv64)
  • Node.js: v18.19.1 (riscv64, installed from apt)
  • Claude Code: 2.1.143

Current behavior

$ npm install -g @anthropic-ai/claude-code
$ claude --version
Error: claude native binary not installed.

Either postinstall did not run (--ignore-scripts, some pnpm configs)
or the platform-native optional dependency was not downloaded
(--omit=optional).

The npm package installs successfully, Node.js runs fine, but the postinstall script finds no matching platform binary for linux-riscv64.

Workaround attempted

Tried running the linux-arm64 binary via QEMU user-mode emulation (qemu-user-static + binfmt-support). The binary (233MB Bun-compiled executable) never completes initialization within 120 seconds due to the overhead of emulating arm64 JIT code on RISC-V hardware.

Why this matters

RISC-V is a growing platform for edge computing and AI inference workloads. The SpacemiT K1 SoC (used in boards like Banana Pi BPI-F3 and Orange Pi RV2) supports RVV 1.0 (RISC-V Vector extensions) which makes it interesting for on-device AI applications — exactly the kind of workload where Claude Code would be useful as an assistant.

Ubuntu 24.04 has full riscv64 support, Bun has experimental RISC-V support, and the ecosystem is maturing rapidly.

Request

Please add @anthropic-ai/claude-code-linux-riscv64 as an optional dependency and build the native binary for linux/riscv64 as part of the release workflow.

🤖 Issue filed from an Orange Pi RV2 running Ubuntu 24.04 riscv64

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING