⚙️ Codex CLI 和 Claude Code 接入 tokenapikey.top 教程

Base URL：https://tokenapikey.top

将 OpenAI Codex CLI 和 Anthropic Claude Code 接入 tokenapikey.top，一个 Key 调用 76+ 主流大模型。

📑 目录 一、Codex CLI 接入 1. 安装 Codex CLI 2. 配置文件方式（推荐） 3. 环境变量方式（快速测试） 4. 验证连通性二、Claude Code 接入 1. 安装 Claude Code 2. 配置环境变量 3. 验证连通性三、支持的模型四、关于 Responses API 五、常见问题排查六、注册引导

一、Codex CLI 接入

1安装 Codex CLI

方式一：npm（推荐）

npm install -g @openai/codex
codex --version  # 验证安装

方式二：Homebrew（macOS）

brew install --cask codex
codex --version  # 验证安装

方式三：官方脚本

curl -fsSL https://chatgpt.com/codex/install.sh | sh

💡 要求 Node.js >= 18。

2配置文件方式（推荐）

Codex CLI 的配置文件位于 ~/.codex/config.toml（旧版本可能使用 ~/.codex/config.json）。创建或编辑该文件：

Linux / macOS：

mkdir -p ~/.codex
nano ~/.codex/config.toml

Windows（PowerShell）：

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex"
notepad "$env:USERPROFILE\.codex\config.toml"

写入以下内容：

model = "deepseek-chat"
model_provider = "tokenapikey"
model_reasoning_effort = "medium"
disable_response_storage = true

[model_providers.tokenapikey]
name = "TokenAPIKey"
base_url = "https://tokenapikey.top/v1"
wire_api = "responses"
requires_openai_auth = false
env_key = "OPENAI_API_KEY"

然后设置 API Key 环境变量（Codex 会通过 env_key 指定的变量名读取密钥）：

# Linux / macOS
export OPENAI_API_KEY="sk-你的密钥"

# Windows CMD
set OPENAI_API_KEY=sk-你的密钥

# Windows PowerShell
$env:OPENAI_API_KEY = "sk-你的密钥"

⚠️ 建议将 export 写入 ~/.bashrc 或 ~/.zshrc 使其永久生效。

字段说明：

字段	说明
`model`	默认使用的模型名称
`model_provider`	指向 `model_providers` 中定义的提供商
`base_url`	API 地址，必须带 `/v1` 后缀
`wire_api`	协议类型：`responses` 为 Responses API（默认），`chat` 为 Chat Completions API
`requires_openai_auth`	设为 `false` 跳过 OpenAI 官方 OAuth 认证
`env_key`	读取 API Key 的环境变量名
`disable_response_storage`	禁用响应存储（第三方端点建议开启）

3环境变量方式（快速测试）

适合临时测试，不修改配置文件：

# Linux / macOS
export OPENAI_BASE_URL="https://tokenapikey.top/v1"
export OPENAI_API_KEY="sk-你的密钥"
codex

# Windows CMD
set OPENAI_BASE_URL=https://tokenapikey.top/v1
set OPENAI_API_KEY=sk-你的密钥
codex

# Windows PowerShell
$env:OPENAI_BASE_URL = "https://tokenapikey.top/v1"
$env:OPENAI_API_KEY = "sk-你的密钥"
codex

⚠️ 环境变量方式在部分 Codex 版本中可能不生效，长期使用建议采用配置文件方式。

4验证连通性

# 启动交互式 TUI
codex

# 带初始提示启动
codex "用 Python 写一个快速排序"

# 非交互模式
codex exec "列出当前目录文件"

# 指定模型
codex -m deepseek-reasoner "解释这段代码"

如果看到正常响应，说明接入成功。 ✅

二、Claude Code 接入

1安装 Claude Code

npm install -g @anthropic-ai/claude-code
claude --version  # 验证安装

💡 要求 Node.js >= 18。

2配置环境变量

Claude Code 支持通过 OPENAI_API_KEY 和 OPENAI_BASE_URL 环境变量接入 OpenAI 兼容后端。

Linux / macOS：

export OPENAI_API_KEY="sk-你的密钥"
export OPENAI_BASE_URL="https://tokenapikey.top/v1"
claude

写入 ~/.bashrc 或 ~/.zshrc 永久生效：

echo 'export OPENAI_API_KEY="sk-你的密钥"' >> ~/.zshrc
echo 'export OPENAI_BASE_URL="https://tokenapikey.top/v1"' >> ~/.zshrc
source ~/.zshrc

