1. 为什么 GSD 配 Claude Code 会卡在 settings.jsonGSDGet Shit Done Redux是一套把 AI 辅助开发拆成「讨论 → 规划 → 执行 → 验证 → 发布」五个阶段的工作流工具它挂在 Claude Code 里以/gsd-*斜杠命令的形式工作。Claude Code 是 Anthropic 官方的命令行编程助手能读写文件、跑命令、按阶段推进任务。GSD 适合谁适合那些已经用 Claude Code 写代码、但觉得「一次性让 AI 写一大坨、审查不动、结果不可控」的开发者。问题往往不出在 GSD 本身而是出在 Claude Code 的~/.claude/settings.json。这个文件同时管三件事权限白名单、环境变量也就是 API 通道和 Key、以及模型选择。GSD 要自动执行git、npm、node这类命令权限没开就会一直弹确认而如果你想把请求统一走 TaoToken 的通道就得在env里把ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN配对写对。我见过最多的报错就是「权限拒绝」和「401 鉴权失败」两类前者是permissions.allow没覆盖到命令后者基本是 base_url 和 token 没对上或者环境变量名写成了ANTHROPIC_API_KEY而不是ANTHROPIC_AUTH_TOKEN。这篇就按「先给骨架、再逐段解释、最后教你怎么验证连通性和排错」的顺序来目标是你照着抄一遍就能跑通并且自己能定位问题。2. 前置准备TaoToken 的 Key 与通道地址TaoToken 在这里扮演的角色是「统一的 Key / API 通道」你不需要在每台机器、每个工具里分别配不同厂商的凭证而是拿一个 TaoToken 的 Key把 Claude Code 的请求指向它的 Anthropic 兼容入口。这样 GSD 触发的每一次模型调用都走同一条通道排查问题时也只需要看一个地方。你需要先拿到两样东西第一是 API Key。登录后在控制台的 API Keys 页面创建形如sk-开头的一串字符。创建入口在这里https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaude_code_gsd_settings第二是通道地址。Claude Code 走的是 Anthropic 协议所以 base_url 用 TaoToken 的 API 根地址https://taotoken.net/api注意这个地址后面不要自己拼/v1/messages之类Claude Code 会按 Anthropic 的约定自己补路径你多写反而会 404。Key 和地址都拿到后先别急着改全局配置建议在项目目录里用环境变量临时验证一次确认通道通了再写进settings.json这样出问题能快速区分是「通道问题」还是「配置文件问题」。3. settings.json 可复制骨架Claude Code 的配置文件分两层全局的~/.claude/settings.json和项目级的.claude/settings.json。GSD 是全局安装到~/.claude/的所以权限和环境变量建议写在全局文件里项目级只放跟这个项目相关的覆盖项。下面是一份可以直接抄的骨架Node.js 项目为例{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-5 }, permissions: { allow: [ Write, Edit, Read, Bash(git:*), Bash(gh:*), Bash(npm:*), Bash(npx:*), Bash(node:*), Bash(pnpm:*) ], deny: [ Bash(rm -rf:*), Bash(curl:*) ] } }几个关键点逐条说清楚。env里的三个变量是核心。ANTHROPIC_BASE_URL指向 TaoToken 的 API 根地址ANTHROPIC_AUTH_TOKEN放你的 Key。这里最容易踩的坑是变量名Claude Code 认的是ANTHROPIC_AUTH_TOKEN不是ANTHROPIC_API_KEY写错了不会报「变量名错误」而是直接 401很难一眼看出来。ANTHROPIC_MODEL填你要用的模型标识按 TaoToken 文档里支持的名称填。permissions.allow是白名单列进去的命令和工具不再弹确认。GSD 的/gsd-execute-phase会连续跑 git 提交、npm 安装、node 脚本如果没开这些权限你会在每个命令上被拦一次工作流直接断掉。Write和Edit是让 AI 能落盘文件Read让它能读代码库。permissions.deny是黑名单优先级高于 allow。我习惯把rm -rf和curl这类危险或外联命令挡掉避免 AI 在自动执行阶段做出意料之外的操作。deny 不是必须的但对「让 AI 自动跑命令」这件事留一道闸门心里踏实。Python 项目把 Bash 白名单换成对应的工具链即可{ permissions: { allow: [ Write, Edit, Read, Bash(git:*), Bash(gh:*), Bash(uv:*), Bash(python:*), Bash(pytest:*), Bash(ruff:*) ] } }改完settings.json后必须重启 Claude Code配置是在启动时读取的热改不生效。这一点很多人会忽略改完发现没变化其实是进程没重启。4. 验证请求确认通道真的通了配置写完先别急着跑/gsd-new-project用最小成本验证一次连通性。最直接的办法是在 Claude Code 里发一句普通对话看它能不能正常返回。如果返回正常说明 base_url、token、模型三者都对上了。更可控的方式是用 curl 直接打 TaoToken 的接口把变量问题从 Claude Code 里剥离出来curl https://taotoken.net/api/v1/messages \ -H x-api-key: sk-你的TaoToken密钥 \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: claude-sonnet-4-5, max_tokens: 64, messages: [ {role: user, content: reply with ok} ] }返回体里出现正常的content字段就说明 Key 和通道没问题。如果这里就报 401那问题在 Key 或地址跟 Claude Code 无关先解决这一层。通道确认后再验证 GSD 是否装好。启动 Claude Code输入/gsd-help能列出命令列表就说明 skills 目录挂载正常。GSD 安装后文件在~/.claude/skills/gsd-*/和~/.claude/get-shit-done/如果/gsd-help没反应多半是安装时没加--global或者装完没重启。一个完整的验证顺序是这样的# 1. 确认 GSD 文件在位 ls ~/.claude/skills/ | grep gsd # 2. 启动 Claude Code claude # 3. 在会话里验证命令可用 /gsd-help # 4. 验证模型通道发一句普通对话即可四步都过就可以进入正式工作流了。GSD 的标准循环是/gsd-map-codebase # 分析现有代码库 /clear # 清理上下文 /gsd-new-project # 初始化项目生成 PROJECT.md 等 /clear /gsd-discuss-phase 1 # 讨论第一阶段 /gsd-plan-phase 1 # 生成执行计划 /gsd-execute-phase 1 # 执行 /gsd-verify-work 1 # 验证 /gsd-ship 1 # 提交/clear不是可有可无的。GSD 生成的.planning/codebase/下会有一堆分析文档加上讨论和规划阶段的上下文很容易把窗口占满中途报上下文超限。养成「生成完文档就 clear、需要时再当普通文件读」的习惯能省掉很多莫名其妙的失败。5. 常见报错定位401 Unauthorized / authentication_error九成是ANTHROPIC_AUTH_TOKEN写错或没生效。先确认变量名拼写再确认 Key 没有多余空格或换行最后确认改完重启了 Claude Code。如果 curl 能通但 Claude Code 不通那就是配置文件没被读到检查文件路径是不是~/.claude/settings.json。403 / permission denied这是权限问题不是鉴权问题。看报错里被拦的是哪条命令把它加进permissions.allow。GSD 执行阶段常见的被拦命令是git、npm、node按项目类型补齐。404 Not Foundbase_url 写多了路径。ANTHROPIC_BASE_URL只填到https://taotoken.net/api不要带/v1/messages。模型不存在 / model not foundANTHROPIC_MODEL填的名称不在通道支持列表里。换成文档里明确支持的模型标识。上下文超限 / context length exceededGSD 文档堆积导致。执行/clear把.planning/下的文档当普通文件按需读取而不是一直挂在上下文里。/gsd-命令无响应*GSD 没装到全局或装完没重启。重新跑node bin/install.js --claude --global然后重启 Claude Code。在 GSD 源码仓库里跑 /gsd-报冲突*GSD 的规划目录会和源码结构打架换一个普通项目目录再跑。排查时记住一个原则先用 curl 把「通道层」和「配置层」分开。curl 通、Claude Code 不通问题在settings.jsoncurl 也不通问题在 Key 或地址。这样能少绕很多弯。6. 把配置固化下来让工作流稳定跑配置这件事一次跑通之后就该固化别每次开新项目重来一遍。我的做法是把全局~/.claude/settings.json当成「通道 通用权限」的底座项目级.claude/settings.json只覆盖跟这个项目相关的命令白名单。这样换项目时通道和 Key 不用动只调权限。如果你打算长期用 GSD 跑多阶段开发或者把 Claude Code 接进更自动化的 Agent 流程可以考虑用 Coding Plan 把额度固定下来避免按次调用时额度波动影响工作流https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaude_code_gsd_coding想先在网页里验证模型对话是否正常可以用模型对话入口快速试一句https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaude_code_gsd_chatKey 管理和接入文档分别在https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaude_code_gsd_keys https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaude_code_gsd_doc最后留一个实操建议把settings.json纳入版本管理时Key 用占位符真实 Key 通过环境变量注入别把明文密钥提交上去。GSD 的.planning/目录也建议加进.gitignore那些是过程文档不是交付物。配置稳了GSD 的五个阶段才能真正跑顺而不是每走一步都被权限或鉴权打断。