快速开始
三步完成星启AI API 接入:选对协议地址、写入 API Key、按工具类型重新加载配置。后续所有客户端都围绕同一组 Base URL 和同一把密钥展开。
第一步:选择协议地址
| 协议 | Base URL | 适用工具 |
|---|---|---|
| Anthropic 协议 | https://www.starstartai.com | Claude Code、Claude Code 插件、Claude Code 桌面版、Cherry Studio Anthropic、Kilo Code Anthropic。 |
| OpenAI 协议 | https://www.starstartai.com | OpenAI SDK、Codex CLI、Codex App、OpenCode、Hermes Agent、Kilo Code OpenAI Compatible。 |
第二步:写入工具配置
- 先确认工具要求的是 Anthropic 还是 OpenAI-compatible。
- 按上表填写 Base URL。星启AI已兼容 OpenAI 根路径,通常不用手动追加
/v1。 - 把
sk-your-api-key替换为真实 API Key。 - 重启对应 CLI、IDE 或桌面客户端,让配置重新加载。
下一步
按你使用的客户端进入对应教程:Claude Code、Codex CLI、OpenCode、Cherry Studio、Kilo Code、Obsidian 或 Hermes Agent。
接入协议
星启AI 支持 Anthropic 与 OpenAI 两种请求格式。平台已兼容根路径路由,绝大多数工具的 Base URL 可以统一填写 https://www.starstartai.com。
- 用哪种协议:由客户端 / SDK 决定。Anthropic SDK 走
/v1/messages,OpenAI SDK 走/chat/completions或/responses。 - 能调哪些模型:由 API Key 的权限、模型路由和当前可用模型决定,和你选哪种协议是两件独立的事。
也就是说:选错协议会直接 401 / 404;协议选对但模型不可用,会返回模型不可用类错误。
- Base URL 推荐填写
https://www.starstartai.com。 - SDK 或客户端会继续拼接
/v1/messages、/responses、/chat/completions等 endpoint。 - 如果某个客户端强制使用 OpenAI 官方风格,星启AI也兼容
/v1路径。
配置任何工具前先对一眼这张表。
一眼对号入座
| 协议 | Base URL | 典型工具 |
|---|---|---|
| Anthropic 协议 | https://www.starstartai.com | Claude Code CLI / 插件 / 桌面版、Anthropic SDK、Cherry Studio Anthropic、Kilo Code Anthropic。 |
| OpenAI 协议 | https://www.starstartai.com | OpenAI SDK、Codex CLI、Codex App、OpenCode、Hermes Agent、Kilo Code OpenAI Compatible。 |
Anthropic 协议接入
SDK 的 Base URL 填根域名,SDK 会继续拼接 /v1/messages。直接 curl 时需要访问完整 endpoint。
curl https://www.starstartai.com/v1/messages \
-H "x-api-key: sk-your-api-key" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"max_tokens": 1024,
"stream": true,
"messages": [
{"role": "user", "content": "给我一个项目排查步骤"}
]
}'OpenAI 协议接入
OpenAI-compatible 工具和 SDK 的 Base URL 可填 https://www.starstartai.com,然后请求 /responses、/chat/completions 或 /models。如果客户端强制按 OpenAI 官方风格拼接,也兼容 /v1 路径。
curl https://www.starstartai.com/responses \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"stream": true,
"input": "写一个接口接入检查清单"
}'curl https://www.starstartai.com/chat/completions \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"stream": true,
"messages": [
{"role": "user", "content": "用中文介绍星启AI"}
]
}'协议和可用模型是两件事
协议决定客户端如何发请求;模型是否可用取决于当前平台配置、模型路由和账号权限。协议填对但模型不可用时,通常会返回模型不可用或权限不足类错误。
排错速查
- 401:优先检查 API Key 是否填错、是否仍在请求官方接口。
- 404:优先检查客户端实际请求的 endpoint 是否正确,例如
/responses、/chat/completions、/v1/messages。 - 模型列表为空:检查工具选择的 provider 类型是否与协议匹配。
模型广场
这里展示星启AI当前可用的 OpenAI 与 Anthropic 模型。复制模型 ID 后可直接填入工具配置或 SDK 请求体;模型说明由后台“更新文档说明”按钮生成。
如何使用模型名
- Claude Code:写入
settings.json的model字段。 - Codex CLI:写入
~/.codex/config.toml的model = "..."。 - Cherry Studio / Kilo Code / OpenCode:在模型选择框或 provider 配置中填写。
Claude 模型
Anthropic 官方模型,代码与长文本能力出众,是 Claude Code 的默认选择。
接入协议:推荐 Anthropic 协议 · Base URL https://www.starstartai.com。OpenAI 协议也可调用,后端会做协议转换。claude-opus-4-8
Claude Opus 4.8claude-opus-4-7
Claude Opus 4.7claude-opus-4-6
Claude Opus 4.6claude-opus-4-5
Claude Opus 4.5claude-sonnet-4-6
Claude Sonnet 4.6claude-sonnet-4-5
Claude Sonnet 4.5claude-haiku-4-5
Claude Haiku 4.5OpenAI 模型
OpenAI GPT / Codex 系列,适用于 Codex CLI、Codex App 与各类支持 OpenAI 协议的工具。
接入协议:OpenAI 协议 · Base URL https://www.starstartai.com。gpt-5.5新
GPT-5.5gpt-5.4
GPT-5.4gpt-5.3-codex
GPT-5.3 Codexgpt-5.2
GPT-5.2推荐有奖
如果星启AI开放推荐奖励,可通过推荐链接或邀请码邀请新用户。实际佣金比例、结算条件和提现方式以站内展示为准。
规则说明
- 邀请关系通常由邀请码、邀请链接或系统记录绑定。
- 有效订单、佣金比例、结算周期以当前活动规则为准。
- 异常订单、退款订单或风控拦截订单通常不计入可结算佣金。
如何参与
| 方式 | 说明 |
|---|---|
| 分享邀请链接 | 将系统生成的专属邀请链接分享给需要 API 接入的用户。 |
| 分享邀请码 | 对方在相关入口填写邀请码后建立邀请关系。 |
佣金与查看
推荐数据通常包括邀请人数、有效订单、佣金比例、待结算佣金和可用佣金。若当前账号没有开放推荐功能,则以页面实际显示为准。
数据与隐私
星启AI 的数据处理原则是少存、隔离、透明。请求内容只用于完成当次模型调用,不作为公开训练数据使用。
我们处理哪些数据
| 类型 | 内容 | 用途 |
|---|---|---|
| 账户数据 | 邮箱、套餐、订单、API Key、会话状态 | 登录鉴权、计费、通知和账户管理。 |
| 调用元数据 | 时间、模型、token、耗时、状态码 | 计费、统计、风控和排障。 |
| 请求数据 | prompt、messages、参数和模型响应 | 转发给上游模型并返回给当前请求方。 |
日志保留策略
| 数据类型 | 保留策略 |
|---|---|
| 请求体 / 响应体内容 | 默认不做长期持久化;如需排障,只保留必要的错误上下文。 |
| 调用元数据 | 用于账单、统计和稳定性分析,按业务需要保留。 |
| API Key | 以受控方式存储和校验,不在页面、日志或接口中明文回显完整密钥。 |
跨境与上游
当调用海外模型或第三方模型提供方时,请求负载会被转发到对应上游完成推理。平台侧会尽量隔离账户身份与模型请求流量。
安全实践
- 不要把 API Key 提交到 GitHub、公开截图、客户端日志或前端代码。
- 为不同项目使用不同 API Key,便于禁用和审计。
- 发现密钥泄露后应立即禁用旧 Key 并创建新 Key。
常用工具配置
下面按工具类型给出完整配置。请把示例中的 sk-your-api-key 替换为你的真实 API Key。星启AI普通 OpenAI / Anthropic 客户端可统一使用根地址。
Claude Code CLI
Claude Code CLI 通过 ~/.claude/settings.json 配置自定义 API 端点。星启AI这里使用 Anthropic Messages 兼容协议,Base URL 填根地址。
安装 Node.js 与 Claude Code
node -v
npm install -g @anthropic-ai/claude-code
claude --version如 npm 网络不稳定,可先切换镜像源。
npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code配置文件位置
| Mac / Linux | ~/.claude/settings.json |
|---|---|
| Windows | C:\Users\你的用户名\.claude\settings.json |
mkdir "$env:USERPROFILE\.claude" -Force
New-Item "$env:USERPROFILE\.claude\settings.json" -Force{
"env": {
"ANTHROPIC_BASE_URL": "https://www.starstartai.com",
"ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
"API_TIMEOUT_MS": "3000000",
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
}
}指定默认模型与推理强度
{
"env": {
"ANTHROPIC_BASE_URL": "https://www.starstartai.com",
"ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
},
"model": "gpt-5.5",
"effortLevel": "medium"
}保存后在项目目录运行 claude。如之前配置过 Anthropic 官方 Key,请清掉旧配置后重新打开终端。
Claude Code 插件(VS Code / Cursor / Trae / Antigravity)
Claude Code for VS Code 插件与 Claude Code CLI 共用同一份 ~/.claude/settings.json。CLI 配好后,VS Code、Cursor、Trae、Antigravity 中的插件会自动复用。
- 打开编辑器扩展面板,搜索
Claude Code for VS Code。 - 安装 Anthropic 官方插件。
- 如果扩展市场搜索不到,可去 VS Code 官方市场下载
.vsix,再选择 Install from VSIX。 - 按上一节写入
~/.claude/settings.json。 - 在命令面板执行 Claude Code 相关命令启动插件。
Claude Code 桌面版
Claude Code for Desktop 新版本支持第三方推理端点。需要先开启 Developer Mode,再配置 Gateway。
- 下载最新版 Claude 桌面客户端:
https://claude.ai/download。 - 菜单栏进入 Help → Troubleshooting → Enable Developer Mode。
- 菜单栏进入 Developer → Configure Third-Party Inference。
- 在 Connection → Gateway 面板填写下面字段。
| Credential kind | Static API key |
|---|---|
| Gateway base URL | https://www.starstartai.com |
| Gateway API key | sk-your-api-key |
| Gateway auth scheme | bearer |
点击 Apply locally 保存后重启客户端。桌面版 Base URL 不带 /v1。
Codex CLI(Windows)
Windows 下推荐使用 Windows Terminal,并安装 Node.js 20+。可使用 ccman 一键配置,也可手动创建 .codex 配置。
node -v
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
npm i -g ccman
npm i -g @openai/codex
ccman --version
codex --versionccman gmn1启动后按提示选择 Codex / OpenCode,输入你的 sk- API Key。
codex --dangerously-bypass-approvals-and-sandbox
# 或
codex --yoloWindows 手动配置
配置目录:C:\Users\你的用户名\.codex\。创建或覆盖 config.toml 和 auth.json。
model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
sandbox_mode = "danger-full-access"
windows_wsl_setup_acknowledged = true
approval_policy = "never"
profile = "auto-max"
file_opener = "vscode"
model_provider = "codex"
web_search = "cached"
suppress_unstable_features_warning = true
[history]
persistence = "save-all"
[tui]
notifications = true
[shell_environment_policy]
inherit = "all"
ignore_default_excludes = false
[sandbox_workspace_write]
network_access = true
[features]
plan_tool = true
apply_patch_freeform = true
view_image_tool = true
unified_exec = false
streamable_shell = false
rmcp_client = true
elevated_windows_sandbox = true
[profiles.auto-max]
approval_policy = "never"
sandbox_mode = "workspace-write"
[profiles.review]
approval_policy = "on-request"
sandbox_mode = "workspace-write"
[notice]
hide_gpt5_1_migration_prompt = true
[model_providers.codex]
name = "codex"
base_url = "https://www.starstartai.com"
wire_api = "responses"
requires_openai_auth = true{
"OPENAI_API_KEY": "sk-your-api-key"
}Codex CLI(Mac / Linux)
Mac / Linux 与 Windows 类似,区别是配置目录为 ~/.codex/。
node --version
npm i -g ccman
npm i -g @openai/codex
ccman gmn1
codex --yolo如需手动配置,创建 ~/.codex/config.toml 和 ~/.codex/auth.json,内容可复用 Windows 手动配置,只需路径不同。
Codex CLI(服务器 / WSL2 / SSH)
服务器环境推荐用 Volta 管理 Node.js 和全局 npm 工具。
curl https://get.volta.sh | bash
# 重新打开终端后执行
volta install node@20
volta install ccman
volta install @openai/codex
ccman gmn1
codex --yoloCodex 插件(VS Code / Cursor / Trae)
Codex 插件读取本机 .codex 配置。若之前使用过 OpenAI 官方或其它平台账号,请先退出对应账号,再覆盖配置。
| Mac / Linux | ~/.codex/ |
|---|---|
| Windows | C:\Users\你的用户名\.codex\ |
model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000
[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://www.starstartai.com"
wire_api = "responses"
requires_openai_auth = true{
"OPENAI_API_KEY": "sk-your-api-key"
}- 打开 VS Code / Cursor / Trae。
- 进入扩展面板,搜索并安装 OpenAI 官方 Codex 插件。
- 重启编辑器,让插件重新读取
.codex配置。
Codex App 桌面版
Codex App 桌面客户端也读取 .codex 目录下的 config.toml 和 auth.json。如果之前使用过官方账号,请先退出对应账号后再覆盖配置。
第一步:创建配置目录
| Mac / Linux | ~/.codex/ |
|---|---|
| Windows | C:\Users\你的用户名\.codex\ |
第二步:写入 auth.json
{
"OPENAI_API_KEY": "sk-your-api-key"
}第三步:写入 config.toml
配置内容可复用 Codex CLI Windows 手动配置,核心字段是 model_provider、base_url 和 wire_api。
model = "gpt-5.5"
model_provider = "codex"
[model_providers.codex]
name = "codex"
base_url = "https://www.starstartai.com"
wire_api = "responses"
requires_openai_auth = trueOpenCode
OpenCode 安装请参考官方文档:https://opencode.ai/docs/。安装后编辑 ~/.config/opencode/opencode.json。
协议选择
| 协议 | provider / npm | baseURL | 适用场景 |
|---|---|---|---|
| OpenAI | 内置 openai | https://www.starstartai.com | GPT、Codex、大多数 OpenAI-compatible 模型。 |
| Anthropic | @ai-sdk/anthropic | https://www.starstartai.com | Claude 原生协议或声明 Anthropic 兼容的模型。 |
baseURL 使用根地址即可。{
"$schema": "https://opencode.ai/config.json",
"provider": {
"openai": {
"options": {
"baseURL": "https://www.starstartai.com"
},
"models": {
"gpt-5.5": { "name": "GPT-5.5" },
"gpt-5.3-codex": { "name": "GPT-5.3 Codex" }
}
}
}
}"gpt-5.5": {
"name": "GPT-5.5",
"limit": { "context": 1050000, "output": 128000 },
"options": { "store": false },
"variants": { "low": {}, "medium": {}, "high": {}, "xhigh": {} }
}{
"$schema": "https://opencode.ai/config.json",
"provider": {
"starstart": {
"npm": "@ai-sdk/anthropic",
"name": "starstart",
"options": {
"baseURL": "https://www.starstartai.com"
},
"models": {
"gpt-5.5": { "name": "GPT-5.5" }
}
}
}
}配置密钥
opencode auth login
opencode auth list
opencode auth logout <provider-name>也可以编辑 ~/.local/share/opencode/auth.json,供应商名称必须与 opencode.json 中完全一致。
{
"openai": {
"type": "api",
"key": "sk-your-api-key"
}
}opencode run --model openai/gpt-5.5 "你好"小技巧
在 OpenCode 中按 Ctrl + T 可以切换不同的推理强度(variants)。如果某个模型需要暴露推理强度,请在模型配置里补充 variants 字段。
Cherry Studio
Cherry Studio 支持多模型桌面使用。星启AI可按模型类型选择 Anthropic 或 OpenAI-Response。
Anthropic 协议
| 提供商类型 | Anthropic |
|---|---|
| API Key | sk-your-api-key |
| API Host | https://www.starstartai.com |
OpenAI-Response 协议
| 提供商类型 | OpenAI-Response,不是普通 OpenAI |
|---|---|
| API Key | sk-your-api-key |
| API Host | https://www.starstartai.com |
点击 Fetch model list 获取模型列表,然后在对话界面选择模型使用。
IDEA Kilo Code
在 IntelliJ IDEA 中进入 Settings → Plugins → Marketplace,搜索并安装 Kilo Code,重启 IDEA 后配置。
Claude 模型
| API Provider | Anthropic |
|---|---|
| Anthropic API Key | sk-your-api-key |
| Use custom base URL | 勾选 |
| Base URL | https://www.starstartai.com |
| Model | 例如 gpt-5.5 |
OpenAI 模型
| API Provider | OpenAI Compatible (Responses) |
|---|---|
| Base URL | https://www.starstartai.com |
| API Key | sk-your-api-key |
| Model | 例如 gpt-5.5 |
/v1 路径。Obsidian
Obsidian 可通过 Claudian 或 Copilot 插件调用星启AI,用于知识库问答、写作、整理和 Agent 操作。
准备工作:开启社区插件
- 打开 Obsidian 设置,进入 Community plugins,启用社区插件。
- 在 Browse 中搜索并安装 Claudian 或 Copilot。
| Claudian | 适合已在用 Claude Code,想把整个 vault 作为 Agent 工作目录。 |
|---|---|
| Copilot | 适合轻量对话和知识库问答,无需命令行 Agent。 |
Claudian 插件
Claudian 底层调用 Claude Code CLI,建议先按 Claude Code CLI 一节配置好 ~/.claude/settings.json。
{
"env": {
"ANTHROPIC_BASE_URL": "https://www.starstartai.com",
"ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
}
}Copilot 插件
Copilot 直连 API 时,Provider 选择 OpenAI Compatible 或 Anthropic,按插件要求填写 API Key 和 Base URL。
| OpenAI Compatible | https://www.starstartai.com |
|---|---|
| Anthropic | https://www.starstartai.com |
| API Key | sk-your-api-key |
Hermes Agent
Hermes Agent 使用 OpenAI-compatible 配置,星启AI可填写根地址作为 Base URL。
mkdir -p ~/.hermes
cat > ~/.hermes/config.yaml << 'EOF'
providers:
starstart:
name: starstart
base_url: https://www.starstartai.com
api_key: sk-your-api-key
model: gpt-5.5
model:
provider: starstart
model: gpt-5.5
EOFhermes config edithermes chat -q '你好,请用一句话回复' -Qbase_url 是否写成星启AI根地址,以及客户端实际请求 endpoint 是否正确。常见问题
这里整理星启AI API 接入过程中最常见的错误类型和处理方式。
问题 1:断流或超时
错误通常表现为 stream disconnected、timeout、error sending request 等。优先检查本地网络、系统代理、VPN、公司网关或 Wi-Fi 切换。
- 关闭会频繁切换出口 IP 的代理后重试。
- 流式请求建议提高客户端超时时间,例如
API_TIMEOUT_MS=3000000。 - 如果只在某个模型上复现,切换同类模型确认是否为上游波动。
问题 2:429 Too Many Requests
通常表示额度、频率或上游账号池达到限制。先降低并发,稍后重试;如果是额度耗尽,应切换可用分组或补充额度。
问题 3:401 密钥不正确
常见原因是请求仍然走官方接口、API Key 多复制了空格、配置文件没有被客户端重新加载。
- 确认 Base URL 已改为星启AI地址。
- 确认 Header 使用
Authorization: Bearer sk-your-api-key或x-api-key。 - 重启 CLI、IDE 或桌面客户端。
问题 4:脚本禁止运行(Windows)
PowerShell 提示禁止运行脚本时,执行:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser问题 5:Node.js 未找到
Codex CLI、Claude Code、ccman 等工具依赖 Node.js。执行 node -v 验证安装,版本过低时建议安装 Node.js 20+。
问题 6:环境变量覆盖密钥
如果系统里残留官方或其他平台环境变量,可能覆盖配置文件。
ANTHROPIC_AUTH_TOKEN
ANTHROPIC_BASE_URL
ANTHROPIC_MODEL
OPENAI_API_KEY
OPENAI_BASE_URL协议填错怎么判断?
- Anthropic 协议:Base URL 用
https://www.starstartai.com。 - OpenAI 协议:Base URL 通常也用
https://www.starstartai.com。 - 如果某个客户端强制按 OpenAI 官方风格拼接,星启AI也兼容
/v1路径。