# AI 接口配置

本教程介绍如何在本机配置 AI 编程工具环境，包括 Node.js 运行时，以及 Codex、ZCode、Claude Code 三种 AI 工具的安装与接口配置。

提示

后续的 Codex、ZCode、Claude Code 均依赖 Node.js 运行环境。请先完成 Node.js 安装教程，再继续各工具配置。

# Node.js 环境安装

在 Windows、macOS、Linux 安装 Node.js LTS，并验证 node/npm 命令可用。

# Windows

方法一：官方下载（推荐）

前往 Node.js 官网 (opens new window) 下载 LTS 版本，双击安装包按提示安装即可。

方法二：使用 Chocolatey

choco install nodejs-lts

方法三：使用 Scoop

scoop install nodejs-lts

# macOS

方法一：使用 Homebrew（推荐）

brew install node

方法二：官方下载

前往 Node.js 官网 (opens new window) 下载 macOS 安装包。

# Linux

Ubuntu / Debian：

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

CentOS / RHEL：

curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo yum install -y nodejs

# 验证安装

安装完成后，在终端执行：

node --version
npm --version

如果能输出版本号，说明 Node.js 与 npm 已可用。

# Codex 配置

Codex 是 OpenAI 推出的 AI 编程助手，通过 npm 全局安装，依赖 Node.js 环境。

# 安装 Codex

npm install -g @openai/codex

# 配置接口

Codex 通过环境变量指定接口地址、密钥与模型。在终端执行：

export OPENAI_API_KEY=your_api_key
export OPENAI_BASE_URL=https://api.crmeb.net/v1
export OPENAI_MODEL=your-model-name

变量	说明
OPENAI_API_KEY	接口鉴权密钥
OPENAI_BASE_URL	接口地址，OpenAI 兼容格式，以 /v1 结尾
OPENAI_MODEL	使用的模型名称

# 验证 Codex

codex --version
codex exec "你好，请介绍一下你自己"

能正常返回模型输出即配置成功。

# ZCode 配置

ZCode 是交互式 AI 编程助手，通过 npm 全局安装，依赖 Node.js 环境。

# 安装 ZCode

npm install -g zcode

# 配置接口

ZCode 使用配置文件指定接口，配置文件位于 ~/.zcode/config.json：

{
  "provider": "custom",
  "baseUrl": "https://api.crmeb.net/v1",
  "apiKey": "your_api_key",
  "model": "your-model-name"
}

字段	说明
provider	服务商类型，使用自建网关时填 custom
baseUrl	接口地址，OpenAI 兼容格式，以 /v1 结尾
apiKey	接口鉴权密钥
model	使用的模型名称

# 验证 ZCode

zcode --version

启动后输入一句对话，能正常回复即配置成功。

# Claude Code 配置

Claude Code 是 Anthropic 推出的 AI 编程助手，通过 npm 全局安装，依赖 Node.js 环境。

# 安装 Claude Code

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

# 配置接口

Claude Code 通过环境变量指定接口地址、密钥与模型。在终端执行：

export ANTHROPIC_BASE_URL=https://api.crmeb.net/v1
export ANTHROPIC_AUTH_TOKEN=your_api_key
export ANTHROPIC_MODEL=your-model-name

变量	说明
ANTHROPIC_BASE_URL	接口地址，Anthropic 兼容格式
ANTHROPIC_AUTH_TOKEN	接口鉴权密钥
ANTHROPIC_MODEL	使用的模型名称

# 验证 Claude Code

claude --version
claude "你好，请介绍一下你自己"

能正常返回模型输出即配置成功。

# 接口对接说明

AI 网关采用 OpenAI 兼容协议，标准 REST 接口，任何支持自定义接口地址的工具或代码均可直接对接。

# 接口信息

项目	值
接口地址	`https://api.crmeb.net/v1`
鉴权方式	`Authorization: Bearer {API Key}`
协议格式	OpenAI 兼容（/v1/chat/completions）
模型名称	以实际开通的服务为准

# 获取API Key

API Key 以 sk- 开头，获取方式二选一：

调用创建或获取API Key接口获取（已有Key时自动复用）
登录一号通工作台，在 AI 模型管理中查看

# 对话请求示例

curl https://api.crmeb.net/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-name",
    "messages": [
      {"role": "user", "content": "你好"}
    ],
    "stream": false
  }'

# 响应说明

非流式返回结构与 OpenAI 一致：

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "回复内容" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 10, "completion_tokens": 20, "total_tokens": 30 }
}

请求体中 "stream": true 时以 SSE 流式返回，逐段输出 data: {...}，以 data: [DONE] 结束

# 与AI工具的关系

上文 Codex、ZCode、Claude Code 配置中填写的接口地址与密钥，即本网关的地址与 API Key：

Codex / ZCode：OpenAI 兼容协议，接口地址填 https://api.crmeb.net/v1
Claude Code：走 Anthropic 协议，网关已自动适配，无需额外转换
各工具消耗的 tokens 均按 AI 会话服务的套餐余量计费

注意

各工具的接口地址统一为 https://api.crmeb.net/v1，密钥与模型名称以你实际开通的服务为准
环境变量配置仅在当前终端会话生效，如需永久生效请写入 ~/.bashrc 或 ~/.zshrc
更换接口配置后需要重启工具进程才能生效

← 使用说明开通AI会话服务 →