星启AI
接入文档

Claude Code CLI

Claude Code CLI 通过 ~/.claude/settings.json 或进程环境变量配置自定义 API 端点。星启AI这里使用 Anthropic Messages 兼容协议，ANTHROPIC_BASE_URL 填网关根地址，Claude Code 会继续请求 /v1/messages。

安装 Node.js 与 Claude Code

node -v
npm install -g @anthropic-ai/claude-code
claude --version

当前 Claude Code 官方也提供 Native Installer、Homebrew 和 WinGet。npm 方式仍可使用，但请按当前 Claude Code 版本要求准备 Node.js；不同安装方式的升级命令可能不同。

如 npm 网络不稳定，可先切换镜像源。

npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code

配置文件位置

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",
    "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。先执行 claude --version，进入会话后运行 /status，确认实际 Base URL、认证来源和模型，再发送一条短消息验证链路。如之前配置过 Anthropic 官方 Key，请清掉旧配置、环境变量和登录状态后重新打开终端。

Claude Code 插件（VS Code / Cursor / Trae / Antigravity）

Claude Code for VS Code 插件可以读取 Claude Code 的 ~/.claude/settings.json，但不同编辑器和插件版本的环境继承方式可能不同。第三方 Gateway 场景还应检查 VS Code 用户设置中的 claudeCode.environmentVariables，不要假设从桌面图标启动的编辑器一定继承终端变量。

1. 打开编辑器扩展面板，搜索 Claude Code for VS Code。
2. 安装 Anthropic 官方插件。
3. 如果扩展市场搜索不到，可去 VS Code 官方市场下载 .vsix，再选择 Install from VSIX。
4. 按上一节写入 ~/.claude/settings.json。
5. 在命令面板执行 Claude Code 相关命令启动插件。

Claude Code 桌面版

Claude Code for Desktop 新版本支持第三方推理端点。需要先开启 Developer Mode，选择第三方 Inference provider 中的 Gateway，再配置 Gateway。

1. 下载最新版 Claude 桌面客户端：https://claude.ai/download。
2. 菜单栏进入 Help → Troubleshooting → Enable Developer Mode。
3. 菜单栏进入 Developer → Configure Third-Party Inference。
4. 在 Inference provider 中选择 Gateway，再进入 Connection → Gateway 面板填写下面字段。

Codex CLI（Windows）

Windows 下推荐使用 Windows Terminal，并安装当前 Codex CLI 要求的 Node.js 版本。可使用 ccman 一键配置，也可手动创建 .codex 配置。Codex 的 ChatGPT 账号登录和 API Key 登录是两种不同认证方式；本节使用星启AI API Key，不需要登录官方账号。

node -v
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
npm i -g ccman
npm i -g @openai/codex
ccman --version
codex --version

ccman gmn1

启动后按提示选择 Codex / OpenCode，输入你的 sk- API Key。ccman 生成的内容仍建议对照下面的 base_url、wire_api 和认证文件检查一遍，避免工具升级后复用了旧 provider。

codex --dangerously-bypass-approvals-and-sandbox
# 或
codex --yolo

Windows 手动配置

配置目录：C:\Users\你的用户名\.codex\。创建或覆盖 config.toml 和 auth.json。

# 当前使用的模型 ID，必须与模型广场中的复制值一致
model = "gpt-5.5"
# 使用 Responses API；不要与 Chat Completions 配置混用
model_reasoning_effort = "xhigh"
# 日常使用建议保留沙箱和人工确认
sandbox_mode = "workspace-write"
approval_policy = "on-request"
model_provider = "codex"

[model_providers.codex]
name = "codex"
# Codex 会在这个地址后请求 Responses endpoint
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/。本节仍使用 Responses API 和 auth.json 中的 OPENAI_API_KEY，不是 ChatGPT 订阅登录。

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 工具。服务器、WSL2 和 SSH 会话各自有独立的 HOME、环境变量和 .codex 目录，请在实际运行 Codex 的用户下配置，并避免把 auth.json 放进镜像或日志。

curl https://get.volta.sh | bash
# 重新打开终端后执行
volta install node@20
volta install ccman
volta install @openai/codex
ccman gmn1
codex --yolo

Codex 插件（VS Code / Cursor / Trae）

Codex 插件读取本机 .codex 配置。若之前使用过 OpenAI 官方或其它平台账号，请先退出对应账号，再覆盖配置。插件和集成终端可能不是同一个进程环境，修改后应重启编辑器。

# provider 名称必须与下方 [model_providers.OpenAI] 一致
model_provider = "OpenAI"
# Responses 模型和模型 ID 以模型广场为准
model = "gpt-5.5"
model_reasoning_effort = "xhigh"
sandbox_mode = "workspace-write"
approval_policy = "on-request"

