从注册到第一次对话，
跟着做就好。

Codex：安装 → 保存配置 → 验证

CLI 用户先完成上方 Node.js 检查，再运行下方安装命令；只使用 IDE 扩展可跳到本节末尾的“在 VS Code 中使用”，再按②③保存用户配置。CLI 和 IDE 不必同时安装。

npm.cmd install -g @openai/codex@latest --registry=https://registry.npmmirror.com --include=optional
codex.cmd --version

npm install -g @openai/codex@latest --registry=https://registry.npmmirror.com --include=optional
codex --version

① 打开用户配置目录

macOS/Linux 使用 nano 时：粘贴对应内容，按 Ctrl+O、回车保存，再按 Ctrl+X 退出；退出后再执行下一行命令。文件内容不要粘贴到 shell 提示符。

Windows：%USERPROFILE%\.codex；macOS/Linux：~/.codex/。已有 config.toml 或 auth.json 请先备份，合并配置前确认是否还需保留原有官方登录；CLI与IDE可能共用登录文件。

New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex" | Out-Null
notepad "$env:USERPROFILE\.codex\config.toml"
notepad "$env:USERPROFILE\.codex\auth.json"

mkdir -p ~/.codex
nano ~/.codex/config.toml
nano ~/.codex/auth.json
chmod 700 ~/.codex
chmod 600 ~/.codex/config.toml ~/.codex/auth.json

② 保存 config.toml

model = "gpt-6.1-sol"
model_provider = "gateway"
cli_auth_credentials_store = "file"

[model_providers.gateway]
name = "Gateway"
base_url = "https://api.skyai.icu/v1"
wire_api = "responses"
requires_openai_auth = true

将模型替换为本站该分组实际开放的 ID。顶部字段放在第一个方括号段落之前；已有同名段落只修改一次。此文件认证方案不再设置 env_key，也不要混入旧平台的 bearer token 或认证 helper。地址到 /v1 为止，不追加 /responses。

③ 保存 auth.json

将 YOUR_API_KEY 替换为本站 OpenAI 分组的完整密钥。OPENAI_API_KEY 是 Codex 规定的字段名，这里填本站密钥；不需要购买官方订阅。

{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

用记事本保存时将“保存类型”设为“所有文件”，文件名保持 auth.json，编码选 UTF-8；config.toml 同理，不要多出 .txt 后缀。密钥文件不要上传 Git、网盘分享或发给客服。若使用自定义 CODEX_HOME，配置和密钥应放在那个目录；不要同时维护两套不一致的文件。

④ 重启客户端并验证

codex.cmd

codex

进入后用 /status核对模型/provider；发一句“你好”，得到正常回复后，到使用记录核对调用。状态页只能确认配置，真实回复和用量记录才说明请求成功。以后Windows新开终端运行codex.cmd，macOS/Linux运行codex，无需重复设置临时变量。

Claude Code：用 npm 安装，把密钥保存到配置文件

CLI 与 IDE 扩展任选其一即可。喜欢终端用CLI；喜欢编辑器内对话用IDE扩展。CLI采用国内npm源；扩展从编辑器官方扩展市场安装，不要从不明网盘下载。

方式 A：CLI 安装 / 更新

npm.cmd install -g @anthropic-ai/claude-code@latest --registry=https://registry.npmmirror.com --include=optional
claude.cmd --version

npm install -g @anthropic-ai/claude-code@latest --registry=https://registry.npmmirror.com --include=optional
claude --version

安装完成后重开终端。npm方式更新时仍运行上面的安装命令。Windows建议安装Git for Windows以使用Bash工具；新版本也可使用PowerShell工具，若提示找不到Bash，再按官方说明补齐Git。已有原生/WinGet版本时先检查实际claude路径，避免混用多份安装。

方式 B：IDE 扩展安装

在 VS Code 扩展市场安装Claude Code for VS Code，核对发布者为 Anthropic 后安装。兼容编辑器需先确认其版本支持该官方扩展。扩展有自己的CLI运行环境，安装扩展不代表终端里已有claude命令，也不要求再装CLI。

CLI 配置：只需保存一次 settings.json

使用 nano 时逐行操作：粘贴 JSON → Ctrl+O、回车保存 → Ctrl+X 退出，再执行 chmod。Windows 保存选择“所有文件”和 UTF-8，文件名为 settings.json，不加 .txt。

macOS/Linux：~/.claude/settings.json；Windows：%USERPROFILE%\.claude\settings.json，通常是 C:\Users\你的用户名\.claude\settings.json。先备份已有文件，只合并下方env字段；密钥放用户级文件，不放项目的.claude/settings.json。

New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude" | Out-Null
notepad "$env:USERPROFILE\.claude\settings.json"

mkdir -p ~/.claude
nano ~/.claude/settings.json
chmod 700 ~/.claude
chmod 600 ~/.claude/settings.json

将 YOUR_API_KEY 替换为本站 Anthropic 分组密钥。BASE_URL必须为本站域名根路径，不加 /v1。env中的两项负责连接；示例同时指定本分组支持的模型，保存后一直生效：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.skyai.icu"
  },
  "model": "claude-sonnet-5-5"
}

如果已配置其他平台的ANTHROPIC_API_KEY、apiKeyHelper、Bedrock/Vertex开关或自定义CLAUDE_CONFIG_DIR，先核对冲突项。模型可在启动后用/model选择；不支持默认模型时，将顶层model字段设为该分组实际开放的完整ID，例如 claude-sonnet-5-5。不要照搬其他站点的AWS/CodeX分组名，分组以本站控制台为准。

IDE 配置：保存到 VS Code“用户设置 JSON”

