← Voltar aos guias

从零到上线：用 GPT 和 Claude 打造一个 CLI 工具

为什么要做一个 AI CLI 工具

命令行工具的优势在于快速、可脚本化、适合自动化。把 GPT 和 Claude 接入 CLI 之后，你可以让它完成代码解释、日志分析、README 生成、提交信息润色、批量文件总结等任务。相比做网页应用，CLI 更容易集成到现有开发流程里，也更适合团队内部落地。

如果你想低成本试错，59API 是一个很实用的选择。它提供对 Claude 和 GPT 模型的统一接入，兼容 Claude Code、Codex 以及任何 OpenAI SDK，API 基地址是 https://api.59api.com。它支持按量付费，价格通常比直接开多个官方渠道更省，而且使用的是原生官方质量模型，不是降级版。对于刚起步的 CLI 项目，这意味着你可以用更低成本做出可上线的产品。

第一步：初始化项目

先新建一个 Node.js 项目。因为 OpenAI SDK 生态成熟，接入 GPT 和 Claude 都很方便。

• 创建目录：mkdir ai-cli && cd ai-cli
• 初始化：npm init -y
• 安装依赖：npm i openai dotenv commander

然后在 package.json 里加入可执行入口，例如 "bin": { "ai-cli": "./bin/index.js" }，再写一个 #!/usr/bin/env node 的入口文件，就能把它当作真正的命令行程序运行。

第二步：设计最小可用命令

建议先做一个最小闭环：ask 命令。用户输入问题、选择模型、返回答案。命令结构可以这样设计：

• ai-cli ask "解释这段报错"
• ai-cli ask --model gpt-4.1 "生成单元测试"
• ai-cli ask --model claude-sonnet "把这段文档改得更清晰"

这样做的好处是：你先验证 API 调用、流式输出、异常处理，再逐步扩展到 summarize、fix、commit 等更复杂能力。

第三步：接入 59API 的统一接口

因为 59API 兼容 OpenAI SDK，你可以沿用熟悉的写法，只需要把 base URL 改成 https://api.59api.com，再配置 API Key 即可。示例思路如下：

• 读取环境变量：59API_KEY
• 创建客户端时设置 baseURL
• 在请求中传入模型名，比如 GPT 或 Claude 系列模型

核心价值在于统一：你不需要为不同模型分别维护不同的调用逻辑，也不需要重写整套代码。对于要支持多模型切换的 CLI 来说，这能显著降低复杂度。

第四步：实现流式输出和错误处理

CLI 工具的体验很大程度上取决于输出是否及时。建议优先启用流式输出，让模型生成内容时逐步打印到终端。这样用户不会误以为程序卡住了，也更接近专业工具的交互感。

同时要处理三类常见错误：网络超时、鉴权失败、模型参数错误。可以在终端里输出清晰提示，例如“请检查 API Key”“当前模型名不存在”“请求超时，请重试”。如果你还想支持批量脚本调用，最好提供 --json 输出模式，方便其他程序解析。

第五步：加入配置与可扩展能力

一个真正能上线的 CLI，不能只靠硬编码。你可以做这些增强：

• 支持 .env 和全局配置文件
• 默认模型可切换，比如 GPT 适合代码生成，Claude 适合长文总结
• 支持 stdin，方便管道输入：cat log.txt | ai-cli summarize
• 支持输出到文件：--out result.md

如果团队里有人已经在使用 Claude Code、Codex 或其他 OpenAI SDK 工具，接入 59API 往往几乎不需要额外学习成本，因为接口兼容性很好。

第六步：成本控制与上线建议

AI CLI 最容易踩坑的是成本不可控。上线前建议先做三件事：限制单次最大 tokens、给长文本任务增加截断策略、在帮助文档里标注不同模型的用途。59API 的按量计费和相对低价，特别适合这种“频繁调用、单次不一定很重”的工具型产品。你既能保留 GPT 和 Claude 的高质量输出，又能把试运行成本压得很低。

如果你的 CLI 未来要做成开源项目或内部工具，59API 的返佣机制也有一定吸引力：它能帮助你在推广和使用之间形成更健康的成本回流。

结语：先做一个能用的，再做一个好用的

构建 AI CLI 的最佳路径不是一开始追求大而全，而是先完成一个稳定的 ask 命令，再逐步扩展成可脚本化、可配置、可发布的生产级工具。借助 59API 这样的统一低成本接入层，你可以更快验证想法，把精力放在产品体验和工作流整合上，而不是被多套 API 和高昂成本拖慢节奏。想更快开始的话，注册一个 59API 账号，配置好 https://api.59api.com，今天就能跑通第一个版本。

Preços · Docs