开始前:准备三个信息
网络准备(Codex / Claude Code)
使用Codex或Claude Code前,请先确认电脑能访问 infinitetoken.cn,以及安装、登录和所需功能依赖的官方服务。若当前网络无法访问这些官方服务,可能需要可用的梯子;已安装并配置本站API后,模型请求主要发往本站,不统一要求全程开启梯子。具体以客户端版本、所用功能和实际网络为准。浏览器能打开网页,也不代表客户端进程已使用相同网络设置。
在infinitetoken.cn注册并登录 ↗,进入控制台的令牌管理,创建客户API Key。普通客户通常共用一把Key访问GPT、Claude和Gemini,具体受账户与令牌权限约束。不要使用登录密码、其他平台Key或上游Key。
从登录后的模型广场 ↗复制精确模型ID。下文 YOUR_AUTHORIZED_MODEL_ID 指你有权限、且支持所选协议的模型;YOUR_AUTHORIZED_CLAUDE_MODEL_ID 指相应Claude模型。显示名称不能代替ID。编码Agent还要求模型支持工具调用与流式输出。
选择自己的工具,再按其字段填写地址。infinitetoken.cnKey不等于GitHub、ChatGPT或Claude的订阅账号,第三方客户端自己的登录和组织策略仍然适用。价格以个人报价和使用日志为准。
地址速查:同一网站,不同字段
| 用在哪里 | 填写内容 | 客户端最终请求 |
|---|---|---|
| Codex / OpenAI SDK 的 Base URL | https://infinitetoken.cn/v1 | Codex为 /v1/responses;Chat SDK为 /v1/chat/completions |
| Claude Code 的 ANTHROPIC_BASE_URL | https://infinitetoken.cn | /v1/messages |
| WorkBuddy 的完整接口地址 | https://infinitetoken.cn/v1/chat/completions | 同左;注意下文自定义协议开关 |
| VS Code Custom Endpoint 的模型URL | https://infinitetoken.cn/v1/responses 或 /v1/chat/completions 或 /v1/messages | 选择与URL一致的API类型 |
不要把 /responses 写进Codex的Base URL,也不要把 /v1/messages 写进Claude Code的根地址。infinitetoken.cn公开文档确认Chat入口;源码含Messages/Responses路由,后二者仍待生产客户端连通验收。
01 · Codex(桌面 / CLI)
从官方入口 ↗安装当前桌面应用,在应用中进入Codex。当前官方桌面文档使用ChatGPT名称;以实际版本的Codex入口为准。CLI可依官方安装说明 ↗安装,已有Node.js/npm时可用以下官方命令;本文不自动执行安装。
npm install -g @openai/codex先备份现有配置。macOS/Linux打开 ~/.codex/config.toml;Windows打开 %USERPROFILE%\.codex\config.toml。WSL使用Linux用户目录。合并下面字段,不覆盖已有其他设置,不重复定义相同字段或表。顶层字段必须放在第一个 [表名] 之前。
model = "YOUR_AUTHORIZED_MODEL_ID"
model_provider = "infinitetoken"
[model_providers.infinitetoken]
name = "infinitetoken.cn"
base_url = "https://infinitetoken.cn/v1"
wire_api = "responses"
requires_openai_auth = false
env_key = "INFINITETOKEN_API_KEY"Key不写进TOML。先在当前终端隐藏输入Key,再从同一终端启动CLI,验证变量能被进程读取。
macOS/Linux(bash或zsh):
printf '输入infinitetoken.cn客户Key(输入不显示):'
read -r -s INFINITETOKEN_API_KEY
printf '\n'
export INFINITETOKEN_API_KEY
codexWindows PowerShell:
$infiniteTokenSecret = Read-Host '输入infinitetoken.cn客户Key' -AsSecureString
$env:INFINITETOKEN_API_KEY = [System.Net.NetworkCredential]::new('', $infiniteTokenSecret).Password
Remove-Variable infiniteTokenSecret
codex这些变量仅对当前终端及其子进程有效。桌面图标启动的应用不保证继承终端环境;仅修改TOML不等于桌面配置完成。桌面需按官方网关说明 ↗让应用进程拿到变量,或使用经审核的凭据助手。本稿未提供或验收跨平台持久化安装包;先以CLI验证路径为准。
如果模型不在客户端目录中,不要只靠手写ID强行宣称兼容;需取得匹配当前客户端版本的infinitetoken.cn模型目录与真实绝对路径后再配置 model_catalog_json。本稿未附造出的模型目录,也不引用上游模型目录。
保存后重启、新建会话。CLI用 /status 检查provider与model,再按本文末尾的核验步骤验证。保留原有权限策略,无须为接入开启完全访问权限。
02 · Claude Code(VS Code / CLI)
方法A:官方VS Code扩展
在VS Code扩展市场安装发布者为Anthropic的Claude Code。Windows/Linux按 Ctrl+Shift+P,macOS按 Cmd+Shift+P,执行 Preferences: Open User Settings (JSON)。只合并以下字段;已有同名数组时编辑原数组。
{
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "https://infinitetoken.cn" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "YOUR_INFINITETOKEN_API_KEY" },
{ "name": "ANTHROPIC_MODEL", "value": "YOUR_AUTHORIZED_CLAUDE_MODEL_ID" }
]
}将Key和模型占位符替换为自己的值。此方式会在本机用户设置中明文保存Key;不要放入项目设置、共享设置、截图或仓库,也不要同步含Key的设置。与其他配置合并前先备份。
保存后执行 Developer: Reload Window,打开Claude面板并新建会话。用 /status 确认根地址、模型与 ANTHROPIC_AUTH_TOKEN 凭据来源。扩展有启动前登录检查,仅在终端设置变量可能不够。
方法B:Claude Code CLI
按官方安装页 ↗安装CLI。macOS的Homebrew方式、Windows的WinGet方式如下;安装完重新打开终端,用 claude --version 检查。
# macOS(已安装Homebrew)
brew install --cask claude-code# Windows(已安装WinGet)
winget install Anthropic.ClaudeCode先用上节的隐藏输入方式设置 INFINITETOKEN_API_KEY(到export或Remove-Variable为止,不执行codex),再在同一终端执行:
# macOS / Linux
export ANTHROPIC_BASE_URL='https://infinitetoken.cn'
export ANTHROPIC_AUTH_TOKEN="$INFINITETOKEN_API_KEY"
export ANTHROPIC_MODEL='YOUR_AUTHORIZED_CLAUDE_MODEL_ID'
claude# Windows PowerShell
$env:ANTHROPIC_BASE_URL = 'https://infinitetoken.cn'
$env:ANTHROPIC_AUTH_TOKEN = $env:INFINITETOKEN_API_KEY
$env:ANTHROPIC_MODEL = 'YOUR_AUTHORIZED_CLAUDE_MODEL_ID'
claudeANTHROPIC_AUTH_TOKEN 会作为Bearer发送,不要再手动给变量值加 Bearer 。若原有API Key变量或组织配置与此冲突,先用 /status 查看来源;不要删除已有订阅凭据或绕过组织限制。CLI变量配置不等于Claude桌面应用配置。此处“CC”指Claude Code;如你使用CC Switch等第三方切换器,需另核对其具体版本,不直接套用。
03 · WorkBuddy
从WorkBuddy官方指南 ↗进入安装说明并安装适用系统的版本。打开对话模型选择器,选择“配置自定义模型”;也可到设置的模型页新增模型。
| 字段 | 内容 |
|---|---|
| 提供商 | 自定义 / Custom |
| 接口地址 | https://infinitetoken.cn/v1/chat/completions |
| API Key | 你的infinitetoken.cn客户Key |
| 模型名 | 有权限且支持Chat Completions及所需能力的精确ID |
对于上表完整URL,可在高级设置开启“自定义协议”,使请求按该URL直发。官方说明默认关闭时会自动校验、补全 /chat/completions;不要重复拼接。如果你的版本没有这个开关,先核对该版本帮助中的地址字段规则,不盲目改路径。
保存后返回对话,在自定义模型分组中手动选中新增模型。需要多个模型时逐一新增。若提示function tools与reasoning参数不兼容,先核对模型与协议能力;不要只因报错就改成Responses地址,也不要假定改分组可以修复。
04 · GitHub Copilot:先认清客户端
Copilot App
在App设置中进入 Model providers → Add provider。使用OpenAI兼容模型时,选择 Any OpenAI-compatible HTTP endpoint,Base URL填 https://infinitetoken.cn/v1,提供自己的infinitetoken.cnKey与精确模型ID,API格式与模型实际能力保持一致。保存后在会话中选中新增模型。若选Anthropic,根地址为 https://infinitetoken.cn,使用Messages能力。自定义提供商仍为公开预览,菜单可能变化;App自身GitHub登录要求仍适用。
GitHub Desktop
需要已登录具有GitHub Desktop Copilot访问权限的GitHub账号;组织或企业管理账号还需管理员启用该功能。仅有infinitetoken.cnKey不能保证出现此入口。
Windows进入 File → Options,macOS进入 GitHub Desktop → Settings,打开 Copilot → Providers → Add Provider。选 OpenAI / OpenAI-compatible,Base URL填 https://infinitetoken.cn/v1,选择模型支持的 Chat completions 或 Responses,认证选Bearer并填infinitetoken.cnKey,再添加精确模型标识。若使用Anthropic类型,根地址为 https://infinitetoken.cn。此接入用于Desktop提供的功能,不代表其他Copilot客户端自动完成配置。
Copilot CLI
按官方CLI指南 ↗安装或更新适用版本。在 ~/.copilot/providers.json(Windows通常为 %USERPROFILE%\.copilot\providers.json)合并配置。修改过配置目录的用户以实际目录为准。
{
"providers": [
{
"name": "infinitetoken",
"type": "openai",
"baseUrl": "https://infinitetoken.cn/v1",
"wireApi": "responses",
"bearerToken": "YOUR_INFINITETOKEN_API_KEY"
}
],
"models": [
{ "id": "YOUR_AUTHORIZED_MODEL_ID", "provider": "infinitetoken" }
]
}这里示例为Responses;仅用于确认支持该协议、工具调用及流式的模型。Chat Completions提供商的 wireApi 为 completions;不能仅换模型ID而忽略协议差异。Key会明文落盘,不能把 $INFINITETOKEN_API_KEY 写入JSON冒充环境变量读取。保护本地文件,不提交仓库。
保存后重启,运行下列命令;先替换模型占位符,再在 /model 中检查选择。
copilot --model infinitetoken/YOUR_AUTHORIZED_MODEL_ID旧 COPILOT_PROVIDER_* 环境变量仍是兼容入口;providers.json 已有provider/model时会优先覆盖它,因此只改旧变量可能没有效果。不要同时堆叠多套配置排错。
VS Code中的Copilot Chat
执行 Chat: Manage Language Models → Add Models → Custom Endpoint,通过界面输入API Key,选择模型支持的API类型。当前版本以 chatLanguageModels.json 配置模型;旧 github.copilot.chat.customOAIModels 已弃用。模型URL建议填完整路径,避免自动补全歧义,例如:
Responses https://infinitetoken.cn/v1/responses
Chat Completions https://infinitetoken.cn/v1/chat/completions
Messages https://infinitetoken.cn/v1/messages按向导生成的配置填精确ID,不随意编造上下文和输出上限;密钥用界面安全输入。组织可关闭BYOK,功能还受所选harness约束。这里配置聊天/Agent模型,不代表代码补全、语义搜索或所有Copilot功能均走infinitetoken.cn。Responses多轮遇到缺少工具历史等错误时,需核对服务是否有状态,再按官方说明设置 statefulResponses,不要盲目切换。
05 · GPT / Claude / Gemini通用API
支持OpenAI兼容Chat Completions的工具,可使用 https://infinitetoken.cn/v1、infinitetoken.cnKey及精确模型ID。三类模型的可用参数不同,不能把“同一把Key”理解成“协议和能力完全一样”。Gemini原生SDK不是简单套用OpenAI Base URL,本稿先给已有公开依据的兼容入口。
下面示例适合在服务端运行,使用现有Python OpenAI SDK;先在运行环境设置Key与 INFINITETOKEN_MODEL,后者填已授权、支持Chat Completions的模型。安装依赖按SDK官方说明办理。执行会产生真实请求和相应费用,本次没有运行。
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["INFINITETOKEN_API_KEY"],
base_url="https://infinitetoken.cn/v1",
)
reply = client.chat.completions.create(
model=os.environ["INFINITETOKEN_MODEL"],
messages=[{"role": "user", "content": "只返回 pong"}],
)
print(reply.choices[0].message.content)检查Key可见的模型可从自己的终端请求目录;目录可见不证明相应模型的生成、工具调用或结算通过。
# macOS/Linux;前提是已经设置INFINITETOKEN_API_KEY
curl 'https://infinitetoken.cn/v1/models' \
-H "Authorization: Bearer ${INFINITETOKEN_API_KEY}"06 · 怎么确认真的配置好了
先检查客户端选择的provider、目标地址和精确模型,再新建会话发送简短消息。随后在infinitetoken.cn控制台使用日志中核对对应时间、模型和消费记录。单凭回复“pong”或模型自报身份,不能证明请求路由。
基础回复通过后,再分别验证流式结束、多轮上下文、工具调用与工具结果回传。工具测试请用自己可丢弃的本地示例项目,先做只读任务。需要真实测试时会有模型费用;本稿只给操作说明,未替你执行。
07 · 常见问题
| 现象 | 优先检查 |
|---|---|
| 401 / Key无效 | Key是否来自infinitetoken.cn、是否过期/禁用、首尾空格、Bearer头;桌面进程是否读到凭据 |
| 403 / 无权限 | 账号与令牌允许的模型;不要借修改参数绕过授权 |
| 404 / 路径重复 | Base URL还是完整接口URL;是否出现 /v1/v1、重复 /messages 等 |
| model not found | 精确ID、账号可用性、Codex目录元数据;目录可见不等于当前可调用 |
| 400 / tools或reasoning错误 | 目标模型、协议、客户端发送参数;逐项查看错误,不盲目换分组 |
| 429 / 限流或额度不足 | 读取错误正文区分速率限制与余额;减少并发、等候后再试 |
| 5xx / 超时 | 记录时间和脱敏错误,先核对使用日志;不要连续重复提交 |
| 能聊天但Agent失败 | 另查工具调用、流式事件、多轮协议和上下文预算 |
| 配置不生效 | 重启/新建会话、配置层级、组织策略、环境继承;Copilot查providers配置优先级 |
请求支持时提供客户端版本、系统、发生时间、模型ID、状态码与脱敏错误;不要发送完整Key、私有代码或未遮挡截图。余额和用量以控制台实际记录为准。
核验状态与参考
本页为配置参考,依据客户端官方文档整理,未使用真实Key完成各客户端端到端测试。具体模型权限、Codex目录、桌面凭据读取以及流式、工具调用和多轮对话需在实际客户端核验。示例不代表所有模型或功能均已兼容。