43 服务器接入 AI CLI 的中转配置教程

整理时间：2026-08-22。本文面向 43 服务器环境，整理自公开 OpenAI/Claude 兼容中转接入教程，已统一替换为本平台地址，不保留第三方来源信息。

1. 服务根地址与接口格式（区分 OpenAI / Claude）

服务根地址统一为 https://api.nxmes.cn，但不同格式补的路径不一样，不要填混：

接口格式	Base URL	用于哪些客户端
OpenAI 兼容	`https://api.nxmes.cn/v1`	Codex CLI、Cherry Studio、Trae / Cursor / RooCode 等 OpenAI Compatible 客户端
Claude / Anthropic	`https://api.nxmes.cn`（不带 `/v1`）	Claude Code（填到 `ANTHROPIC_BASE_URL`）

易错点：OpenAI 格式要带 /v1；Claude 格式只填根地址，不要加 /v1，否则报 404。

2. 选择分组（重要）

不同模型走不同分组，别用默认分组硬跑，选错易 503 或模型不兼容。创建/编辑令牌时按需给令牌绑定分组。下面按本平台实际分组举例，不是全量清单，具体以令牌页可选分组为准：

用 Claude Code（Claude 系列模型）：选 Kiro 或 Max 分组。两个都是 Claude 系渠道，日常选 Kiro 即可，追求更稳或更强时切 Max。
用 Codex CLI / OpenAI 兼容（GPT 系列）：选 Pro、Puls 分组。两者都是 gpt-5.4 / 5.5 / 5.6 系；Puls 另带 codex-auto-review（适合 Codex 自动审查）。想省钱可看 特价福利 分组。
想要免费额度体验：Free 分组提供 gpt-5.x 免费渠道。
其他模型：Grok（grok-4.x）、DeepSeek-正式版（DeepSeek-V4）、Cursor（composer）、国模（DeepSeek / Qwen / GLM / Kimi 等国产）。

提示：拿不准时，先看令牌绑定分组里已有哪几个可用分组，再按上面对应的模型类型选；选错分组会导致该模型在令牌下不可用或报 503。

3. CLI 安装（按需分开装）

# Claude Code
npm install -g @anthropic-ai/claude-code@latest

# Codex CLI
npm install -g @openai/codex@latest

# Gemini CLI（如需要）
npm install -g @google/gemini-cli@latest

安装后检查版本：

claude --version
codex --version
gemini --version

前置条件：Node.js 18+（推荐 Node.js 22 LTS 或更高）、Git。npm 失败先确认命令行能访问 npm 源。

4. Claude Code 配置

4.1 环境变量方式（不使用 CC Switch）

临时验证（终端内 export）：

export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"
export ANTHROPIC_BASE_URL="https://api.nxmes.cn"
claude

长期使用（写入 shell 配置）：

echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://api.nxmes.cn"' >> ~/.zshrc
source ~/.zshrc

Bash 用 ~/.bashrc。Windows PowerShell 永久生效用 setx 或 PowerShell profile。

systemd 跑服务时，把变量写进 unit 的 [Service] 段，再 systemctl daemon-reload 并重启服务。

跳过权限询问启动：claude --dangerously-skip-permissions。

4.2 settings.json 方式（VS Code / Cursor 插件必用）

插件不读 shell 环境变量，只认 settings.json 的 env 段。位置：

用户级：~/.claude/settings.json（Windows 为 %USERPROFILE%\.claude\settings.json）
项目级：项目根目录 .claude/settings.json（项目级优先）

最小配置：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的令牌",
    "ANTHROPIC_BASE_URL": "https://api.nxmes.cn"
  }
}

若已有其他配置，只合并 env 段，别整段覆盖。

别把令牌提交进 Git 仓库：要入 Git 的项目把令牌放用户级 ~/.claude/settings.json，或写不进库的 .claude/settings.local.json。

4.3 防止跳转官方

CC Switch 配置是否启用、更新后是否重启窗口。
环境变量是否与启动 claude 的同一终端。
ANTHROPIC_BASE_URL 是否为 https://api.nxmes.cn。
必要时检查 ~/.claude.json 的 hasCompletedOnboarding。

4.4 推理强度（/effort）

high：日常复杂任务够用。
xhigh：比 high 更深，可持久化，支持 ultracode 工作流。
max：当前会话生效、不可持久化、与 ultracode 不兼容；只用于单次超吃推理任务。
ultracode：多 agent 工作流（基于 xhigh），适合大型可拆分任务。

想用 ultracode 就别开 max（不兼容）。日常用 xhigh 即可。

Claude Code 默认具备规划能力，复杂任务自动"先规划再执行"；可双击 Shift+Tab 进入 Plan 模式。默认就支持多 agent 协作。

5. Codex CLI 配置

5.1 环境变量方式（临时/长期）

临时：

export OPENAI_API_KEY="sk-你的令牌"
export OPENAI_BASE_URL="https://api.nxmes.cn/v1"

PowerShell 临时：

