1. 从 Claude Code 抄作业mini-cc 为什么锁定 TypeScript React Ink如果你最近在折腾终端里的 AI 编程助手大概率听过 mini-cc 这个名字。它本质上是一个跑在命令行里的 Agent 框架能读文件、执行命令、调用模型、串联工具把「对话」变成「真的动手干活」。而它最值得聊的地方不是功能有多花哨而是技术选型几乎照搬了 Claude CodeTypeScript 做类型约束React 写组件Ink 把组件渲染到终端。这套组合让一个本该很「土」的 CLI 工具变得清晰、可扩展、还特别好维护。这篇文章适合三类人一是想从零搭一个终端 Agent、但不知道选什么技术栈的开发者二是已经在写 Node.js CLI、被console.log排版折磨到崩溃的人三是想把模型调用端点统一到一个 Key 通道、不想在多个 SDK 之间反复横跳的人。我会先讲清楚这套技术栈为什么成立再手把手演示怎么把模型请求接到 TaoToken 的统一 API 通道最后用一次最小对话请求验证连通和返回格式。先说结论mini-cc 选 TypeScript React Ink不是拍脑袋而是因为 Claude Code 已经用真实项目验证过这条路。TypeScript 把运行时错误提前到编译期React 让终端 UI 变成可复用组件Ink 负责把虚拟 DOM 渲染成终端字符。三者叠加开发体验接近写网页但产物是一个纯命令行工具。下面我按「为什么选」到「怎么接」的顺序拆开讲每一步都给可复制的配置。2. 技术栈拆解TypeScript、React、Ink 各自解决什么问题2.1 TypeScript把工具返回结果和消息状态锁进类型系统mini-cc 里有十来个工具有的返回文件内容字符串有的返回执行状态对象有的返回搜索结果数组。如果不用 TypeScript在 QueryEngine 里处理工具返回时就得写一堆typeof result string判断。用 TypeScript 后先定义一个联合类型// src/infrastructure/tools/Tool.ts type ToolResult | { type: text; content: string } | { type: error; message: string; code?: number } | { type: file; path: string; content: string };每个工具的execute方法必须返回这个类型否则编译不过。QueryEngine 处理结果时TypeScript 会强制做类型收窄const result await tool.execute(args); switch (result.type) { case text: console.log(result.content); // result.content 是 string break; case error: console.error(result.message); // result.message 是 string break; }更关键的是消息流状态机。mini-cc 的消息处理有idle → thinking → tool_calling → executing → responding → idle这条链路用可辨识联合把它编进类型type MessageState | { status: idle } | { status: thinking } | { status: tool_calling; toolName: string; args: Recordstring, unknown } | { status: executing; toolName: string; result?: ToolResult } | { status: responding; content: string }; function handleState(state: MessageState) { if (state.status tool_calling) { console.log(state.toolName); // 合法 // console.log(state.content); // 编译报错该状态没有 content } }我踩过一个坑新增了一个不支持工具调用的 Provider忘了判断capabilities.toolCalling直接传了tools参数。TypeScript 在编译阶段就报错了因为chat方法的重载在toolCalling为 false 时不允许传tools。这个错误如果留到运行时就是半夜起来修 bug 的节奏。2.2 React Ink用写网页的方式写终端界面Ink 让你用 React 组件描述终端界面它负责布局、换行、颜色。一个最小例子import React from react; import { render, Text, Box } from ink; const App () ( Box flexDirectioncolumn Text colorgreenHello, mini-cc!/Text TextCurrent directory: {process.cwd()}/Text /Box ); render(App /);跑起来终端里就是带颜色的两行字。为什么 CLI 要引入 React因为一旦界面复杂到有消息列表、滚动、加载动画用原生console.log管理光标位置和清屏就是灾难。用 Ink 后WelcomeBanner、MessageList、ProgressBar都是独立组件状态管理就是useState、useEffect还能直接用ink-spinner这类生态组件。比如启动欢迎界面// src/components/WelcomeBanner.tsx import React from react; import { Box, Text } from ink; export const WelcomeBanner ({ model, provider }: { model: string; provider: string }) ( Box borderStylesingle padding{1} flexDirectioncolumn Text bold colorcyanmini-cc CLI/Text TextModel: Text colorgreen{model}/Text/Text TextProvider: {provider}/Text /Box );消息自动滚动也只是一个useEffectuseEffect(() { if (containerRef.current) scrollToBottom(containerRef.current); }, [messages]);2.3 为什么不选 Rust 或 Go有人会问Rust 性能更好Go 部署更简单为什么用 TypeScript我的真实情况是第一Claude Code 用 TS我直接抄作业改就行没必要重新发明第二我是全栈偏前端TS 最熟时间成本最低第三后续我会用 Python、Go、Rust 各写一版TS 是「第一个版本」而不是「唯一版本」。业界也有类似策略OpenAI 把 Codex CLI 从 TypeScript 重写为 Rust但 TS 版本仍并行维护直到功能对齐。这是「TS 快速迭代验证Rust/Go 上线交付」的清晰分工。Claude Code 和 Gemini CLI 至今仍是 TypeScript React InkAnthropic 工程师提过他们希望用「模型已经很擅长」的技术栈来开发约 90% 的 Claude Code 代码由它自己写出来。3. 接入 TaoToken 统一 Key环境变量与 Base URL 配置片段技术栈定了下一步是让 mini-cc 能真正调用模型。这里我用 TaoToken 作为统一通道好处是一个 Key 走通多个模型不用为每个 Provider 单独维护密钥。先拿到 API Key打开 https://taotoken.net/api-keys 创建然后到 https://taotoken.net/doc 对照接口文档确认路径。Base URL 统一用https://taotoken.net/api注意这个地址不带任何查询参数。mini-cc 读取配置的方式是环境变量加一个本地配置文件。先建.env# .env TAOTOKEN_API_KEYsk-你的Key TAOTOKEN_BASE_URLhttps://taotoken.net/api TAOTOKEN_MODELclaude-sonnet-4-20250514如果你用 Claude Code 本体配置写在~/.claude/settings.json路径和字段名要和官方一致{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的Key, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }如果你用 Codex配置写在~/.codex/auth.json三件套是 Base URL、Key、Model ID{ OPENAI_BASE_URL: https://taotoken.net/api, OPENAI_API_KEY: sk-你的Key, model: gpt-4o }如果你用 Cline 或 CC Switch 这类工具MCP 或 Provider 配置里同样填三件套。以 Cline 的 MCP 配置为例{ mcpServers: { taotoken: { command: npx, args: [-y, taotoken/mcp-server], env: { TAOTOKEN_API_KEY: sk-你的Key, TAOTOKEN_BASE_URL: https://taotoken.net/api, TAOTOKEN_MODEL: claude-sonnet-4-20250514 } } } }在 mini-cc 自己的代码里Provider 初始化时读取这些变量// src/infrastructure/llm/TaoTokenProvider.ts import Anthropic from anthropic-ai/sdk; export function createTaoTokenProvider() { const apiKey process.env.TAOTOKEN_API_KEY; const baseURL process.env.TAOTOKEN_BASE_URL ?? https://taotoken.net/api; if (!apiKey) throw new Error(TAOTOKEN_API_KEY 未设置); return new Anthropic({ apiKey, baseURL, defaultHeaders: { x-client: mini-cc }, }); }注意baseURL只写到/apiSDK 会自动拼接/v1/messages这类路径。如果你手动拼了/v1很容易出现 404。配置完成后模型调用端点就统一走 TaoToken 通道了切换模型只改TAOTOKEN_MODEL一个变量。4. 验证请求一次最小对话请求确认连通与返回格式配置写完必须验证否则你不知道是 Key 错了、地址错了还是模型名错了。先写一个最小脚本不依赖 mini-cc 的完整逻辑// scripts/ping.ts import Anthropic from anthropic-ai/sdk; async function main() { const client new Anthropic({ apiKey: process.env.TAOTOKEN_API_KEY!, baseURL: process.env.TAOTOKEN_BASE_URL ?? https://taotoken.net/api, }); const res await client.messages.create({ model: process.env.TAOTOKEN_MODEL ?? claude-sonnet-4-20250514, max_tokens: 64, messages: [{ role: user, content: 只回复两个字连通 }], }); console.log(stop_reason:, res.stop_reason); console.log(content:, res.content); } main().catch((err) { console.error(请求失败:, err.status, err.message); process.exit(1); });用tsx跑pnpm add -D tsx pnpm tsx scripts/ping.ts成功时你会看到类似输出stop_reason: end_turn content: [ { type: text, text: 连通 } ]stop_reason是end_turn说明模型正常结束content是数组第一项type为text。这个返回格式和 Anthropic 官方一致所以 mini-cc 里处理消息的代码不用改。如果你想在浏览器里先确认模型可用可以打开 https://taotoken.net/models 用模型对话页发一条消息看到回复再回到代码里调。验证通过后把这段逻辑接进 mini-cc 的 QueryEngine替换掉原来的 Provider 初始化即可。实测下来从改配置到跑通第一条请求顺利的话五分钟以内。如果卡住大概率是下面几种错误之一。5. 常见报错排查401、local proxy failed、reading choices、OAuth第一种401 Unauthorized。报错信息通常是authentication_error或invalid x-api-key。原因基本是 Key 没读到或写错。检查.env是否被加载Node 默认不自动读.env需要dotenv或tsx --env-file.env以及 Key 有没有多余空格。如果你在 Claude Code 里看到 401检查~/.claude/settings.json的ANTHROPIC_AUTH_TOKEN字段名是否写对别写成ANTHROPIC_API_KEY。第二种local proxy failed或连接被拒绝。这通常出现在你本地配了某个转发端口但服务没起来。解决方式是确认ANTHROPIC_BASE_URL或OPENAI_BASE_URL直接指向https://taotoken.net/api不要指向http://localhost:xxxx。如果你之前配过本地代理把它清掉直接用统一地址。第三种reading choices或Cannot read properties of undefined (reading choices)。这是 OpenAI SDK 的典型报错说明返回体不是 OpenAI 格式。常见原因是 Base URL 写成了 Anthropic 的路径却用 OpenAI SDK 调或者模型名和通道不匹配。检查你用的 SDK 和 Base URL 是否对应Anthropic SDK 配https://taotoken.net/apiOpenAI SDK 也配同一个地址但模型名要选对应通道支持的。第四种OAuth 相关报错比如OAuth token expired或invalid_grant。如果你用的是 Claude Code 的 OAuth 登录流程切到 Key 模式后要把 OAuth 缓存清掉否则它会优先用过期 token。检查~/.claude/下是否有旧的凭据文件删掉后重新用 Key 配置。第五种模型名 404。报错是model_not_found。去 https://taotoken.net/models 确认当前可用的模型 ID别用记忆里的旧名字。模型 ID 是大小写敏感的claude-sonnet-4-20250514和Claude-Sonnet-4不是一回事。排查顺序建议先看 HTTP 状态码401 查 Key404 查地址和模型名500 查请求体格式。把err.status和err.message都打出来比猜快得多。6. 把 Key 通道固定下来长期编码与 Agent 场景的接入建议配置跑通只是开始真正长期用要考虑稳定性。我的做法是把 TaoToken 的三件套写进项目模板新项目直接复制不再每次重新配。Base URL 固定https://taotoken.net/apiKey 放环境变量不进 GitModel ID 放配置文件方便切换。如果你要跑长时间的编码任务或 Agent 循环建议用 Coding Plan额度更稳不会跑到一半断掉https://taotoken.net/coding-plan 。对于 Claude Code 这类工具接入文档在 https://taotoken.net/doc 里面有各客户端的完整配置示例。如果你只是想先验证模型效果用模型对话页最快https://taotoken.net/models 。需要管理多个 Key 或看用量去控制台https://taotoken.net/console 。Key 的创建和轮换在 https://taotoken.net/api-keys 。最后说一个实用技巧把TAOTOKEN_MODEL做成可覆盖的命令行传参优先于环境变量这样同一个 mini-cc 实例可以临时切模型做对比测试不用改文件。代码里就是process.env.TAOTOKEN_MODEL ?? config.model这一行的事。技术栈选对了接入路径理顺了剩下的就是不断加工具、加技能让 mini-cc 真的能替你干活。