1. Ubuntu 24.04 上把 gstack 接到 TaoToken从 npm 装到 settings 改完Ubuntu 24.04 装 AI 自动化编程环境最烦的不是敲命令而是装到一半发现 npm 依赖打架、Claude Code 的 settings 里 Base URL 不知道往哪填。这篇就按我实际在 Noble 上跑通的顺序把 gstack 这套 Claude Code 技能包从 npm 安装、Git 配置、Bun 环境到 settings 指向 TaoToken 统一 Key/API 通道逐项拆开写。适合已经在用 Claude Code、想加 gstack 做自动化编程工作流的人也适合刚在 Ubuntu 24.04 上配 AI 编程环境、被 Signed-By 警告和 npm 循环依赖卡住的新手。核心检索词先摆出来Ubuntu 24.04 环境配置 AI 自动化编程 gstack本质是「系统层修依赖 应用层装技能包 通道层改 settings」三件事。gstack 是 Garry Tan 开源的 AI 编程工作流属于 Claude Code 的插件技能不是系统软件依赖 Bun 运行环境而 Claude Code 本身通过 npm 全局安装。两者都装好后真正决定你能不能稳定调用模型的是~/.claude/settings.json里的 Base URL 和 Key 指向哪里。我把它统一指到 TaoToken 的 API 通道一个 Key 管多模型省得在多个平台之间来回切。下面每一步都给可复制命令和配置片段最后附 curl 验证请求是否走通。你照着敲遇到报错直接跳到第 5 节对照。2. 前置环境Ubuntu 24.04 修源警告与 npm 依赖冲突Ubuntu 24.04 加强了软件源签名校验旧官方源没适配新格式apt-get update会冒出一堆N: 缺失 Signed-By警告同时 Ubuntu 把 npm 拆成大量子依赖包残缺安装很容易形成依赖闭环apt install npm直接死锁。这两件事不解决后面 Claude Code 和 gstack 都装不干净。先备份并切清华源Noble 分支已适配新签名规范警告会自动消失下载也快sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak 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 sudo apt-get update更新完不再出现 Signed-By 相关警告。接着用 aptitude 智能修复 npm 依赖死锁它擅长降级和调换依赖逻辑比 apt 更能处理复杂关系sudo apt-get install aptitude sudo aptitude install npmaptitude 会给出方案选择第一个默认方案是「保持软件包当前版本不安装 npm」输入n拒绝第二个推荐方案会降级或调整 nodejs 相关依赖输入y接受。它会自动梳理依赖闭环。装完验证npm -v node -v输出版本号即正常。然后全局装 Claude Codenpm install -g anthropic-ai/claude-code claude --versionGit 也顺手配好gstack 的 setup 脚本和后续仓库操作都要用sudo apt update sudo apt install git -y git config --global user.name 你的名字 git config --global user.email 你的邮箱example.com git config --global color.ui auto git config --global init.defaultBranch main需要免密连远程仓库的话生成 ed25519 密钥全程回车即可ssh-keygen -t ed25519 -C 你的邮箱example.com cat ~/.ssh/id_ed25519.pub把ssh-ed25519开头的内容贴到 GitHub 的 Settings → SSH and GPG keys或 GitLab 的 Settings → SSH Keys再测连通ssh -T gitgithub.com出现认证成功提示就通了。这一步做完系统层和应用层的坑基本填平可以进 gstack 安装。3. 可复制配置gstack 安装与 settings 指向 TaoTokengstack 依赖 Bun没装先补curl -fsSL https://bun.sh/install | bash source ~/.bashrc bun --version一键克隆并执行 setup脚本会自动下载依赖、编译浏览器组件耗时几分钟git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack cd ~/.claude/skills/gstack ./setup如果提示脚本权限不足补一句chmod x setup再跑。装完在项目根目录或全局~/.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关键一步来了把 Claude Code 的 settings 改到 TaoToken。编辑~/.claude/settings.json路径和字段名保持原样只替换 Base URL 和 Key{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 你的TaoToken Key, ANTHROPIC_MODEL: claude-sonnet-4-5-20250929, ANTHROPIC_SMALL_FAST_MODEL: claude-haiku-4-5-20251001 }, permissions: { allow: [Bash, Read, Write, Edit] } }三件套对齐一下别漏项配置项值说明Base URLhttps://taotoken.net/api统一 API 通道入口KeyTaoToken 控制台生成的 Key一个 Key 管多模型Model IDclaude-sonnet-4-5-20250929按需换成其他可用模型Key 在 TaoToken 控制台的 API Keys 页面生成模型 ID 以接入文档里的可用列表为准。如果你用 Codex对应的是~/.codex/auth.json同样把 Base URL 和 Key 换成上面这套用 Cline 的 MCP 配置则在 MCP settings 里填 Base URL、Key、Model ID 三项。三件套缺一个都会连不上这是最常见的翻车点。4. 验证请求curl 测通道 Claude Code 跑通 gstack配置写完别急着开 Claude Code先用 curl 确认通道走通能省掉一半排障时间curl -s https://taotoken.net/api/v1/messages \ -H x-api-key: 你的TaoToken Key \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: claude-sonnet-4-5-20250929, max_tokens: 64, messages: [{role: user, content: reply with ok}] }返回 JSON 里带content字段和正常文本说明 Base URL、Key、Model ID 三件套都对。如果返回 401是 Key 或请求头字段写错返回local proxy failed多半是 Base URL 拼错或网络层拦截返回reading choices相关报错通常是响应体不是预期格式检查 Model ID 是否在可用列表里。通道通了再进项目目录启动 Claude Codecd ~/your-project claude进去后敲/office-hours做产品思路评审或/review跑代码深度审核/qa做自动功能测试。第一次跑 gstack 技能时它会加载浏览器组件如果无头浏览器异常系统一般会自动补齐libgbm1等依赖库手动补也行sudo apt-get install -y libgbm1 libasound2t64更新 gstack 时进目录git pull再执行./setup或在 Claude 里直接/gstack-upgrade。实测下来通道验证这步做完后面 gstack 的技能调用基本不会因为网络层问题中断报错也能快速定位到是配置还是技能本身。5. 常见报错排查401、local proxy failed、reading choices、OAuth把真实会撞上的报错列出来对照比盲猜快得多。401 UnauthorizedKey 没填对或ANTHROPIC_AUTH_TOKEN字段名写成了别的。检查~/.claude/settings.json里字段名是否严格一致Key 有没有多余空格。TaoToken 的 Key 在控制台 API Keys 页面重新生成一个再试。local proxy failedBase URL 写错比如漏了/api或多了斜杠。正确值是https://taotoken.net/api不要带 UTM 参数。也可能是本地网络层拦截换 curl 直接测同一地址curl 通而 Claude Code 不通就是 settings 没生效重启终端或claude进程。reading choices 类报错响应体不是预期的 JSON 结构常见于 Model ID 填了不可用的模型。对照接入文档里的模型列表换成claude-sonnet-4-5-20250929这类确认可用的 ID。如果用的是 Codex检查~/.codex/auth.json里的模型字段是否同步改了。OAuth 相关报错Claude Code 某些版本会尝试走 OAuth 登录流程和 API Key 模式冲突。确认 settings 里用的是ANTHROPIC_AUTH_TOKEN而非 OAuth token必要时清掉~/.claude下的缓存凭证再重启。npm 装 Claude Code 时报 MODULE_NOT_FOUND回到第 2 节用 aptitude 重装 npm别用apt install npm硬刚。gstack setup 报权限不足chmod x setup。无头浏览器起不来补libgbm1、libasound2t64。排查顺序建议固定成先 curl 测通道 → 再查 settings 三件套 → 最后看技能层。这样每次报错都能收敛到具体一层不会在系统、应用、通道之间来回试。6. 把 Key 和通道固定下来长期跑自动化编程环境搭好只是开始真正省心的是把 Key 和通道固定成一套配置之后不管换项目还是加技能都只动 settings 不动系统。TaoToken 的 API 通道在这里的作用就是统一入口一个 Key 覆盖多个模型Claude Code、Codex、Cline MCP 都指同一个 Base URL省掉每个工具单独配一遍的麻烦。需要生成或轮换 Key去控制台 API Keys 页面https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入细节和可用模型列表看文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite想先在网页里试模型对话、确认模型 ID 再写进 settingshttps://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite如果你打算长期用 gstack 跑自动化编程和 Agent 工作流Coding Plan 比按量更划算https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite最后留个实用习惯把~/.claude/settings.json和~/.codex/auth.json里的 Base URL、Key、Model ID 三件套抄一份到密码管理器换机器时直接贴不用重新回忆字段名。gstack 的技能列表更新后/gstack-upgrade跑一次就行配置层不用动。