$env:OPENAI_API_KEY="sk-你的令牌"
$env:OPENAI_BASE_URL="https://api.nxmes.cn/v1"

长期（zsh）：

echo 'export OPENAI_API_KEY="sk-你的令牌"' >> ~/.zshrc
echo 'export OPENAI_BASE_URL="https://api.nxmes.cn/v1"' >> ~/.zshrc

PowerShell 永久：setx OPENAI_API_KEY "sk-你的令牌"、setx OPENAI_BASE_URL "https://api.nxmes.cn/v1"（需重开终端）。

5.2 最终模板（两个文件）

配置写 ~/.codex/config.toml，令牌写 ~/.codex/auth.json，令牌不能写在 config.toml。

~/.codex/config.toml：

model_provider = "custom"
service_tier = "fast"   # 可选，开启 fast

[model_providers.custom]
name = "custom"
base_url = "https://api.nxmes.cn/v1"
wire_api = "responses"
requires_openai_auth = true

令牌用登录命令写入（别手编 auth.json）：

codex login --api-key "sk-你的令牌"

之前登过 ChatGPT 先 codex logout。执行后自动生成 ~/.codex/auth.json。

字段含义：

model_provider = "custom"：不写这行，[model_providers.custom] 等于白写，请求仍打官方。
base_url：OpenAI 兼容地址（带 /v1）。
wire_api = "responses"：Codex 走 Responses 接口。
requires_openai_auth = true：开启后令牌只认 auth.json（环境变量那套失效，二选一）。
service_tier = "fast"：可选，fast 模式 2 或 2.5 倍计费（用 GPT-5.5 时）。TOML 字符串要加引号。

5.3 本地鉴权缓存

~/.codex/auth.json 由客户端自动维护，别手动编辑；清掉需重新登录/配置。

5.4 fast 和百万上下文

Codex 内执行 /fast；GPT/Codex API 层对应 "service_tier": "fast"。
fast 按请求动态计费。
百万上下文超过 272k 部分额外计费，别默认把整个仓库一次性塞进上下文。

图片输入：CLI 里复制到剪贴板后按 Alt+V 粘贴（Ctrl+V 粘不了图）；可拖文件进终端。VS Code Remote-SSH 连接远程服务器时 Alt+V 贴不了图，改用 VS Code 插件贴图。

5.5 防止跳转官方

典型信号：401 报错含 platform.openai.com。排查：

OPENAI_BASE_URL 是否为 https://api.nxmes.cn/v1。
环境变量是否与启动 codex 同一终端。
残留的 OPENAI_API_KEY（系统/.env）会覆盖配置把 key 发去官方，用 echo $OPENAI_API_KEY 检查。
config.toml 位置：~/.codex/config.toml 或 $CODEX_HOME/config.toml。
~/.codex/auth.json 缓存旧 key 不匹配 base_url 也会 401。

在 Codex 里输 /status 可查当前实际生效的 provider / Base URL / 模型。

5.6 multi_agent 与 goal

multi_agent：同时派生多个子 agent 分工处理，适合可拆分大任务，自然语言描述需求即可。
goal：一句话目标变"规划→执行→验证"自循环代理，适合迁移/重构。用 /goal 触发，先用成功判据。

实际默认用 /goal 驱动即可，它会自动调用 multi_agent（Claude Code 默认就有该能力，无需额外开启）。

6. 常见错误排查

错误	含义与处理
401	令牌错误/被删/复制多空格
404	Base URL 填错（Claude 多填 `/v1`、OpenAI 漏 `/v1`）；Codex 别填成 `.../v1/responses`
503	分组/模型/上游暂不可用，或选错分组导致模型不兼容；换对应可用分组或同系列模型
Service temporarily unavailable	换同系列模型、换支持分组、等账号池恢复
context too large	新开会话或减少附加文件，先读关键文件
Unexpected status 404	Codex Base URL 应类似 `https://api.nxmes.cn/v1`

7. 关键数据速查

项	值
OpenAI 兼容 Base URL	`https://api.nxmes.cn/v1`
Claude / Anthropic Base URL	`https://api.nxmes.cn`（不带 /v1）
Claude 环境变量	`ANTHROPIC_AUTH_TOKEN` / `ANTHROPIC_BASE_URL`
Codex 环境变量	`OPENAI_API_KEY` / `OPENAI_BASE_URL`

8. 在 43 服务器落地的注意事项

令牌安全：明文令牌不落库、不入 Git；优先用户级配置或 .local.json。
分组选择：Claude Code 用 Kiro/Max 分组；Codex / OpenAI 兼容用 Pro/Puls 分组；免费体验用 Free。具体见本文"选择分组"一节。
systemd 场景：若本机服务需走 Claude，把环境变量写进 unit [Service] 段后 daemon-reload。
网络：npm 安装失败先排代理；43 服务器访问本中转需确认出网与白名单。
实际在 43 服务器执行任何登录/探测/部署前，按既有授权纪律逐次取得授权。

AI CLI 接入配置教程