1
拿到 Key
先在后台复制 sk 开头的 API 密钥。没有 Key,后面的安装都不用看。
最快流程
把用户从“看一堆说明”拉回最短路径:先拿 Key,再选客户端,最后复制对应配置。
先在后台复制 sk 开头的 API 密钥。没有 Key,后面的安装都不用看。
用 Codex 就走 OpenAI 兼容地址;用 Claude Code 就走 Anthropic 兼容地址。
把对应配置粘进去,重启应用,发一句测试消息。
路径 A
Codex 走 OpenAI 兼容配置。你需要把 base_url 写成带 /v1 的地址,然后设置 OPENAI_API_KEY。
配置文件放在 ~/.codex/config.toml 或 %USERPROFILE%\\.codex\\config.toml。
[model_providers.tokenkey]
name = "TokenKey"
base_url = "https://api.tokenkey.vip/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"
[profiles.tokenkey]
model_provider = "tokenkey"
model = "gpt-5"
profile = "tokenkey"重启 Codex,输入一句:你好,简单介绍一下你能做什么。能回复就完成。
mkdir -p ~/.codex
nano ~/.codex/config.toml
export OPENAI_API_KEY="sk-你的密钥"mkdir %USERPROFILE%\.codex
notepad %USERPROFILE%\.codex\config.toml
setx OPENAI_API_KEY "sk-你的密钥"路径 B
Claude Code 不是 OpenAI 客户端。它需要 Anthropic 协议的 base URL 和 auth token。
本机要先有 Node.js。安装完成后在项目目录执行 claude。
npm install -g @anthropic-ai/claude-code
claude如果你的网关支持 Anthropic 协议,使用下面变量启动。
export ANTHROPIC_BASE_URL="https://api.tokenkey.vip"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
claude在你的代码项目目录执行 claude,问一句:帮我解释这个项目结构。
cd 你的项目目录\nclaude排错
安装类问题大多不是客户端坏了,而是协议、地址、Key 或额度错了。
Key 填错、复制多了空格,或者 Key 已失效。
通常是 base_url 协议不对,Codex 和 Claude 配错了接口。
上游账号不可用、额度不足,或者后台没有可用渠道。
最简单的排查顺序:先确认 Key,再确认地址协议,最后确认后台渠道和额度。
参考链接