快速开始
1. 登录账户
打开 ModelPort 登录。首次使用前,请在控制台确认余额、账户状态和需要使用的模型分组均正常。
:::
:::
2. 创建 API 密钥
进入 API 密钥,选择创建密钥。建议为不同设备或客户端分别创建密钥,例如“工作电脑 Codex”和“服务器 Claude Code”,便于排查用量和单独撤销。
创建时至少完成以下设置:
- 填写容易识别的名称。
- 分配需要使用的模型分组。
- 按需设置额度、有效期和 IP 限制。
- 创建后立即将密钥保存在安全位置。
:::
:::
3. 获取客户端配置
在密钥列表中找到刚创建的密钥,打开“使用配置”,然后选择目标客户端。ModelPort 会根据密钥所绑定的分组生成对应的地址、模型和认证配置。
不要直接套用其他分组的配置。即使客户端相同,不同上游协议需要的路径和模型参数也可能不同。
如果本机已安装 CC-Switch,可以直接点击密钥右侧的“导入 CC-Switch”,无需手动复制 Base URL 和 API 密钥。详见 CC-Switch 一键导入。
不使用 CC-Switch 时,Codex 用户可以把页面生成的 config.toml 和 auth.json 分别保存到 .codex 配置目录。完整操作见 手动导入 Codex 双文件。
:::
:::
4. 启动客户端
按照“使用配置”中的文件路径和命令保存设置。配置完成后完全退出客户端,再重新启动并创建新会话。
5. 确认请求成功
发起一个简短请求,然后打开 用量记录 检查是否出现对应记录。若客户端报错,请先查看连接故障排查。