在鸿蒙PC上使用Claude Code等AI Agent

前言

笔者拿到鸿蒙PC,第一感觉就是它很轻薄,比N年前的MacBook Air还要轻,触摸屏很舒服。

但对于程序员来说,更关注的是它能不能像其他笔记本那样痛快地coding。

毕竟如果出个门还要带着MacBook一起才能发挥作用的话,那就没什么意义了。

背景

鸿蒙PC目前是6.0系统,从程序员生产力工具来看还处于蛮荒状态。

自带的终端没有root权限,没有包管理器,没有zsh,没有根目录权限,没有python、没有node、没有gcc,这导致完全无法安装各种基于CLI的AI Agent。

GUI软件也很蛋疼,目前自带的应用商店还没有任何像Cursor、Cline这样的Agent。

笔者写的比较多的是App和前端,而如今2025,已经是一个没有AI就没法写代码的时代了。

常规思路是安装一个Oseasy虚拟机,装arm64 Windows,然后解锁一些GUI软件。我测试了Cursor可以运行,但Cline在安装过程中明确表示不支持arm64架构,无法安装。

由于笔者相比于Cursor更习惯使用Claude Code,这里分享一个曲折使用Claude Code的方式。

注意事项

本文只适合熟悉linux底层、或者有一定动手能力的朋友,总体还是比较繁琐的

关键思路

1. 通过Oseasy安装Linux虚拟机

虽然Oseasy只能提供Windows虚拟机,不能直接安装Linux镜像,但是安装完Windows后,可以在Windows的磁盘管理中预留一个分区给Linux,然后通过Boot Manager来写入一个Linux镜像。

根据已有的攻略分享,笔者选择的是Debian。

这里的详细步骤需要参考前辈们的教程,需要注意的是Boot Manager的分区配置极容易出错,不懂的问题可以随时问AI。

笔者主要参考的这一篇
https://jia.je/hardware/2025/06/10/linux-vm-on-harmonyos-computer/

以及这一篇(看debian部分就行了,不用理会Termony相关的配置)
https://github.com/TermonyHQ/Termony/issues/48

注意中间要改一个启动配置,否则Debian开机会黑屏。

Debian安装后的基础配置

Debian装好之后,就可以字面意思的为所欲为了,有root权限就有无限可能。

首先更新系统:

sudo apt update
sudo apt upgrade -y

安装必要的工具:

# 安装基础开发工具
sudo apt install -y build-essential git curl wget

# 安装Node.js(Claude Code需要)
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs

# 安装Python
sudo apt install -y python3 python3-pip

根据自身情况,选择是否需要安装Debian的GUI,笔者安装了GNOME

安装Claude Code
# 下载并安装Claude Code
# 具体方式根据Claude Code的官方文档进行
npm install -g claude-code
配置终端环境

笔者直接让Claude Code配置zsh/oh-my-zsh等一切常用终端环境,洗个澡的功夫,AI就全部代理配置好了。

# 安装zsh
sudo apt install -y zsh

# 安装oh-my-zsh
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

# 设置zsh为默认shell
chsh -s $(which zsh)

2. 连接宿主机目录

现在Claude Code是有了,但如何连接宿主机的比如Documents目录呢?

毕竟DevEco还是不能直接跑在Linux上。

如果是Oseasy,是有自带的宿主机目录挂载,但Debian就不能直接找到了。

如果能通过目录直接挂载,自然是上上策,但笔者暂时也没研究出来。

次选方案就很多了,如果用Git做版本管理的话,基于Git也行。

不用git的话,可以用hdc,也可以用ftp、sftp等方式挂载。

方案一:使用Git

这个就无需多言了,常规git操作即可,缺点是需要手动同步

方案二:使用FTP挂载 + Git

这个优点是无需手动同步,缺点是git直接运行在FTP/SFTP可能会有问题,需要切换到宿主机进行git提交,但宿主机的git目前又只能用那个挺难用的终端,没有zsh没有GUI没有sourcetree啥的。

在鸿蒙Store里下载FTPNextServer,挂载/Downloads目录

把Dev Eco项目的文件夹放在/Downloads

在Debian中安装sshfs:

sudo apt install -y sshfs

创建挂载点并挂载:

# 创建挂载目录
mkdir -p ~/harmonyos-docs

# 通过SFTP挂载宿主机目录(假设宿主机开启了SSH服务)
sshfs user@host_ip:/path/to/Documents ~/harmonyos-docs
方案二:使用共享文件夹

笔者抛砖引玉,知道怎么办的朋友可以评论区分享下

3. 网络环境问题

这个就是常规操作了,思路有几个:

  • 使用镜像站,或者像笔者一样使用Claude Relay Service自行部署
  • 在虚拟机里开代理,然后Oseasy有选项可以让宿主机吃到代理
  • 路由器设置代理
  • 从海外应用商店下载xxx软件

做了以上准备,就可以爽快打码了,enjoy your coding!

考虑Termony?

Termony是一款通过交叉编译和hnp接口,目标是“一个比官方终端更好的终端”:
https://github.com/TermonyHQ/Termony

这样的app暂时应该是无法上架鸿蒙的,所以你只能自行编译或者下载github action的编译产物,然后设置好dev eco等各种环境,同步签名文件,然后使用项目脚本或者鸿蒙官方的hdc/cli工具进行签名和传送文件、安装,把这个项目作为app从外部系统安装到鸿蒙机。

理论上Termony是有潜力的,能通过基于qemu直接运行linux虚拟机,从而运行各种命令包括claude code。

相比oseasy,好处是轻量级、开源、可以自己折腾。

然而事实是残酷的,

首先编译极其之麻烦,文档非常之省略,全靠自己摸索。

笔者先是折腾各种编译问题花了好几天(折腾时不得不学了很多linux和鸿蒙的知识。。)。

而在终于编译好之后,还是需要处理很多兼容性问题,可能是笔者能力不够,git和zsh都装不上,花式报错。

再加上这个App还缺失了很多常规的终端的能力,比如连基础和宿主机之间的复制粘贴都不成熟,所以目前来说,还是一个不太可用的状态,只能当成玩具。

展望

鸿蒙pc还是挺有潜力的,如果是纯办公不打代码,出门和Macbook二选一我可能会带鸿蒙。

但是目前各种权限问题管得太紧了,生态也刚开始建设,很多能力还需补充,好在官方也是比较重视的,相信未来都会有好的解决方案。

希望官方早一点出Linux虚拟机/WSL,或者包管理器等方案,使得以后使用上能更便利。

Logo

赋能鸿蒙PC开发者,共建全场景原生生态,共享一次开发多端部署创新价值。

更多推荐