新手指引

这份手册旨在帮助你将 PortAPI 接入 Codex 与 Claude Code。按顺序完成API密钥创建、工具安装、配置导入和连通性验证后，你就可以在本地终端里通过统一入口使用不同的大模型。

💡 新手建议
建议新用户优先使用 CC Switch 一键导入配置；仅在不安装桌面管理工具时，再选择手动编辑 Codex 配置文件。

在开始操作前，请确认你已满足以下准备项。Windows 用户建议使用 WSL2 或 PowerShell 配合 Node.js；macOS 和 Linux 用户可直接在系统终端中完成后续步骤。

准备项	说明
PortAPI 账号	用于创建API密钥、查看余额和管理模型权限。
可用终端	用于安装 Codex、验证命令和测试连通性。
Node.js / Git	Codex 和部分插件命令需要依赖 Node.js 与 Git 环境。

根据你的使用方式和操作系统，选择对应的教程路线。

配置举例：Codex App
适合只想使用桌面版 Codex的用户

创建API密钥：获取你的专属 API 密钥。

下载 Codex App：获取桌面客户端。

配置API密钥：在应用中填入获取到的密钥。

验证配置：发送测试指令，确保连接正常。

API密钥是你调用 API 的凭证，所有后续工具的配置都依赖它。

操作步骤：

进入API密钥页面
登录 PortAPI 管理后台，在左侧菜单中点击「API密钥」。

添加新API密钥
点击页面右上角的「创建API密钥」按钮。

填写信息

名称：建议使用 codex-daily、cc-switch-main 等易辨识的命名。

分组：按计划使用的模型选择（如使用 GPT 系列请选择 gpt 分组）。

保存密钥
点击「保存更改」后，复制并妥善保存API密钥（格式类似 sk-xxxxxxxxxxxxxxxx）。

配置信息速查

项目	示例值 / 说明
Codex (OpenAI 兼容)	Base URL: `https://api.portapi.ai/v1`
Claude Code (Anthropic)	Base URL: `https://api.portapi.ai` (注意：不要加 `/v1`)
API Key	`sk-xxxxxxxxxxxxxxxx`

⚠️ 安全警告
API密钥请务必妥善保存，切忌传播分享，以避免不必要的损失。

Codex 和 Claude Code 都是终端里的 AI 编程助手。你可以只安装其中一个，也可以两个都安装，再通过 CC Switch 统一管理配置。

系统要求

要求	说明
操作系统	macOS、Linux，或 Windows 11 + WSL2
Node.js	建议使用 LTS 版本；Claude Code 需要 Node.js 18 或更高版本
Git	建议 2.23 或更高版本
内存	最低 4 GB，推荐 8 GB

安装方式

Codex App (桌面版)：适合直接使用图形界面，可前往官方页面下载，无需单独配置命令行环境。

Codex CLI (命令行)：适合在终端里使用 codex 命令。

安装好工具后，需要将生成的API密钥配置到对应工具中。

验证配置是否成功

请在终端执行以下命令：