# Passion8 API 接入文档：Claude Code、Codex 与多模型配置

> 使用 Passion8 地址、API Key 和模型，在 VS Code、Cline、CLI 或 API 项目中接入 Claude、GPT、Grok 与 Gemini。

URL: https://docs.passion8.cc/
Language: zh-CN
Publisher: Passion8
Last updated: 2026-10-11

Passion8 是面向开发者的 OpenAI / Anthropic 兼容 API 中转站。使用本站地址、API Key 和模型即可接入 Claude、GPT、Grok 与 Gemini。先选择 VS Code、Cline、CLI 或自己的 API 项目，再进入命令、工作流、缓存和治理等学习材料。

Passion8 独立编写这些接入教程，厂商官方参考见各篇来源链接。厂商的订阅、云端托管功能和 API 中转接入应分别核对。

## Claude Code

先安装,再配置。安装覆盖 CLI、桌面端和官方 IDE 插件;配置只保留手动配置和 CC-Switch 配置。



- [安装教程](https://docs.passion8.cc/docs/claude-code/install): macOS / Windows 安装 CLI、桌面端和官方 IDE 插件。
- [配置教程](https://docs.passion8.cc/docs/claude-code/settings): 手动配置或用 CC-Switch 固定接入 Passion8。
- [VS Code 官方扩展](https://docs.passion8.cc/docs/claude-code/vscode): 使用本站地址、Key 和模型配置官方扩展。



## Codex

先安装,再配置。Codex 的 Base URL 是 `https://passion8.cc/v1`,必须带 `/v1`。



- [安装教程](https://docs.passion8.cc/docs/codex/install): macOS / Windows 安装 CLI、桌面端和官方 IDE 插件。
- [配置教程](https://docs.passion8.cc/docs/codex/config): 手动写 auth.json/config.toml,或用 CC-Switch 固定接入 Passion8。
- [VS Code 官方扩展](https://docs.passion8.cc/docs/codex/ide): 让官方扩展使用相同的供应商与 API Key 配置。



## Grok

VS Code 用户先从 Cline 接入。Grok 也可以用官方 Grok Build CLI 接入,或用 Codex CLI / App 通过 CC-Switch 的 GPT 供应商接入。Base URL 是 `https://passion8.cc/v1`,必须带 `/v1`。



- [VS Code 与 Cline](https://docs.passion8.cc/docs/grok/vscode): 用本站地址、Key 和模型配置 Grok。
- [API 与 SDK](https://docs.passion8.cc/docs/grok/api): 配置 OpenAI 兼容请求，排查地址与模型问题。
- [Grok 安装与接入教程](https://docs.passion8.cc/docs/grok): 官方 Grok Build 安装配置,以及 Codex CLI / App 走 Grok 的最小配置。



## Gemini

VS Code 用户先用 Cline，选择 OpenAI 兼容接口 `https://passion8.cc/v1`。原生 Gemini API-key 客户端使用 `https://passion8.cc`，不带 `/v1`；CLI 教程保留为另一种接入方式。



- [VS Code 与 Cline](https://docs.passion8.cc/docs/gemini/vscode): 在 Cline 中填写本站地址、Key 和模型，接入 Gemini。
- [API 与 SDK](https://docs.passion8.cc/docs/gemini/api): 区分原生 Gemini 与 OpenAI 兼容接口，提供调用示例。
- [Gemini 安装与接入教程](https://docs.passion8.cc/docs/gemini): macOS / Windows 安装、持久化手动配置、CC-Switch 和首次验证。



## 接入前准备

还没有 API Key 或余额时,先处理账号和充值。



- [快速开始](https://docs.passion8.cc/docs/quickstart): 注册、创建 Key、确认要接入的工具。
- [充值与账单](https://docs.passion8.cc/docs/billing): 买卡密、兑换到钱包、确认到账。
- [邀请奖励](https://docs.passion8.cc/docs/invite): 复制邀请链接，以及可转发的话术。



## 学习文档

接入跑通后,再看命令、上下文、MCP、Hooks、权限、SDK、缓存和排错。



- [Claude Code 文档](https://docs.passion8.cc/docs/claude-code): 命令、交互模式、设置、上下文、会话、MCP、Hooks、权限、SDK 和缓存。
- [Codex 文档](https://docs.passion8.cc/docs/codex): 桌面 App、IDE、MCP、Skill、记忆、自动化、Git、工作流和命令。
- [Grok 文档](https://docs.passion8.cc/docs/grok): 官方 Grok Build 与 Codex 接入 Grok 的配置和排错。



CLI 客户端可以**手动改配置文件**，或用 **CC-Switch** 图形化管理。Cline 在插件的供应商设置页填写配置。CC-Switch 配置固定填写 Passion8 的端点和你的 Passion8 API Key。

## 通用



- [Cline 多模型配置](https://docs.passion8.cc/docs/cline): 配置 Claude、GPT、Grok、Gemini，选择 Provider 与 Plan / Act 模型。
- [常见问题](https://docs.passion8.cc/docs/faq): Base URL、模型、计费、充值与鉴权报错的高频答疑。
- [邀请奖励](https://docs.passion8.cc/docs/invite): 复制邀请链接和话术。
- [Claude Prompt 缓存](https://docs.passion8.cc/docs/claude-code/prompt-caching): 5 分钟与 1 小时 TTL、缓存失效、MCP 和 usage 字段。
- [安全说明](https://docs.passion8.cc/docs/security): Key、权限、Hooks、MCP、Prompt 注入与网关安全。




**接入地址速记**

- **Gemini CLI / 原生 Gemini**:Base URL `https://passion8.cc`(不带 `/v1`)
- **Claude Code**:Base URL `https://passion8.cc`(不带 `/v1`)
- **Codex / Grok / OpenAI 兼容**:Base URL `https://passion8.cc/v1`(带 `/v1`)

具体模型名以 [控制台模型广场](https://passion8.cc) 实际可用的为准。


