1 前言从 2.1.113 版本起Claude Code 已经不再发布纯 js 文件仅发布 Bun 打包过的二进制文件。按照当前的现状用户想要在鸿蒙 PC 原生环境上使用最新版本 Claude Code 已经变成了一件几乎不可能的事情官方不发布鸿蒙版二进制且代码不开源开发者无法自行移植。要解决这个问题有两条路线可以走走 Linux 兼容路线直接将 aarch64-linux-musl 平台的制品放到鸿蒙系统上跑。用 unbun 之类的提取工具将 Claude Code 的 js 部分从二进制文件中提取出来再放到自己准备好的 Bun 或 Node.js 运行时里面去运行。由于方案 2 的产物分发会存在法务合规问题所以本文基于方案 1 进行操作。2 二进制文件获取musl 版本的二进制文件获取途径有两种方式从官网链接下载例如https://downloads.claude.ai/claude-code-releases/2.1.206/linux-arm64-musl/claude。这要求你的下载设备要挂国外代理否则连不通 Claude Code 的官网。用 npm 安装。当前 Claude Code 仍在通过 npm 发包但这个分发方式已经被标记为废弃以后可能就不可用了。这里为了方便读者复现读者不一定有国外代理可用仍使用 npm 的方式获取二进制文件cd~# 使用 Harmonybrew (https://atomgit.com/Harmonybrew) 安装 nodehttps://atomgit.com/Harmonybrew brewinstall-ynodemkdirnpm-cccdnpm-ccnpmconfigsetregistry https://mirrors.huaweicloud.com/repository/npm/npminit-y# 为了确保文档可复现这里锁定了我写文档时使用的版本 2.1.206# 如果你需要最新版本可以改成 latestnpminstall--forceanthropic-ai/claude-code-linux-arm64-musl2.1.206cd~cpnpm-cc/node_modules/anthropic-ai/claude-code-linux-arm64-musl/claude ./现在我们在家目录下得到了 claude 可执行文件文件体积为 200 MB。3 二进制签名在鸿蒙 PC 上运行的 ELF 文件必须要拥有代码签名我们需要使用签名工具对其进行签名。这里不使用官方的 binary-sign-tool 来签名而是使用我自己实现的签名工具来签名cd~# 使用 Harmonybrew 安装 git 和 ohos-sdk分别用来下载代码和编译代码brewinstall-ygitohos-sdk# 下载并编译签名工具gitclone https://github.com/hqzing/ohos-bst-light.gitcdohos-bst-light clang self-sign.c-oself-sign# 用签名工具对 claude 进行签名cd~ ./ohos-bst-light/self-sign claude不使用 binary-sign-tool 的原因binary-sign-tool 做签名操作的时候会破坏 claude 可执行文件的 ELF 结构导致 Bun 运行时无法正确识别到 ELF 文件中携带的资源文件进程启动后不能正确进入 Claude Code 业务逻辑。最终表现就是执行./claude能拉起进程但展示出来的是 Bun 运行时的帮助文档而不是 Claude Code 的 TUI 界面。4 规避 syscall 拦截问题claude 可执行文件里面使用到了一个名为 close_range 的 syscall这个 syscall 会被鸿蒙 PC 的 seccomp 拦截。我自己实现了一个垫片库可以在 close_range 下发内核之前将其拦截替换成自己实现的退化处理逻辑。将它下载并编译准备给下一个步骤使用cd~gitclone https://github.com/hqzing/close-range-shim.gitcdclose-range-shim clang-shared-fPIC-olibclose_range_shim.so close_range_shim.c5 配置模型后使用通过环境变量的方式配置 DeepSeek 模型后运行 claudecd~# 配置环境变量让 Claude Code 使用 DeepSeek API# DeepSeek 本身就有提供 anthropic 格式的 API因此不需要再专门引入 Claude Code Router 之类的转换器# 参考 DeepSeek 官方文档https://api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/claude_codeexportANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropicexportANTHROPIC_AUTH_TOKENsk-xxxexportANTHROPIC_MODELdeepseek-v4-flashexportANTHROPIC_DEFAULT_OPUS_MODELdeepseek-v4-flashexportANTHROPIC_DEFAULT_SONNET_MODELdeepseek-v4-flashexportANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-v4-flashexportCLAUDE_CODE_SUBAGENT_MODELdeepseek-v4-flashexportCLAUDE_CODE_EFFORT_LEVELmaxexportCLAUDE_CODE_TMPDIR/data/storage/el2/base/cacheexportLD_PRELOAD/storage/Users/currentUser/close-range-shim/libclose_range_shim.so ./claude现在 claude 能正常启动。启动后会自动进入到选择皮肤主题和信任文件夹的操作界面。一路按下回车后进入 Claude Code 的 TUI 主界面。输入提示词可以看到任务成功执行。提示如果你需要使用其他厂商的 OpenAI 格式 API可以使用 Harmonybrew 下载 Claude Code Router 进行接口转换brew install claude-code-router。
1 前言从 2.1.113 版本起Claude Code 已经不再发布纯 js 文件仅发布 Bun 打包过的二进制文件。按照当前的现状用户想要在鸿蒙 PC 原生环境上使用最新版本 Claude Code 已经变成了一件几乎不可能的事情官方不发布鸿蒙版二进制且代码不开源开发者无法自行移植。要解决这个问题有两条路线可以走走 Linux 兼容路线直接将 aarch64-linux-musl 平台的制品放到鸿蒙系统上跑。用 unbun 之类的提取工具将 Claude Code 的 js 部分从二进制文件中提取出来再放到自己准备好的 Bun 或 Node.js 运行时里面去运行。由于方案 2 的产物分发会存在法务合规问题所以本文基于方案 1 进行操作。2 二进制文件获取musl 版本的二进制文件获取途径有两种方式从官网链接下载例如https://downloads.claude.ai/claude-code-releases/2.1.206/linux-arm64-musl/claude。这要求你的下载设备要挂国外代理否则连不通 Claude Code 的官网。用 npm 安装。当前 Claude Code 仍在通过 npm 发包但这个分发方式已经被标记为废弃以后可能就不可用了。这里为了方便读者复现读者不一定有国外代理可用仍使用 npm 的方式获取二进制文件cd~# 使用 Harmonybrew (https://atomgit.com/Harmonybrew) 安装 nodehttps://atomgit.com/Harmonybrew brewinstall-ynodemkdirnpm-cccdnpm-ccnpmconfigsetregistry https://mirrors.huaweicloud.com/repository/npm/npminit-y# 为了确保文档可复现这里锁定了我写文档时使用的版本 2.1.206# 如果你需要最新版本可以改成 latestnpminstall--forceanthropic-ai/claude-code-linux-arm64-musl2.1.206cd~cpnpm-cc/node_modules/anthropic-ai/claude-code-linux-arm64-musl/claude ./现在我们在家目录下得到了 claude 可执行文件文件体积为 200 MB。3 二进制签名在鸿蒙 PC 上运行的 ELF 文件必须要拥有代码签名我们需要使用签名工具对其进行签名。这里不使用官方的 binary-sign-tool 来签名而是使用我自己实现的签名工具来签名cd~# 使用 Harmonybrew 安装 git 和 ohos-sdk分别用来下载代码和编译代码brewinstall-ygitohos-sdk# 下载并编译签名工具gitclone https://github.com/hqzing/ohos-bst-light.gitcdohos-bst-light clang self-sign.c-oself-sign# 用签名工具对 claude 进行签名cd~ ./ohos-bst-light/self-sign claude不使用 binary-sign-tool 的原因binary-sign-tool 做签名操作的时候会破坏 claude 可执行文件的 ELF 结构导致 Bun 运行时无法正确识别到 ELF 文件中携带的资源文件进程启动后不能正确进入 Claude Code 业务逻辑。最终表现就是执行./claude能拉起进程但展示出来的是 Bun 运行时的帮助文档而不是 Claude Code 的 TUI 界面。4 规避 syscall 拦截问题claude 可执行文件里面使用到了一个名为 close_range 的 syscall这个 syscall 会被鸿蒙 PC 的 seccomp 拦截。我自己实现了一个垫片库可以在 close_range 下发内核之前将其拦截替换成自己实现的退化处理逻辑。将它下载并编译准备给下一个步骤使用cd~gitclone https://github.com/hqzing/close-range-shim.gitcdclose-range-shim clang-shared-fPIC-olibclose_range_shim.so close_range_shim.c5 配置模型后使用通过环境变量的方式配置 DeepSeek 模型后运行 claudecd~# 配置环境变量让 Claude Code 使用 DeepSeek API# DeepSeek 本身就有提供 anthropic 格式的 API因此不需要再专门引入 Claude Code Router 之类的转换器# 参考 DeepSeek 官方文档https://api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/claude_codeexportANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropicexportANTHROPIC_AUTH_TOKENsk-xxxexportANTHROPIC_MODELdeepseek-v4-flashexportANTHROPIC_DEFAULT_OPUS_MODELdeepseek-v4-flashexportANTHROPIC_DEFAULT_SONNET_MODELdeepseek-v4-flashexportANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-v4-flashexportCLAUDE_CODE_SUBAGENT_MODELdeepseek-v4-flashexportCLAUDE_CODE_EFFORT_LEVELmaxexportCLAUDE_CODE_TMPDIR/data/storage/el2/base/cacheexportLD_PRELOAD/storage/Users/currentUser/close-range-shim/libclose_range_shim.so ./claude现在 claude 能正常启动。启动后会自动进入到选择皮肤主题和信任文件夹的操作界面。一路按下回车后进入 Claude Code 的 TUI 主界面。输入提示词可以看到任务成功执行。提示如果你需要使用其他厂商的 OpenAI 格式 API可以使用 Harmonybrew 下载 Claude Code Router 进行接口转换brew install claude-code-router。
