> ## Documentation Index
> Fetch the complete documentation index at: https://apione.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# API Key 与 OAuth PKCE

> 了解 APIONE 当前认证方式与 OAuth 集成的边界。

## APIONE 当前接入方式

本系列教程采用 APIONE API Key。先在 [密钥管理](https://apione.ai/zh/app/api-keys) 创建密钥，再根据客户端所选协议配置认证。APIONE 文档目前可确认的接入能力不包含通用第三方 OAuth PKCE 授权服务，因此不提供未经确认的授权 URL、客户端 ID 或扩展安装命令。

| 场景 | 采用的方式 |
| - | - |
| OpenCode、Pi、Hermes 等编程助手 | 自定义提供商 + APIONE API Key |
| Claude Code / Claude Desktop | Anthropic 兼容端点 + APIONE 密钥 |
| 通用聊天与工作流客户端 | OpenAI 或 Gemini 兼容端点 + APIONE 密钥 |

按客户端要求使用一种认证头：Bearer、x-api-key 或 x-goog-api-key，避免重复发送互相冲突的密钥。

## OAuth PKCE 的工作方式

支持 PKCE 的服务通常会让客户端生成一次性校验参数，在浏览器中展示登录与授权页面，再用授权码换取访问令牌。访问令牌到期后能否刷新，取决于服务端是否提供刷新令牌以及对应权限。

这个流程需要服务商和客户端共同支持。其他平台的 OAuth 扩展、授权域名、scope 和 Token 存储逻辑不能直接替换品牌名后用于 APIONE。

## 如果客户端只提供 OAuth 登录

检查它是否同时支持 Custom endpoint / API Key；支持时按对应教程配置。如果客户端只开放指定服务商的 OAuth 登录，不能把 APIONE 密钥填到该登录流程中，应选择支持自定义端点的客户端。

常用入口：[OpenCode](https://apione.ai/docs/guides/opencode.md)、[Pi Coding Agent](https://apione.ai/docs/guides/pi-coding-agent.md)、[Hermes Agent](https://apione.ai/docs/guides/hermes-agent.md)、[OpenClaw](https://apione.ai/docs/guides/openclaw.md)。

## 将来启用 OAuth 前需要确认

应以 APIONE 官方公布的 issuer、授权与令牌端点、client\_id、回调地址、scope、PKCE 方法和撤销机制为准。桌面回环回调还需确认浏览器与客户端的网络位置。

API Key 与 OAuth Token 都是凭据，不应写入提示词、公开仓库或截图。当前密钥可在 APIONE 控制台独立管理；撤销其他服务商的 OAuth 授权不会撤销 APIONE 密钥。

***

[返回集成目录](https://apione.ai/docs/guides/clients.md) · [模型选择](https://apione.ai/docs/models/catalog.md) · [错误排查](https://apione.ai/docs/support/errors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.