快速开始(codex)
本页帮助你完成 SparkAPI 的最小可用接入流程：注册登录、创建 API Key、充值余额、选择工具并完成基础配置。
1. 注册并登录账号
- 打开 SparkAPI 主站 。
- 注册并登录网站。(点击框内按钮切换语言)
2. 创建并获取 API Key
打开 API Key 管理 ，创建新的 API Key。
创建后请立即复制并保存到安全的位置。
SPARKAPI_API_KEY=sk-your-api-key3. 充值并确认余额
新用户可在 钱包管理 中直接用支付宝进行在线充值。
充值后回到控制台确认余额或额度可用，再继续配置接入工具。
4. 选择你要使用的工具
先选择你正在使用的工具，再按对应配置方法填写 SparkAPI 的 API Key、Base URL 和模型名。默认推荐从 ChatGPT App 开始。
ChatGPT App
Codex CLI
Claude Code
Claude Desktop
ChatGPT App 配置
适合想用图形界面完成项目接入、代码修改和任务跟进的用户。ChatGPT App 中包含 Codex 功能，按下面顺序完成配置后，用一句 hi 验证是否接入成功。
1. 下载 ChatGPT App
选择对应系统，前往 OpenAI 官方入口下载安装。
2. 下载 CCSwitch
下载并安装 CCSwitch，用于管理和切换 ChatGPT App 中 Codex 使用的模型服务配置。Windows 选择 x86_64 MSI，macOS 选择 DMG。
3. 配置 CCSwitch
在 CCSwitch 中填写 SparkAPI 的接口信息：
https://sparkapi.org/v1sk-your-api-key| 配置项 | 填写内容 |
|---|---|
| Base URL | https://sparkapi.org/v1 |
| API Key | SparkAPI 控制台创建的 Key |
| 模型名 | 以 SparkAPI 控制台展示为准 |
4. 打开 ChatGPT App 发送 hi 验证
打开 ChatGPT App，进入 Codex，选择刚才配置好的 SparkAPI 服务，然后发送：
hi如果 Codex 正常回复，说明 ChatGPT App 中的 Codex 已经通过 SparkAPI 接入成功。
Codex CLI 配置
适合习惯在终端里使用 Codex 的用户。
1. 安装 Codex CLI
2. 配置 SparkAPI
https://sparkapi.org/v1SPARKAPI_API_KEY先设置 API Key：
export SPARKAPI_API_KEY="sk-your-api-key"再编辑 ~/.codex/config.toml：
model = "gpt-4o-mini"
model_provider = "sparkapi"
[model_providers.sparkapi]
name = "SparkAPI"
base_url = "https://sparkapi.org/v1"
env_key = "SPARKAPI_API_KEY"3. 启动测试
codex "请用三句话说明这个项目的目录结构"Claude Code 配置
适合在终端中使用 Claude Code，并希望切换到 SparkAPI 兼容接口的用户。
1. 安装 Claude Code CLI
2. 配置 SparkAPI
https://sparkapi.org/v1sk-your-api-key配置时重点确认：
| 配置项 | 填写内容 |
|---|---|
| API Key | SparkAPI 控制台创建的 Key |
| Base URL | https://sparkapi.org/v1 |
| 模型名 | 以 SparkAPI 控制台展示为准 |
| 工作目录 | 进入需要 Claude Code 处理的项目目录 |
完成配置后，先在项目目录运行一个短任务，确认 API Key、Base URL 和模型名都可用。
5. 配置完成后检查
不管选择哪一种工具，配置完成后都先做一次最小测试。若请求失败，请优先检查：
| 检查项 | 正确状态 |
|---|---|
| API Key | 未泄露、未禁用、未复制错 |
| Base URL | https://sparkapi.org/v1 |
| 模型名称 | 与控制台显示一致 |
| 余额 | 余额或额度充足 |
| 请求频率 | 未超过限制 |