AI 学习直连教程

ModelGate · AI 学习教程

AI 学习直连教程

从零开始使用 ModelGate 直连各大编程助手

使用说明 这是面向零基础用户的 AI 编程助手直连教程。从注册 ModelGate 开始，贯穿 API Key 创建、环境配置、CC Switch 安装、Codex 和 Claude Code 直连，到最后在 VS Code 中使用。请按序号顺序操作。

官方入口第一部分：ModelGate 账号与 API Key 第二部分：基础环境安装第三部分：安装 CC Switch 第四部分：Codex 快速配置第五部分：Claude Code 快速配置第六部分：在 VS Code 中使用

官方入口与邀请码

官网入口

ModelGate 官网

点击下方链接进入 ModelGate，注册账号即可开始使用。 https://modelgate.app

新用户福利

$5 免费试用额度

新注册用户自动获得 $5 免费试用额度，可用于体验平台所有模型。用完再充值，零门槛上手。

交流反馈

Telegram 用户群

加入 ModelGate 官方 Telegram 群，获取实时服务状态、模型更新通知和技术支持。

反馈群：t.me/+qYf_D73vnBs1Nzkx
官方支持：@ModelGateApp

服务状态

公开状态页

实时查看 API 网关、用户面板、模型路由等核心服务的可用性。

status.modelgate.app

第一部分：ModelGate 账号与 API Key

步骤 1

打开 ModelGate 官网，点击注册。支持邮箱注册（需验证邮箱）或通过GitHub，Linux.Do， Discord 登录。

步骤 2

注册成功后登录后台，进入左侧 令牌管理 页面。

步骤 3

点击 创建密钥，填写名称（如 “Codex” 或 “Claude”），选择对应分组，创建完成后复制保存 Key。

提示建议为每个工具创建专用 Key，方便后续单独统计和排查。创建后先确认 Key 的分组和倍率符合预期，再进入下一步。

第二部分：基础环境安装

开始前请确保以下基础环境已就绪：

Node.js 18+ — 大多数 AI 编程工具依赖 Node.js 运行。从 nodejs.org 下载安装。
Git — 用于版本管理和 AI 工具的代码操作。从 git-scm.com 下载安装。
终端 — macOS 使用 Terminal 或 iTerm2，Windows 使用 PowerShell 或 Windows Terminal。

安装完成后在终端验证：

node --version
npm --version
git --version

第三部分：安装 CC Switch

CC Switch 是一个供应商配置管理工具，可以在 Mac、Windows 和 Linux 上运行。它帮助你集中管理 API 供应商信息，支持 Claude Code、Codex、Hermes、OpenClaw 等主流编程助手的配置导入。请访问 CC Switch 官方网站下载适合你操作系统的版本并安装。Mac 用户可以使用 Homebrew 安装：

brew install --cask ccswitch

安装完成后启动 CC Switch，后续通过 ModelGate 后台页面的「导入 CCS」按钮即可将供应商配置一键写入 CC Switch。

第四部分：Codex 快速配置

Codex 是 OpenAI 出品的 AI 编程代理（CLI 工具），在终端中以对话形式与 AI 协作编码。它支持流行的编程语言和框架，能够读取项目上下文、生成代码、运行命令等。

安装 Codex

npm install -g @openai/codex

创建直连配置文件

创建 ~/.codex/config.toml：

model_provider = "modelgate"
model = "claude-sonnet-4-6"

[model_providers.modelgate]
name = "modelgate"
base_url = "https://modelgate.app/v1"
wire_api = "responses"
requires_openai_auth = true

创建 ~/.codex/auth.json：

{
 "OPENAI_API_KEY": "替换为您的 ModelGate API Key"
}

常用命令

# 启动 Codex 交互模式
codex

# 查看当前模型
codex -m

# 切换模型
codex -m claude-opus-4-8

第五部分：Claude Code 快速配置

Claude Code 是 Anthropic 出品的 AI 编程代理（CLI 工具），在终端中与你协作进行软件工程任务。它可以理解项目结构、编辑代码、运行命令、管理 Git 操作等。

安装 Claude Code

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

创建直连配置文件

编辑 ~/.claude/settings.json：

{
 "env": {
 "ANTHROPIC_AUTH_TOKEN": "替换为您的 ModelGate API Key",
 "ANTHROPIC_BASE_URL": "https://modelgate.app/",
 "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
 },
 "permissions": {
 "allow": [],
 "deny": []
 }
}

常用命令

# 启动交互模式
claude

# 以初始查询启动
claude "解释这个项目"

# 运行单个命令并退出
claude -p "这个函数做什么？"

# 恢复上次对话
claude --continue

# 处理管道内容
cat logs.txt | claude -p "分析这些错误"

第六部分：在 VS Code 中使用

安装 VS Code 插件后，你的 AI 编程助手可以直接在 IDE 中运行，实时查看代码改动并与编辑器交互。

Claude Code + VS Code

安装 Claude Code 后，在 VS Code 的内置终端中启动 claude，插件将被自动安装。也可以直接从 VS Code 扩展市场搜索并安装官方 Claude Code 插件。

Codex + VS Code

Codex 安装完成后，在 VS Code 扩展市场搜索 Codex 并安装官方插件。安装后确保使用 ~/.codex/config.toml 中的 ModelGate 配置，即可在 VS Code 中通过 Codex 面板使用 ModelGate 的模型。

提示在 VS Code 中使用时，建议按 Ctrl+``（或 macOS 的 Cmd+``）打开内置终端，然后直接启动 claude 或 codex。关闭终端标签页即可退出。