返回首页 TOP API DOCS 开 发 文 档
进入控制台
文档 / 一键配置
TOP API DOCUMENTATION

⚡ 一键配置（推荐）

一条命令搞定：脚本会自动检测环境、写好 Base URL 和密钥、并启动客户端。Claude Code 和 Codex CLI 各有一键脚本，按你用的工具复制对应命令即可。

⚡ 控制台一键导入到 CC Switch

在 Top API 控制台的「API 密钥」列表里，找到要用于 Codex 的密钥，点击「导入到 CCS」。浏览器会弹出打开 CC Switch 的确认框，点「打开」后在 CC Switch 里确认并导入即可。

  1. 进入控制台「API 密钥」页面，找到目标密钥，点击操作区的 导入到 CCS。
  2. 浏览器提示「此站点正在尝试打开 CC Switch」时，点击 打开。
  3. 在 CC Switch 的导入确认窗口检查供应商、API 端点、密钥和模型，确认无误后点击 导入。
在 Top API 控制台点击导入到 CCS
1. 控制台点击「导入到 CCS」
浏览器确认打开 CC Switch
2. 浏览器允许打开 CC Switch
CC Switch 确认导入供应商配置
3. CC Switch 确认后一键导入

如果没有弹出 CC Switch，请先确认已安装 CC Switch，并允许浏览器打开关联应用。不会操作也没关系，微信 gtsj-001 可以协助远程配置。

⚡ Claude Code 一键接入

复制下面对应系统的命令，粘贴到终端运行，按提示输入 API Key 即可。

Windows (PowerShell)
irm https://top-api.cc/install.ps1 | iex

CMD 用户请先输入 powershell 进入 PowerShell 再执行。

macOS / Linux
curl -fsSL https://top-api.cc/install.sh | bash

脚本会引导你输入 API Key，自动写好 ~/.claude/settings.json 并启动 Claude Code，全程无需手改文件。

⚡ Codex CLI 一键接入

使用 OpenAI Codex CLI？复制下面对应系统的命令一键配置。

Windows (PowerShell)
irm https://top-api.cc/install-codex.ps1 | iex

CMD 用户请先输入 powershell 进入 PowerShell 再执行。

macOS / Linux
curl -fsSL https://top-api.cc/install-codex.sh | bash

脚本会写好 ~/.codex/config.toml（base_url 指向 Top API、wire_api=responses），按提示填入 sk- 密钥即可。

配置过程中遇到任何问题，都可以加客服微信 gtsj-001，我们可以帮你检查 Base URL、API Key、模型和客户端配置。

脚本做了什么

  • 检测 Node.js 等前置环境，缺什么提示你装什么。
  • Claude Code：把 ANTHROPIC_BASE_URL=https://top-api.cc 和密钥写进 ~/.claude/settings.json。
  • Codex：把 provider 的 base_url=https://top-api.cc、wire_api=responses 写进 ~/.codex/config.toml。
  • 已有配置会自动备份，配置完成后可直接使用。

更喜欢手动配置？

不想跑脚本，想自己一步步来，看对应页面：

手动 / 快速开始Claude Code 配置Codex CLI 配置
运行脚本前请确认网络能访问 https://top-api.cc。若脚本卡住或报错，可改用手动配置，或加客服微信 gtsj-001。
需要帮助？客服微信 gtsj-001 · 文档首页