J1900 工控机部署 Claude Code 指南

硬件规格

CPU: Intel J1900 (4核 2.0GHz)
RAM: 8GB
OS: Ubuntu 22.04 LTS（推荐）

一、装系统

1.1 制作启动盘

下载 Ubuntu 22.04 LTS Server ISO
用 Rufus / Ventoy 写 U 盘
J1900 插 U 盘开机，按 F7/F12/ESC 选 U 盘启动

1.2 安装要点

语言选 English（避免终端乱码）
最小化安装，不装图形界面
硬盘分区默认就行
创建普通用户（不要用 root）
- 原因：Ubuntu 默认禁用 root 登录，用 sudo 提权更安全
- systemd 服务、npm global 等都需要普通用户运行
- 密码自己设一个记得住的，后面 sudo 会用到

1.3 装好后的初始化

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git vim net-tools

二、装 Node.js

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
node -v    # 应显示 v22.x.x
npm -v     # 应显示 10.x.x

2.1 配置 npm 国内镜像（可选）

npm config set registry https://registry.npmmirror.com

2.2 添加 Swap（可选）

sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo "/swapfile none swap sw 0 0" | sudo tee -a /etc/fstab
free -h

三、装 cc-switch（API 中转）

npm install -g cc-switch-web --unsafe-perm

启动 Web 控制台：

ccsw daemon start

默认访问：http://工控机IP:3000

在 Web 界面中添加 API 中转供应商，配置 Claude 的路由。配置完成后记下代理端口（通常是 8080）。

四、装 Claude Code

npm install -g @anthropic-ai/claude-code --unsafe-perm
claude --version

配置 Claude Code 使用 cc-switch 的本地代理：

export ANTHROPIC_BASE_URL=http://localhost:8080
export ANTHROPIC_API_KEY=你的key

端口 8080 改成 cc-switch 界面显示的实际端口。如果出现登录界面说明代理没配好，回第三步检查。

测试连接：

claude

五、装 cc-connect（微信桥接）

npm install -g cc-connect --unsafe-perm

5.1 创建配置

mkdir -p ~/.cc-connect
vim ~/.cc-connect/config.json

配置内容（向你的微信 bot 服务商获取参数）：

{
  "projects": {
    "picflow": {
      "platform": "weixin",
      "token": "你的Token",
      "agent": "claudecode",
      "admin_from": ""
    }
  }
}

5.2 测试运行

cc-connect run

按 Ctrl+C 停掉。

5.3 设置开机自启（可选）

sudo tee /etc/systemd/system/cc-connect.service << 'EOF'
[Unit]
Description=cc-connect bridge
After=network.target

[Service]
Type=simple
User=你的用户名
ExecStart=/usr/bin/cc-connect run
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable cc-connect
sudo systemctl start cc-connect
sudo systemctl status cc-connect

5.4 cc-switch 开机自启（可选）

sudo tee /etc/systemd/system/cc-switch.service << 'EOF'
[Unit]
Description=cc-switch API proxy
After=network.target

[Service]
Type=simple
User=你的用户名
ExecStart=/usr/bin/ccsw daemon run
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl enable cc-switch
sudo systemctl start cc-switch

六、验证

node -v
claude --version
ccsw daemon status
sudo systemctl status cc-connect

七、常见问题

Q: J1900 会不会卡？

Claude Code 只做终端桥接，AI 推理在云端。8G 够用。

Q: cc-switch 连不上？

检查 http://工控机IP:3000，确认供应商配置正确。

Q: 怎么更新？

npm update -g cc-switch-web
npm update -g @anthropic-ai/claude-code
npm update -g cc-connect

更新前先问玖福。

八、与 Windows 主机共存

Windows 主机：日常对话 + 选图
J1900 工控机：7x24 值守
cc-connect 同一份 token 同时只能跑一个实例

📝 本文由AI生成