Windows CMD：

set OPENAI_API_KEY=sk-你的密钥
set OPENAI_BASE_URL=https://tokenapikey.top/v1
claude

Windows PowerShell：

$env:OPENAI_API_KEY = "sk-你的密钥"
$env:OPENAI_BASE_URL = "https://tokenapikey.top/v1"
claude

⚠️ 确保 OPENAI_BASE_URL 包含 /v1 后缀。

3验证连通性

# 启动交互式会话
claude

# 带初始提示启动
claude "帮我写一个 React 组件"

如果 Claude Code 正常响应，说明接入成功。 ✅

三、支持的模型

接入后可使用以下模型（在 Codex CLI 中通过 -m 参数指定，在配置文件中通过 model 字段指定）：

模型	说明	适用场景
`deepseek-chat`	DeepSeek V3 对话模型	通用编程、对话
`deepseek-reasoner`	DeepSeek R1 推理模型	复杂逻辑推理、算法设计热门
`qwen3.7-max`	通义千问 3.7 Max 旗舰版	高质量代码生成
`qwen3-coder-plus`	Qwen3 Coder Plus	代码补全、重构
`kimi-k2.7-code`	Kimi K2.7 代码版	编程助手、代码审查

📋 完整模型列表（76+）请参考 tokenapikey.top 接入文档。

四、关于 Responses API 重要

Codex CLI v0.130+ 默认使用 OpenAI 的 Responses API（/v1/responses），而非传统的 Chat Completions API（/v1/chat/completions）。

✅ tokenapikey.top 已兼容支持 Responses API，你无需额外操作。

在 config.toml 中通过 wire_api 字段控制：

# 使用 Responses API（推荐，Codex v0.130+ 默认）
wire_api = "responses"

# 回退到 Chat Completions API（兼容性更好）
wire_api = "chat"

💡 大多数情况下 responses 即可正常工作。若模型不支持 Responses API 导致报错，切换为 chat 即可。

五、常见问题排查

401 Unauthorized / Invalid token

原因：API Key 未正确配置。

解决：

检查环境变量是否设置正确：echo $OPENAI_API_KEY
确认 config.toml 中 env_key 指向的变量名与实际环境变量一致
确认 requires_openai_auth = false，避免走 OpenAI 官方认证

清除旧的认证残留：

rm ~/.codex/auth.json
rm -rf ~/.codex/sqlite/

404 Not Found / 连接超时

原因：base_url 配置错误，最常见的是缺少 /v1 后缀。

解决：

✅ 正确格式：https://tokenapikey.top/v1
❌ 错误格式：https://tokenapikey.top（缺少 /v1）

stream disconnected / Responses API 报错

原因：部分模型可能不完全兼容 Responses API。

解决：在 config.toml 中将 wire_api 从 "responses" 改为 "chat"，重启 Codex CLI 使配置生效。

OAuth 相关错误（auth.openai.com / refresh token）

原因：之前登录过 OpenAI 官方账号，残留的 OAuth token 干扰。

解决：

codex auth logout          # 登出官方账号
rm ~/.codex/auth.json      # 删除认证文件
rm -rf ~/.codex/sqlite/    # 清除缓存

修改配置后不生效

原因：Codex CLI 仅在启动时读取配置文件。

解决：每次修改 config.toml 后，重启 Codex CLI。

Windows 下环境变量不生效

解决：

CMD 使用 set 命令（当前会话有效）
PowerShell 使用 $env: 语法
永久生效：通过「系统属性 → 环境变量」设置，或使用 setx 命令：
```
setx OPENAI_API_KEY "sk-你的密钥"
setx OPENAI_BASE_URL "https://tokenapikey.top/v1"
```
setx 设置后需重新打开终端窗口。

Claude Code 仍然走 Anthropic 官方 API

解决：

确认 OPENAI_BASE_URL 和 OPENAI_API_KEY 已正确导出
在同一终端会话中启动 claude
检查是否有 ANTHROPIC_API_KEY 环境变量残留并清除

六、注册引导

还没有 tokenapikey.top 账号？30 秒即可完成注册：

访问 tokenapikey.top
点击右上角 「Sign in」 → 注册账号
进入 「Console」→「Tokens」→「Add New Token」 创建 API Key
复制 sk-xxx 格式的密钥，填入上方配置即可使用

🎁 新用户福利：
注册即送 $0.5 试用额度
每日签到可获得额外额度
邀请好友双方各得 $0.5 奖励
充值余额永久有效，不过期
8 个永久免费模型不限量使用