AICodex / Claude 快速接入
目标:10 分钟内跑通

快速安装并使用 Codex、Claude

这页只保留必要步骤:复制密钥、安装客户端、粘贴配置、发送测试。先选你要用的工具,不要混用两套协议。

从最快流程开始

最快流程

用户只需要记住三件事

把用户从“看一堆说明”拉回最短路径:先拿 Key,再选客户端,最后复制对应配置。

1

拿到 Key

先在后台复制 sk 开头的 API 密钥。没有 Key,后面的安装都不用看。

2

选工具

用 Codex 就走 OpenAI 兼容地址;用 Claude Code 就走 Anthropic 兼容地址。

3

复制配置

把对应配置粘进去,重启应用,发一句测试消息。

路径 A

Codex:适合 OpenAI 兼容接口

Codex 走 OpenAI 兼容配置。你需要把 base_url 写成带 /v1 的地址,然后设置 OPENAI_API_KEY。

1

安装 Codex

下载 Codex 桌面端并启动一次。启动后退出应用,再写配置。

2

写入 config.toml

配置文件放在 ~/.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"
3

设置密钥并测试

重启 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:适合 Anthropic 兼容接口

Claude Code 不是 OpenAI 客户端。它需要 Anthropic 协议的 base URL 和 auth token。

1

安装 Claude Code

本机要先有 Node.js。安装完成后在项目目录执行 claude。

npm install -g @anthropic-ai/claude-code
claude
2

设置 Anthropic 环境变量

如果你的网关支持 Anthropic 协议,使用下面变量启动。

export ANTHROPIC_BASE_URL="https://api.tokenkey.vip"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
claude
3

进入项目目录测试

在你的代码项目目录执行 claude,问一句:帮我解释这个项目结构。

cd 你的项目目录\nclaude

排错

看错误码,比反复重装更快

安装类问题大多不是客户端坏了,而是协议、地址、Key 或额度错了。

401 / Unauthorized

Key 填错、复制多了空格,或者 Key 已失效。

404 / Not Found

通常是 base_url 协议不对,Codex 和 Claude 配错了接口。

503 / No quota

上游账号不可用、额度不足,或者后台没有可用渠道。

最简单的排查顺序:先确认 Key,再确认地址协议,最后确认后台渠道和额度。

参考链接

官方入口