[model_providers.OpenAI]
name = "OpenAI"
# Codex 会继续请求 Responses endpoint
base_url = "https://www.starstartai.com"
wire_api = "responses"
requires_openai_auth = true

{
  "OPENAI_API_KEY": "sk-your-api-key"
}

1. 打开 VS Code / Cursor / Trae。
2. 进入扩展面板，搜索并安装 OpenAI 官方 Codex 插件。
3. 重启编辑器，让插件重新读取 .codex 配置。

Codex App 桌面版

Codex App 桌面客户端也读取 .codex 目录下的 config.toml 和 auth.json。如果之前使用过官方 ChatGPT 账号，请先退出对应账号后再覆盖配置；官方账号登录不会自动变成星启AI API Key。

第一步：创建配置目录

第二步：写入 auth.json

{
  "OPENAI_API_KEY": "sk-your-api-key"
}

第三步：写入 config.toml

配置内容可复用 Codex CLI Windows 手动配置，核心字段是 model_provider、base_url 和 wire_api。保存后完全退出 Codex App 再重新打开，让桌面版重新读取文件。

model = "gpt-5.5"
model_provider = "codex"

[model_providers.codex]
name = "codex"
base_url = "https://www.starstartai.com"
wire_api = "responses"
requires_openai_auth = true

OpenCode

OpenCode 是终端 Agent 与编程工作流工具。安装请参考官方文档：https://opencode.ai/docs/。本文示例按 OpenCode 1.18.x 的配置结构整理；OpenCode 更新较快，命令或字段发生变化时，请先用 opencode --help 和官方文档核对。

安装与版本检查

# 安装 OpenCode CLI
npm install -g opencode-ai

# 检查 CLI 是否已加入 PATH
opencode --version
opencode --help

配置文件位置

协议与 provider 选择

OpenAI-compatible Chat Completions 配置

这是通用 OpenAI-compatible 配置。这里使用自定义 provider ID xingqi-chat，模型选择时也要使用完整名称 xingqi-chat/模型ID。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "xingqi-chat": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "星启AI OpenAI Compatible",
      "options": {
        // apiKey 与 baseURL 同级，都放在 options 内
        "apiKey": "sk-your-api-key",
        "baseURL": "https://www.starstartai.com"
      },
      "models": {
        // 模型 ID 必须与星启AI模型广场中的复制值一致
        "gpt-5.6-sol": { "name": "GPT-5.6 Sol" },
        "gpt-5.5": { "name": "GPT-5.5" },
        "gpt-5.3-codex": { "name": "GPT-5.3 Codex" }
      }
    }
  },
  // 可选：指定启动后的默认模型
  "model": "xingqi-chat/gpt-5.6-sol"
}

API Key 的推荐写法

上面的直接写法适合本机临时测试。长期使用建议引用环境变量，避免 Key 进入项目文件、Git 提交和截图。将 apiKey 的值替换为下面的引用即可：

"options": {
  // OpenCode 启动时从环境变量读取，不把真实 Key 写入配置
  "apiKey": "{env:XINGQI_API_KEY}",
  "baseURL": "https://www.starstartai.com"
}

# PowerShell：只对当前终端窗口生效
$env:XINGQI_API_KEY = "sk-your-api-key"

# macOS / Linux：只对当前终端会话生效
export XINGQI_API_KEY="sk-your-api-key"

OpenAI Responses 配置

如果你的工作流明确要求 Responses API，使用 @ai-sdk/openai，不要用 Chat Completions 的 @ai-sdk/openai-compatible 适配器。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "xingqi-responses": {
      "npm": "@ai-sdk/openai",
      "name": "星启AI Responses",
      "options": {
        // baseURL 与 apiKey 同级
        "baseURL": "https://www.starstartai.com",
        "apiKey": "{env:XINGQI_API_KEY}"
      },
      "models": {
        "gpt-5.6-sol": { "name": "GPT-5.6 Sol" },
        "gpt-5.5": { "name": "GPT-5.5" }
      }
    }
  },
  "model": "xingqi-responses/gpt-5.6-sol"
}

Anthropic Messages 配置

调用 Claude 或模型广场中标注为 Anthropic Messages 的模型时，使用 Anthropic provider。Key 仍然是星启AI API Key，不能填写 Anthropic 官方账号密码或订阅信息。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "xingqi-anthropic": {
      "npm": "@ai-sdk/anthropic",
      "name": "星启AI Anthropic",
      "options": {
        "baseURL": "https://www.starstartai.com",
        "apiKey": "{env:XINGQI_API_KEY}"
      },
      "models": {
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" },
        "claude-opus-5": { "name": "Claude Opus 5" }
      }
    }
  },
  "model": "xingqi-anthropic/claude-sonnet-4-6"
}

模型配置与 variants

