Ubuntu 24.04 环境配置 AI自动化编程 gstack

一、Ubuntu 24.04 修复 Signed-By 警告 + npm 依赖冲突

针对 Ubuntu 24.04 系统，解决 Signed-By 警告并修复 npm 依赖冲突最优方案：切换清华软件源 + aptitude 智能修复依赖，可一次性解决源警告、apt安装失败、npm循环依赖问题。

1. 切换清华源（消除Signed-By警告、加速下载）

清华源已适配Ubuntu 24.04新签名规范，切换后警告自动消失，下载速度大幅提升。

备份原有源列表

bash 复制代码

sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak

一键替换为Ubuntu 24.04(Noble)清华源

bash 复制代码

sudo tee /etc/apt/sources.list << 'EOF'
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-updates main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-backports main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-security main restricted universe multiverse
EOF

更新软件源缓存

bash 复制代码

sudo apt-get update

执行完成后，不再出现 N: 缺失 Signed-By 相关警告。

2. aptitude 智能修复 npm 依赖死锁

解决npm MODULE_NOT_FOUND、apt依赖冲突、安装死循环问题

安装依赖修复工具aptitude

bash 复制代码

sudo apt-get install aptitude

智能安装修复npm

bash 复制代码

sudo aptitude install npm

方案选择操作

第一个默认方案：保持软件包当前版本（不安装npm）→ 输入 n 拒绝
第二个推荐方案：降级/调整nodejs相关依赖 → 输入 y 接受
aptitude会自动梳理复杂依赖关系，解决apt无法处理的依赖死锁。

3. 验证npm & 安装Claude Code

检查npm版本，确认修复成功

bash 复制代码

npm -v

输出版本号即为正常。

全局安装Claude Code

bash 复制代码

npm install -g @anthropic-ai/claude-code

原理说明

Signed-By警告：Ubuntu 24.04加强源安全校验，旧官方源未适配新签名格式，清华源完全符合新版规范。
npm依赖冲突：Ubuntu中npm拆分大量子依赖包，残缺安装易造成依赖闭环，aptitude擅长降级、调换依赖逻辑。

二、Ubuntu Git 安装、全局配置 + SSH连接GitHub/GitLab

终端快捷键：Ctrl+Alt+T

1. 安装Git

bash 复制代码

sudo apt update
sudo apt install git -y

验证安装：

bash 复制代码

git --version

2. Git全局身份配置

bash 复制代码

# 设置用户名
git config --global user.name "你的名字"
# 设置邮箱（GitHub/GitLab账号邮箱）
git config --global user.email "你的邮箱@example.com"

# 推荐优化配置
git config --global color.ui auto          # 开启终端彩色显示
git config --global init.defaultBranch main # 默认分支main

3. SSH密钥配置（免密连接远程仓库）

生成ed25519 SSH密钥

bash 复制代码

ssh-keygen -t ed25519 -C "你的邮箱@example.com"

全程回车：默认路径、不设置密钥密码。

查看并复制公钥

bash 复制代码

cat ~/.ssh/id_ed25519.pub

复制全部以ssh-ed25519开头内容。

后台添加公钥

GitHub：Settings → SSH and GPG keys → New SSH key
GitLab：Settings → SSH Keys

测试SSH连通

bash 复制代码

ssh -T git@github.com

出现认证成功提示即配置完成。

Git常用基础命令速查

命令	作用
git init	初始化本地Git仓库
git clone 地址	克隆远程仓库
git status	查看文件变更状态
git add .	暂存所有修改
git commit -m "备注"	提交到本地仓库
git push	推送代码到远程
git pull	拉取远程最新代码

三、gstack（Claude Code AI技能包）安装配置

gstack 是Garry Tan开源AI编程工作流，属于Claude Code插件技能，非系统软件，依赖Bun运行环境。

前置环境

已安装：Claude Code、Git

未安装Bun则执行：

bash 复制代码

curl -fsSL https://bun.sh/install | bash

一键安装gstack

bash 复制代码

git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup

脚本会自动下载依赖、编译浏览器组件，耗时几分钟请耐心等待。

CLAUDE.md 配置启用技能

在项目根目录或全局 ~/.claude/CLAUDE.md 添加：

复制代码

gstack
Use /browse from gstack for all web browsing. Never use mcpclaude-in-chrome* tools.

Available skills:
/office-hours, /plan-ceo-review, /plan-eng-review, /plan-design-review, /design-consultation, /design-shotgun, /design-html, /review, /ship, /land-and-deploy, /canary, /benchmark, /browse, /connect-chrome, /qa, /qa-only, /design-review, /setup-browser-cookies, /setup-deploy, /retro, /investigate, /document-release, /codex, /cso, /autoplan, /plan-devex-review, /devex-review, /careful, /freeze, /guard, /unfreeze, /gstack-upgrade, /learn

常用测试指令

/office-hours：AI产品思路评审
/review：代码深度审核
/qa：自动功能测试

常见问题

脚本权限不足：chmod +x setup
无头浏览器异常：系统自动补齐libgbm1等依赖库
更新gstack：进入目录git pull重新执行./setup，或Claude内执行/gstack-upgrade