LinkAGI

Codex 中转站 · LinkAGI 实操

Codex 中转站配置
Base URL 一次填对

LinkAGI 是面向国内开发者的 AI API 中转站。Codex 使用 https://api.linktoagi.com/v1 和 Responses 协议；配置独立 API Key 后，不需要先登录 ChatGPT 账号。

直接看配置 查看可用模型
Base URL末尾必须有 /v1
协议Responses
凭证LinkAGI 独立 API Key

8 分钟完成 Codex API 接入

以下配置与 LinkAGI 当前路由一致。模型名称不要凭教程猜，先从模型广场复制当前可用的精确名称。

1. 安装或检查 Codex

已经安装可直接检查版本；没有安装再通过 npm 安装。

npm install -g @openai/codex
codex --version

2. 找到用户级配置

提供方配置应放在用户级文件，避免项目级安全限制忽略凭证重定向设置。

# macOS / Linux / WSL
~/.codex/config.toml

# Windows
%USERPROFILE%\.codex\config.toml
model_provider = "linkagi"
model = "gpt-5.6-luna"
model_reasoning_effort = "high"

[model_providers.linkagi]
name = "LinkAGI"
base_url = "https://api.linktoagi.com/v1"
wire_api = "responses"
env_key = "LINKAGI_API_KEY"

Codex 当前官方配置说明将 config.toml 作为持久配置入口，并支持自定义 model_providers、base_url、env_key 与 wire_api = "responses"。模型名称和 LinkAGI 价格以实时模型广场为准。

设置 API Key：三种系统分别怎么做

API Key 不写进 TOML，Codex 会读取 env_key 指定的环境变量。设置后必须完全重开终端或编辑器。

macOS / Linux / WSL

export LINKAGI_API_KEY="sk-替换为你的Key"
codex

长期使用时把 export 行写入 ~/.zshrc 或 ~/.bashrc。

Windows PowerShell

[Environment]::SetEnvironmentVariable(
  "LINKAGI_API_KEY",
  "sk-替换为你的Key",
  "User"
)

关闭所有 PowerShell、VS Code 或 Cursor 窗口后重新打开。

先验证路由，再启动 Codex

把“网络问题”“Key 问题”和“Codex 配置问题”分层检查，排错速度会快很多。

# 只检查域名、TLS 和鉴权入口，不消耗模型额度
curl -i https://api.linktoagi.com/v1/models

# 带自己的 Key 检查模型列表
curl -s https://api.linktoagi.com/v1/models \
  -H "Authorization: Bearer $LINKAGI_API_KEY"
2026-07-23 实测

无 Key 请求 /v1/models 返回 JSON 401；无 Key POST /v1/responses 也返回 JSON 401。这证明请求已到达 LinkAGI 鉴权层，但不代表某个模型或账户已完成付费调用。

01

启动

进入项目目录执行 codex。

02

核对

输入 /status，确认提供方为 linkagi。

03

查日志

完成一条短请求后，到控制台核对模型、Token 和扣费。

Codex 中转站常见错误速查

401 Invalid token

当前终端没有读到 LINKAGI_API_KEY、Key 复制错误或令牌已失效。重开终端后先检查变量是否存在。

404 / Invalid URL

最常见是 Base URL 少了 /v1，或把完整 /responses 端点误填成 Base URL。

model not found / 403

模型名与模型广场不一致，或者令牌分组不支持该模型。重新创建或调整令牌权限。

429 / 5xx / timeout

降低并发并查看公告、日志和号池状态；不要把重试写成无上限循环。

LinkAGI 适合哪类 Codex 用户

国内直接接入

使用人民币充值和独立 API Key，适合不走 ChatGPT 账号登录路线的个人开发者。

一手 GPT 号池

提供 Sale、Plus、Pro 多档号池，按实时可用性与任务重要程度选择。

调用明细可查

在控制台核对模型、Token、状态和实际扣费，便于排查与控制预算。

先跑一条短请求验证配置

创建 Codex 分组 Key，复制当前模型名，成功后再逐步增加任务长度。

注册 LinkAGI