# Passion8 快速开始：API Key、Base URL 与模型配置

> 创建 Passion8 API Key，确认余额和模型权限，按 Claude Code、Codex、Cline 或 Gemini 客户端填写正确的 Base URL 并验证接入。

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

接入 Passion8 只有三步:**注册 → 创建 Key → 在工具里填写地址、Key 和模型**。

## 准备账号与 Key







### 注册并登录

打开 [passion8.cc/sign-up](https://passion8.cc/sign-up) 注册账号并登录控制台。






### 确认余额

新账号需要先充值才能调用。充值是单独流程,详见 [充值与账单](https://docs.passion8.cc/docs/billing)。






### 创建 API Key

进入 [控制台 → 令牌](https://passion8.cc/console/token),新建一个 API Key。




Key 等同于你的余额密码。不要写进公开仓库、截图或聊天记录。给不同工具/项目建议各发一个 Key,方便单独吊销。









## 选择你的工具

拿到 Key 后,按你用的工具继续:



- [Claude Code · VS Code 官方扩展](https://docs.passion8.cc/docs/claude-code/vscode): 填写本站地址、Key 和模型，配置官方扩展。
- [Codex · VS Code 官方扩展](https://docs.passion8.cc/docs/codex/ide): 使用本地 API Key 配置连接官方扩展。
- [Cline 多模型配置](https://docs.passion8.cc/docs/cline): 一个 VS Code 插件中接入 Claude、GPT、Grok 与 Gemini。
- [Claude Code 安装教程](https://docs.passion8.cc/docs/claude-code/install): CLI、桌面端和官方 IDE 插件。
- [Claude Code 配置教程](https://docs.passion8.cc/docs/claude-code/settings): 手动配置或用 CC-Switch 接入 Passion8。
- [Codex 安装教程](https://docs.passion8.cc/docs/codex/install): CLI、桌面端和官方 IDE 插件。
- [Codex 配置教程](https://docs.passion8.cc/docs/codex/config): 手动配置或用 CC-Switch 接入 Passion8。
- [Gemini 安装与接入教程](https://docs.passion8.cc/docs/gemini): 安装 Gemini CLI，手动配置或用 CC-Switch 接入本站。
- [Grok 安装与接入教程](https://docs.passion8.cc/docs/grok): 安装官方 Grok Build,或用 Codex CLI / App 接入 Grok。



## 接入地址速查

| 工具 | Base URL | 认证方式 |
| --- | --- | --- |
| Claude Code CLI / IDE | `https://passion8.cc` | 环境变量 `ANTHROPIC_AUTH_TOKEN` |
| Claude Desktop 聊天 | 不作为 Passion8 接入入口 | 可用 MCP 接工具,但不是模型后端改造 |
| Codex CLI / 官方 IDE 扩展 | `https://passion8.cc/v1` | `~/.codex/auth.json` 里的 `OPENAI_API_KEY` |
| Gemini CLI | `https://passion8.cc` | `~/.gemini/.env` 中的 `GEMINI_API_KEY` |
| Cline：GPT / Gemini / Grok | `https://passion8.cc/v1` | OpenAI Compatible 设置中的 API Key |
| Cline：Claude | `https://passion8.cc` | Anthropic 自定义地址设置中的 API Key |
| Grok Build CLI | `https://passion8.cc/v1` | `~/.grok/config.toml` 里的 `api_key` 或 `env_key` |




Claude Code 与 Gemini CLI 的 Base URL **不带** `/v1`,Codex 和 Grok 走的 OpenAI 兼容接口**带** `/v1`。这是最常见的填错点。




## 接下来控制成本

首次跑通后,建议马上看 [Claude 成本与缓存](https://docs.passion8.cc/docs/claude-code/cost-saving):它会告诉你什么时候 `/clear`、什么时候 `/compact`,以及 5 分钟和 1 小时缓存的差异。
