HackStart API 接入总览

这套文档面向刚进入 HackStart 技术体系的新同学，你只要按顺序完成账号注册与充值、生成Key、客户端和 Base URL 配置，就可以让 Codex、聊天软件、编辑器插件或本地 Agent 使用 HackStart API。

推荐大家使用Codex桌面端

Codex 是OpenAI推出的项目开发工具，它的价值不只属于程序员，而更像一个能理解本机文件、项目上下文、任务目标和执行步骤的智能工作流助手：既能读代码、改代码、跑命令、解释错误、做 review，也能帮助营销、运营、产品、咨询、研究、财务、法务、管理者和其它高端白领处理复杂办公工作流，例如整理资料、批量改文档、分析竞品、生成报告、规划活动、拆解 SOP、处理表格和自动化重复任务。

Codex有CLI和桌面端两种不同的使用方式，这里更推荐桌面端。Codex的桌面端有非常丰富而强大的插件和技能，比如可以让AI操作你的电脑的Computer Use，操作你的浏览器且保留浏览器登录态的Chrome，生成网页动画和视频的Remotion、HyperFrames等等，当然Codex相比其他工具还有一个利器就是GPT Image 2 ，它是目前最强的生图模型，可以根据文字生成图片、修改已有图片、制作产品图、素材图和视觉方案等等。

HackStart你值得拥有

HackStart API 全线使用 Pro 20x 账号池，提供最高权限模型通道，并已支持GPT-5.6等最新模型能力。你不必在每个客户端里重复研究供应商、账单、网络和协议细节，只要记住 HackStart 的 API Key 和正确的 Base URL 即可。

五种接入方式怎么选

这里最推荐大家使用的是Codex桌面端，对于绝大多数用户来说，只用Codex客户端就足够了，不过HackStart的API并不局限于Codex客户端，至少支持5种接入方式：

1. Codex 桌面端图形界面，适合代码任务，也适合营销、运营、产品和管理者处理资料、报告与办公流程。/docs/integration/codex-desktop/register-and-recharge2. Codex CLI命令行工具，适合自动化脚本、批量文件处理、数据整理和远程工作流。/docs/integration/codex-cli/install3. AI 开源聊天软件以 Cherry Studio 为代表，适合日常聊天、翻译、总结、图片和多模型对比。/docs/integration/chat-clients/cherry-studio4. 编辑器插件在 VS Code、Cursor 等编辑器里直接让 AI 读写当前项目。/docs/integration/editor-plugins/overview5. OpenClaw 与 Hermes更偏 Agent 和本地自动化，适合需要本机任务执行、工具调用和高级工作流的人。/docs/integration/agents/openclaw

使用场景分类

方式	推荐人群	优点	注意事项
Codex 桌面端	技术新人、产品经理、营销运营、咨询顾问、研究员、管理者、项目维护者	安装后就能用，界面清楚，既能处理代码项目，也能处理资料目录、方案文档、报告和办公流程	需要区分 Mac Apple Silicon / Intel；Responses Base URL 不加 /v1
Codex CLI	熟悉终端、需要自动化的人，包括数据分析、增长运营、技术运营和高级办公自动化用户	适合脚本、远程服务器、CI、批量文件处理、表格整理、资料清洗和重复任务自动化	配置文件和环境变量要分清；不要把 Key 提交进仓库
AI 开源聊天软件	日常问答、资料整理、多模型用户	配置简单，能保存会话，适合非代码任务	多数软件走 OpenAI Compatible，因此 Base URL 要加 /v1
编辑器插件	每天写代码的人	能直接读取当前文件、生成补丁、解释错误	插件很多，名称不同，但 OpenAI Compatible 配置逻辑相似
OpenClaw 与 Hermes	需要本地 Agent、工具链和高级自动化的人	可组合本机能力，适合进阶工作流	先完成基础 API Key 和普通 OpenAI Compatible 接入，再做高级配置

两类 Base URL

新手最容易出错的是把 /v1 加错地方。先记住这一条：

场景	Base URL	典型客户端
Codex / Responses Provider	https://ip2.hackstart.org	Codex 桌面端、Codex CLI、CC Switch 导入的 Codex 配置
OpenAI Compatible / Chat Completions	https://ip2.hackstart.org/v1	Cherry Studio、编辑器插件、普通 SDK、Hermes Chat Completions

如果配置项里出现 wire_api = "responses"，通常使用服务根地址 https://ip2.hackstart.org，不要加 /v1。如果软件界面写的是 OpenAI Compatible、OpenAI API Base URL、Chat Completions Base URL，通常使用 https://ip2.hackstart.org/v1。

Codex的配置路线

1、注册账号并充值

要想使用HackStart的API服务，需要先去个人控制台去注册一个账号，并进行充值，充值之后，再去生成一个专门的key。

个人控制台： https://hackstart.org/dashboard

危险

1. API Key 是密码，不能发群、不能截图公开、不能提交到 GitHub。
2. Codex / Responses 使用 https://ip2.hackstart.org，普通 OpenAI Compatible 使用 https://ip2.hackstart.org/v1。
3. 先用一个低成本问题测试成功，再开始长任务，避免配置错误时连续重试。
4. 在测试API前，有必要先在个人控制台先进行充值，不然连接会失败

2、Codex桌面端下载与安装

Codex桌面端是一个软件，需要大家阅读一下Codex 桌面端下载 来下载和安装它，尤其是一些同学网络环境不太好，大家可以去这里下载，HackStart提供了会实时更新的国内可以直接下载的下载源，无论你是Mac电脑还是Windows都不必担心。

3、Codex的配置与CC Switch

Codex的配置对于大多数人来说，是一件非常繁琐、复杂的事情，一旦操作错误，就很难自己改好，这里推荐大家使用CC Switch来管理和配置Codex，它支持很多大模型的配置，以及多个配置文件的创建与修改Codex的配置与CC Switch，即便操作失败了，也不用担心。