1. 为什么要在国内命令行里折腾 Claude Code DeepSeekClaude Code 是 Anthropic 推出的命令行编程 Agent它能在终端里直接读写文件、跑命令、调工具把「对话」变成「动手干活」。DeepSeek 则是国内直连、按量计费、中文理解强的大模型输入价格低到可以忽略不计。把这两者拼在一起你得到的是一个不用图形界面、不用订阅、响应还快的终端编程助手。适合谁适合每天泡在终端里的后端、运维、脚本党以及想低成本试水 Agent 工作流的独立开发者。但光有这两样还不够。默认状态下Claude Code 接到任务就闷头开写方向对不对全靠运气这就是大家常说的 Vibe Coding——凭感觉写代码。装上 Superpowers 插件之后情况变了每次开工前它会先停下来给你列两三个实现方案让你选完再动手。这个「先选方案再开工」的规划模式是我认为这套组合里最值钱的部分。我试过直接让 AI 写一个上传接口它二话不说甩出三十行代码结果没做分片、没做校验跑起来就崩。后来加上 Superpowers同样的需求它会先问你要基础版、进阶版还是生产版选完再写返工率肉眼可见地下降。下面我把整套流程拆成可复制的步骤从环境准备到配置片段再到验证动作你照着敲就能在本地终端复现。2. 前置准备Node 环境、API Key 与 TaoToken 接入点动手之前先把地基打好。Claude Code 是 Node 写的所以第一件事是确认 Node 版本。打开终端敲node -v只要大于等于 18 就行。如果版本太低去 Node 官网下个 LTS 装上或者用 nvm 切换。Windows 用户建议直接上 WSL2原生 CMD 和 PowerShell 偶尔会有路径转义的小毛病WSL2 里体验和 Linux 一致。第二件事是拿到模型调用的凭证。这里有两种走法一是直接去 DeepSeek 开放平台注册、充值、创建 API Key二是通过 TaoToken 这类聚合接入点统一管理 Key 和模型路由。TaoToken 的官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。它的好处是你不用在多个平台之间来回切换一个 Key 就能对接不同模型配置里改个 Base URL 和 Model ID 就行。不管你用哪种方式最终你手里要有三样东西一个 Base URL、一个 API Key、一个 Model ID。这三件套是后面所有配置的核心缺一不可。我建议你把它们先记在便签里因为 settings 文件里要反复用到。另外提醒一句Key 属于敏感信息别提交到 Git 仓库本地配置文件记得加进 .gitignore。环境清单大致是这样操作系统 macOS / Linux / WindowsWSL2Node 18一个能用的终端iTerm2、Windows Terminal、Alacritty 都行以及上面说的三件套。网络方面DeepSeek 和 TaoToken 都是国内可直连的不需要额外折腾网络层这点对国内开发者很友好。3. 可复制配置settings.json 与 Superpowers 安装片段这一节是全文的核心所有片段都可以直接复制。先装 Claude Code一行命令npm install -g anthropic-ai/claude-code装完验证一下claude --version看到类似claude-code 1.x.x的输出就说明装好了。接下来配置模型接入。Claude Code 读取的是用户目录下的~/.claude/settings.jsonWindows 下对应C:\Users\你的用户名\.claude\settings.json。用编辑器打开没有就新建写入下面这段{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 你的 API Key, ANTHROPIC_MODEL: deepseek-chat } }这里三个字段要重点说。ANTHROPIC_BASE_URL决定请求发往哪里填 TaoToken 的 API 入口就能走聚合路由ANTHROPIC_AUTH_TOKEN填你申请到的 KeyANTHROPIC_MODEL填模型 IDDeepSeek 系列常用deepseek-chat具体以你接入点文档为准。如果你直接用 DeepSeek 官方Base URL 换成https://api.deepseek.com/v1Model ID 换成对应的版本号。注意Base URL 千万别漏填或填错否则 Claude Code 会去请求 Anthropic 官方接口直接鉴权失败。这是新手最常见的坑。配置写完保存然后装 Superpowers。它是 Claude Code 的插件安装命令claude plugin install superpowers装好后 Claude Code 会加载一组可组合的 Skills覆盖头脑风暴、规划、测试驱动开发、调试、代码审查等环节。如果你用的是支持 MCP 的客户端比如 Cline配置思路类似同样要保证 Base URL、Key、Model ID 三件套齐全。Codex 用户则在auth.json里对应填写逻辑一致。如果你想让方案选择更自动化可以在 settings.json 里追加一段{ superpowers: { auto_select: 0, skip_planning: false } }auto_select设为 0 表示每次都手动选方案skip_planning设为 false 表示保留规划步骤。想省事就把它设成 1默认走第一个方案。我个人建议前期保持手动等你摸清它的方案质量再考虑自动化。4. 验证请求从任务输入到方案选择的完整动作配置写完不验证等于没配。先做一次最基础的连通测试在终端里敲claude 用 Python 写一个 hello world如果终端里正常输出代码说明 Base URL、Key、Model 三件套生效了。这一步失败的话八成是 Key 写错或者 Base URL 带了多余斜杠回头检查 settings.json。连通之后来验证 Superpowers 的规划模式。这是整套流程最关键的体验。在终端里输入一个稍微复杂点的需求比如claude 帮我写一个 FastAPI 接口用来上传文件没装 Superpowers 时Claude Code 会直接开始写代码。装了之后它会先停下来给你一个方案选择菜单大致长这样请选择实现方案 [1] 基础方案单文件上传存储到本地磁盘 - 优点实现简单30 行代码搞定 - 缺点不支持大文件没有进度回调 [2] 进阶方案分片上传 异步存储 - 优点支持大文件断点续传 - 缺点实现复杂需要前端配合 [3] 生产级方案上传到对象存储OSS/S3 - 优点可扩展适合生产环境 - 缺点需要额外配置对象存储 请输入方案编号1/2/3你输入编号回车它才开始写代码。如果三个方案都不满意可以输入自定义需求让它再 brainstorm 一轮。这个「先选方案再开工」的动作就是 Superpowers 规划模式的核心价值——把方向对齐提前到写代码之前。再演示一个重构场景。输入claude 重构 src/legacy/ 目录把所有同步代码改成异步Superpowers 会先让你选重构策略逐文件保守重构、批量重构加自动测试验证、还是只重构核心模块。选完之后 Claude Code 才会遍历目录、逐个文件改、跑测试、报告失败项。整个过程在终端里完成没有任何 IDE 参与。验证成功的标志很简单你能看到方案菜单、能选编号、选完它才动手。如果它跳过菜单直接写代码说明 Superpowers 没加载成功回去检查插件安装那一步。5. 常见报错排查401、local proxy failed 与 OAuth 问题配置过程中最容易撞上的几类报错我按真实遇到的顺序列一下对照着排查。第一类是 401 鉴权失败。终端里出现401 Unauthorized或者authentication_error基本就是 Key 的问题。检查三处Key 有没有复制完整前后别带空格、ANTHROPIC_AUTH_TOKEN字段名有没有拼错、Key 是不是已经过期或被禁用。还有一种情况是你填了 DeepSeek 的 Key 却把 Base URL 指向了别的接入点两边对不上也会 401。第二类是local proxy failed或连接被拒。这类报错通常出现在 Base URL 写错、端口不对、或者本地网络策略拦截的时候。先确认ANTHROPIC_BASE_URL是完整的https://开头地址别漏协议头。如果你在公司内网可能有出口限制换个网络环境试试。注意这里说的是正常的网络连通性排查不涉及任何特殊网络手段。第三类是reading choices相关的解析错误。这种多半是模型返回格式和 Claude Code 预期不一致导致的常见于 Model ID 填错、或者接入点返回的不是标准 OpenAI 兼容格式。解决办法是核对 Model ID 是否和接入点文档一致必要时换成deepseek-chat这类标准名称再试。第四类是 OAuth 相关报错。Claude Code 某些版本会尝试走 OAuth 登录流程如果你用的是 API Key 模式可能会看到OAuth token之类的提示。这时候确认 settings.json 里用的是ANTHROPIC_AUTH_TOKEN而不是登录态配置两者不要混用。清掉旧的登录缓存再重启终端通常能解决。第五类是 Superpowers 装了但菜单不出现。先跑claude plugin list确认插件在列表里不在就重装。在的话检查 settings.json 里skip_planning是不是被误设成了 true那会跳过规划步骤。还有一种可能是当前任务太简单插件判断不需要规划换个复杂点的需求再试。排查的通用思路是先看报错关键词再定位是 Key、URL、Model 还是插件的问题逐项排除。大部分问题都出在三件套没对齐上。6. 把「先选方案再开工」变成日常习惯整套流程跑通之后你会发现最大的变化不是代码写得多快而是返工变少了。以前是 AI 写完你发现方向不对推翻重来Token 白烧现在是动手前先花十秒选个方案方向对了再写总体消耗反而更低。Superpowers 把 Claude Code 从一个「手快的实习生」变成了「会先问清楚需求的工程师」这个转变靠的不是模型能力而是流程纪律。如果你打算长期在终端里做编码和 Agent 任务可以考虑用 Coding Plan 把常用模型和额度统一管理起来省得每次换项目都重新配 Key。想先体验模型对话效果的可以去模型对话页面直接试需要管理多个 Key 的进 API Keys 页面接入细节拿不准的翻一下接入文档。这几个入口都在 TaoToken 站内按需取用就行。最后给个实用建议把~/.claude/settings.json备份一份换机器或者重装系统时直接拷过去省得重新配。Superpowers 的方案菜单用熟了之后你会发现自己越来越依赖这个「先选再干」的节奏因为它真的能挡住很多拍脑袋的决定。