models 中的键是实际模型 ID，name 只是界面显示名。只有模型广场中的模型 ID 才能保证路由匹配。需要在 OpenCode 中切换推理强度时，可以在模型项内声明 variants：

"gpt-5.6-sol": {
  "name": "GPT-5.6 Sol",
  "limit": { "context": 1050000, "output": 128000 },
  "options": { "store": false },
  "variants": {
    "low": {},
    "medium": {},
    "high": {},
    "xhigh": {}
  }
}

在 TUI 中可以按 Ctrl + T 切换已声明的 variants。若上游模型不接受某个推理参数，请删除对应 variant，避免客户端发送不兼容选项。

配置密钥：命令行方式

OpenCode 的认证命令会把凭证保存到本机凭证存储，不会把完整 Key 显示在列表中。对于自定义 provider，请在交互流程中选择 Other，再输入与配置文件完全一致的 provider ID；只执行命令并不会自动创建 provider 配置。

# 登录或更新某个供应商的 API Key
opencode auth login

# 查看当前已保存的供应商和认证类型，不显示完整 Key
opencode auth list

# 删除指定供应商保存的 Key
opencode auth logout <供应商名称或 provider ID>

验证配置

# provider/model，斜杠前是 opencode.json 中的 provider ID
opencode run --model xingqi-chat/gpt-5.6-sol "请用一句话回复：星启AI连接成功"

# 也可以先查看该 provider 暴露的模型
opencode models xingqi-chat

OpenCode 常见问题

• 401：检查 apiKey 是否位于 provider.<id>.options 内，环境变量是否已在启动 OpenCode 的同一个终端中设置。
• 404：检查 npm 适配器与协议是否匹配；Chat Completions 使用 @ai-sdk/openai-compatible，Responses 使用 @ai-sdk/openai。
• 模型不存在：检查 models 中的键和 --model provider/model 中的模型 ID 是否与模型广场完全一致。
• 修改不生效：退出并重新启动 OpenCode，确认没有项目级 opencode.json 或 OPENCODE_CONFIG_CONTENT 覆盖全局配置。
• Key 泄露：立即在星启AI控制台禁用或删除对应 API Key，再创建新的 Key；不要只修改本地配置。

Cherry Studio

Cherry Studio 支持多模型桌面使用。星启AI可按模型类型选择 Anthropic 或 OpenAI-Response。这里的提供商类型决定最终请求协议，不能只修改 API Host 就把普通 OpenAI、OpenAI-Response 和 Anthropic 三种模式混用。

Anthropic 协议

OpenAI-Response 协议

1. 选择对应的提供商类型，填写 API Key 和 API Host。
2. 打开该 Provider 的启用开关，否则模型可能不会出现在选择列表中。
3. 点击 Fetch model list 获取模型列表，然后在对话界面选择模型使用。

若拉取失败，可先手动填写模型 ID；确认 API Host 没有重复追加 /v1，并检查 Cherry Studio 当前版本实际选择的是 Responses 还是 Chat Completions。

IDEA Kilo Code

在 IntelliJ IDEA 中进入 Settings → Plugins → Marketplace，搜索并安装 Kilo Code，重启 IDEA 后配置。Kilo Code 的选项名称会随插件版本变化，以下按协议类型说明字段含义。

Claude 模型

OpenAI 模型

Obsidian

Obsidian 可通过 Claudian 或 Copilot 插件调用星启AI，用于知识库问答、写作、整理和 Agent 操作。Claudian 通常复用 Claude Code CLI；Copilot 则是插件自己的 BYOK 配置，两者的 Key、协议和配置位置不要混淆。

准备工作：开启社区插件

1. 打开 Obsidian 设置，进入 Community plugins，启用社区插件。
2. 在 Browse 中搜索并安装 Claudian 或 Copilot。

Claudian 插件

Claudian 底层调用 Claude Code CLI，建议先按 Claude Code CLI 一节配置好 ~/.claude/settings.json，并确认 Obsidian 启动进程能够找到 claude 命令。桌面应用不一定继承你在终端中临时设置的环境变量。

{
  "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 通常走 Bearer；Anthropic 通常走 x-api-key，请按插件字段填写，不要把 Claude Code 的 ANTHROPIC_AUTH_TOKEN 直接当成 Copilot 配置项。

Hermes Agent

Hermes Agent 使用 OpenAI-compatible Chat Completions 配置，星启AI可填写根地址作为 Base URL。Hermes 的自定义 provider 不是 Codex 的 Responses 配置，不能照搬 wire_api = "responses"。

下面的批量创建命令适用于 Bash、WSL2、macOS 和 Linux。Windows 原生 PowerShell 请使用 hermes config edit，在编辑器中写入同样的 YAML，不要直接执行下面的 mkdir -p 和 heredoc。

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
EOF

hermes config edit

hermes chat -q '你好，请用一句话回复' -Q