如果选择IDE扩展，按 Ctrl+Shift+P（Mac用⌘⇧P）搜索 Preferences: Open User Settings (JSON)，在现有JSON中合并下列字段。这里是编辑器的用户设置，不是.claude/settings.json，也不是项目的.vscode/settings.json。扩展启动前会检查这里的认证信息；只改CLI文件有时仍会提示登录。

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.skyai.icu" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "YOUR_API_KEY" },
    { "name": "ANTHROPIC_MODEL", "value": "claude-sonnet-5-5" }
  ]
}

保存后完整重启编辑器。必要时在设置搜索“Claude Code login”，启用Disable Login Prompt；此选项只隐藏登录提示，不能替代正确的网关地址与密钥。含密钥的用户设置不要同步到不受控账户，也不要共享截图。

使用与验证

CLI在自己的项目目录运行（Windows用claude.cmd，macOS/Linux用claude）：

claude.cmd

claude

CLI用 /status核对Anthropic base URL为https://api.skyai.icu；IDE面板打开新对话核对配置。然后发一句“你好”，正常回复后去使用记录确认请求。调用会消耗额度。重启后配置仍保留，不需要每次输入export或$env命令。

CC Switch：不用反复改文件，切换你的编程工具配置

CC Switch 是第三方开源配置管理工具，帮助你给 Claude Code、Codex 等工具保存和切换服务商。它不是聊天客户端，也不提供本站额度；需要配合已安装的编程工具使用。下面按官方 v4.0.15 界面说明，旧版按钮名称可能不同。

1. 安装并准备两把对应的密钥

1. 从官方下载安装页或官方 GitHub Releases下载。Windows 选择匹配 x64 / ARM64 的 MSI 或便携 ZIP；macOS 选择 DMG；Linux 按发行版与架构选择官方安装包。大陆网络访问 GitHub 不畅时先试官网入口，不从不明网盘下载。
2. 先按本指南的 Claude Code 或 Codex步骤安装对应工具；终端确认版本可用，再重新打开 CC Switch。国内用户可沿用前面的 npm 镜像安装方式。
3. 在API 密钥分别创建 Anthropic 分组密钥和 OpenAI 分组密钥，命名如“CC Switch · Claude”“CC Switch · Codex”。只用其中一个工具，就只创建对应的一把。先备份本机已有配置；不要覆盖正在运行的任务。

2. 使用 Claude？配置这一项

1. 在 CC Switch 选择 Claude Code应用，选择直连，点击添加供应商（＋）→ 自定义配置。
2. 名称填“天空AI · Claude”，API 地址填 https://api.skyai.icu，API Key 填本站 Anthropic 分组的完整密钥。接口格式选择 Anthropic Messages（原生）。不要填 /v1、/messages或控制台网页地址。
3. 模型选择该密钥当前允许的完整 ID，例如 claude-sonnet-5-5。如果使用 JSON 编辑器，可合并下面字段，将占位符替换为自己的密钥；已有配置只合并相关字段，认证方式保留一种。

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_ANTHROPIC_GROUP_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.skyai.icu",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5"
  }
}

保存后，在该供应商卡片点击启用 / 切换。重启 Claude Code，在 /status核对地址；只保存卡片而未启用，不会切换当前工具。

3. 使用 Codex？配置这一项

1. 切换到 Codex应用 → 直连 → 添加供应商（＋）→ 自定义配置，名称填“天空AI · Codex”。
2. API 地址填 https://api.skyai.icu/v1；密钥使用本站 OpenAI 分组的完整值。上游格式选 Responses（原生），模型填该密钥可用的完整 ID，例如 gpt-6.1-sol。
3. 若界面展示两个配置编辑框，在 auth.json 区域填下面的密钥 JSON；在 config.toml 区域合并下方 TOML。它们是 CC Switch 的供应商编辑内容，由工具负责写入客户端，不要把两段混成一个文件。

{
  "OPENAI_API_KEY": "YOUR_OPENAI_GROUP_API_KEY"
}

model_provider = "custom"
model = "gpt-6.1-sol"

[model_providers.custom]
name = "天空AI"
base_url = "https://api.skyai.icu/v1"
wire_api = "responses"
requires_openai_auth = true

4. 发出第一条请求，确认切换成功

在目标工具里新建会话，发送一句“你好”，再去使用记录核对模型、时间与扣费。正常调用、速度测试和部分连接测试可能消耗额度，不要反复批量测试。配置卡片保存成功不等于模型调用成功。

密钥会保存在本机配置中。导出备份、截图或云同步前检查是否包含密钥，不上传到 Git 或公开群。无需开启绕过权限或关闭客户端的安全确认。

参考：官方供应商配置说明 · 官方配置文件说明。后续版本以实际界面为准。

Cherry Studio、Cline 与兼容客户端

任选一个客户端即可，不必全部安装。先选“自定义服务商 / OpenAI 兼容”，再填写下面三项。

Cherry Studio · 日常聊天

1. 从官方网站安装，进入“设置 → 模型服务”，新增 OpenAI 类型的自定义服务商，名称填“天空 AI”。
2. 填写上表地址与密钥，获取或添加允许的模型，打开服务商开关。
3. 新建助手/对话，选择刚添加的模型，发送一句“你好，请简单介绍你自己”。有正常回复后，在本站使用记录核对第一笔请求与扣费。

Cline · VS Code 编程

1. 从Cline 官方安装指南安装扩展，打开设置，API Provider 选择 OpenAI Compatible。
2. 填入上表的 Base URL、密钥与模型 ID；如果 Plan 和 Act 分别配置，两边都要核对。
3. 先用解释项目的小任务测试，再授予你需要的文件/命令权限；在本站“使用记录”核对请求。Plan / Act 的模型必须是当前分组支持工具调用的型号。