接入开发工具 / Codex

在 Codex 中接入 Anc1ent API

Codex 的桌面应用、IDE 插件和 CLI 都读取用户目录下的 .codex 配置。先创建一把包含目标模型分组的专用 API Key。

开始前模型名称、可用分组、价格和渠道状态以控制台实时显示为准。不要将完整 API Key 发到群聊、截图或提交到 Git 仓库。

1. 找到配置目录

系统	路径
Windows	`%USERPROFILE%\.codex\`
macOS / Linux	`~/.codex/`

2. 保存 config.toml

在配置目录创建或编辑 config.toml。将模型 ID 改为控制台当前可用的值。

model_provider = "Anc1ent"
model = "gpt-5.6-sol"
review_model = "gpt-5.6-sol"
model_reasoning_effort = "high"
disable_response_storage = true
network_access = "enabled"

[model_providers.Anc1ent]
name = "Anc1ent API"
base_url = "https://api.anc1ent.top"
wire_api = "responses"
requires_openai_auth = true

3. 保存 auth.json

{
  "OPENAI_API_KEY": "YOUR_ANC1ENT_API_KEY"
}

4. 重启并验证

彻底退出 Codex 桌面应用、IDE 或旧终端。
重新启动客户端，确保读取的是当前用户目录下的配置。
在临时项目中运行最小测试，不要直接用生产项目验证。

codex "请只回复：api-ok"

打开控制台创建 API Key

接入开发工具 / Claude Code

在 Claude Code 中接入 Anc1ent API

Claude Code 通过 Anthropic 兼容接口工作。先确保 API Key 分组包含当前要用的 Claude 模型，再选择临时环境变量或持久化配置。

1. 安装 Claude Code

node --version
npm --version
npm install -g @anthropic-ai/claude-code
claude --version

如出现 claude: command not found，重开终端后再检查 npm 全局目录是否加入 PATH。

2. PowerShell 临时配置

$env:ANTHROPIC_BASE_URL = "https://api.anc1ent.top"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_ANC1ENT_API_KEY"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"
claude -p "请只回复：api-ok"

3. settings.json 持久化配置

Windows 文件位置为 %USERPROFILE%\.claude\settings.json；macOS/Linux 为 ~/.claude/settings.json。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.anc1ent.top",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_ANC1ENT_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

地址格式ANTHROPIC_BASE_URL 填写裸地址 https://api.anc1ent.top，不要追加 /v1、/messages 或 /chat/completions。

打开控制台检查模型分组

接入开发工具 / 通用客户端

接入 OpenAI 兼容客户端

适用于支持 OpenAI Chat Completions 的工具、脚本和桌面客户端。基础地址填写 https://api.anc1ent.top/v1。

通用参数

字段	填写内容
Base URL	`https://api.anc1ent.top/v1`
API Key	控制台 API Keys 创建的专用密钥
API 类型	OpenAI / Chat Completions
模型	控制台当前可用模型 ID

命令行最小验证

curl --http1.1 https://api.anc1ent.top/v1/chat/completions \
  -H "Authorization: Bearer YOUR_ANC1ENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"Reply with exactly: api-ok"}],"max_completion_tokens":32}'

模型不可用不要依据旧教程手填模型。先到控制台确认 Key 分组和模型 ID，再复制当前显示的名称。

资源与下载 / 客户端与依赖

客户端与依赖下载

只从官方站点或官方 GitHub Releases 下载客户端。不要使用群文件、来源不明的网盘包或修改版安装程序。

Codex桌面、IDE 与 CLI 编程工具 Claude CodeAnthropic 命令行编程工具 Node.js LTSCodex CLI 与 Claude Code 依赖 PythonAPI 脚本与本地自动化 OpenCode开源终端编程工具 Cherry Studio多模型桌面客户端

下载前检查

确认操作系统和 CPU 架构，例如 Windows x64、Apple Silicon 或 Linux ARM64。
确认下载页是官方域名或官方 Release，不是源码 ZIP。
安装后先执行版本命令，再进行 API 配置。

node --version
npm --version
python --version

资源与下载 / API 地址与模型

API 地址与模型

不同客户端对地址格式的要求不同。先识别客户端协议，再填写基础地址或完整接口路径。

场景	地址
OpenAI 兼容客户端	`https://api.anc1ent.top/v1`
Chat Completions	`https://api.anc1ent.top/v1/chat/completions`
模型列表	`https://api.anc1ent.top/v1/models`
Codex / Claude Code	`https://api.anc1ent.top`

避免 404不要重复拼接 /v1。客户端要求 Base URL 时填基础地址；只有脚本或工具明确要求完整 Endpoint 时才填写具体路径。

登录控制台查看可用模型

资源与下载 / 服务状态与模型对比

服务状态与模型对比

用官方状态页判断服务是否正在故障；用公开 Benchmark 对比模型在推理、代码、数学与长上下文等任务中的表现。这两类信息不能互相替代。

官方实时状态

OpenAI StatusOpenAI API、ChatGPT 与平台事件公告 Anthropic StatusClaude API 与 Claude 服务事件公告

状态页正常但请求仍失败先到控制台检查渠道状态、模型分组、余额与并发；随后记录错误时间和模型名称，再联系支持。

模型能力雷达与公开 Benchmark

Artificial Analysis综合 Intelligence Index、速度、价格与上下文能力对比 LiveBench持续更新的公开能力评测与分类成绩 LMArena Leaderboard基于盲测偏好的模型对战排行榜 Open LLM Leaderboard开源模型的公开评测与配置比较

怎么看才不会误判

你要解决的问题	优先看什么
接口是否故障	官方状态页 + Anc1ent 控制台渠道状态
代码与 Agent 任务	代码类 Benchmark、上下文长度、真实工具兼容性
复杂推理	综合 Index、推理/数学分类成绩与响应速度
实际成本	控制台当前模型定价、倍率和你的实际 Token 用量

不要把 Benchmark 当承诺排行榜反映测试集成绩，不保证特定渠道的速度、可用性或输出质量。模型、价格、倍率和可用渠道始终以 Anc1ent 控制台实时显示为准。

问题排查 / 认证与 API Key

401、403 与 API Key 排查

认证错误优先检查 Key、地址和模型分组。不要把完整 Key 发给任何人，即使是排障截图也应打码。

401 Invalid API Key

确认请求头是 Authorization: Bearer YOUR_KEY。
确认没有复制到空格、换行，且未把上游 Key、兑换码当成站内 API Key。
在控制台确认该 Key 未停用；必要时新建一把专用 Key 后重新测试。

403 Upstream access forbidden

确认该 API Key 选择的分组包含目标模型。
回到控制台确认模型与渠道当前在线。
复制控制台显示的模型 ID，避免用旧名称或猜测名称。

Key 泄露立即在控制台停用泄露 Key，创建新 Key 并更新所有客户端。公开过的 Key 不应继续使用。

问题排查 / 请求与渠道

404、429、502、503 排查

先记录错误文字、请求时间、客户端、模型和 Key 分组。不要在短时间内连续高速重试。

错误	常见原因	处理方式
`404`	地址或路径拼接错误；模型不存在	检查是否重复添加 `/v1`；从控制台复制模型 ID
`429`	并发、余额、额度或渠道限制	降低并发，检查余额、分组和渠道状态
`502`	上游渠道拒绝或临时失败	检查模型渠道状态，稍后重试或切换可用模型
`503`	服务或上游暂不可用	等待后再试，避免持续高频重试

联系人工客服前

准备注册邮箱、发生时间、客户端、模型、分组、完整错误文字或脱敏截图。不要发送完整 API Key、密码或 Cookie。