跳至主要內容

手动配置

2026/7/28大约 9 分钟

手动配置教程

适用于无法使用 CC-Switch / Codex++ 等特殊环境，直接编辑各工具的配置文件进行接入。

前置准备：环境搭建

大多数 AI 编程工具（Codex、Claude Code、OpenCode、MimoCode 等）基于 Node.js 构建。如果你来自 GNU/Linux 非前端领域，可能需要先搭建 Node.js 运行环境，再安装这些工具。

第一步：安装 Node.js

推荐使用 nvm（Node Version Manager）在 macOS 和 Linux 上安装 Node.js，可方便切换版本。

终端 — 安装 nvm 和 Node.js
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

# 重启终端，安装最新 LTS 版 Node.js
nvm install --lts

# 验证安装
node -v
npm -v

Windows 上可使用 nvm-winget（通过 winget）或 fnm（Fast Node Manager）。

PowerShell — 安装 Node.js
# 方案 A：通过 winget 安装 nvm-windows
winget install CoreyButler.NVMforWindows

# 重启 PowerShell，安装最新 LTS
nvm install lts
nvm use lts

# 方案 B：使用 fnm（更快，跨平台）
winget install Schniz.fnm

# 重启 PowerShell，安装最新 LTS
fnm install --lts
fnm use lts

# 验证安装
node -v
npm -v

第二步：配置 npm 镜像（国内加速）

如果你在中国大陆，默认 npm 源可能较慢或不稳定，建议切换到国内镜像：

终端 — 配置 npm 镜像
# 设置淘宝镜像（国内用户推荐）
npm config set registry https://registry.npmmirror.com

# 验证配置
npm config get registry
# 应输出：https://registry.npmmirror.com/
终端 — 恢复默认源
# 如需恢复默认源：
npm config set registry https://registry.npmjs.org

第三步：验证环境

终端 — 验证 Node.js 环境
# 检查 Node.js 版本（应为 v18+）
node -v

# 检查 npm 版本
npm -v

# 测试 npm 连通性
npm ping

💡 Node.js 版本要求

大多数 AI 编程工具要求 Node.js v18 或更高版本。如果版本低于 v18，请使用 nvm 升级或从 nodejs.org 下载最新 LTS。

第四步：安装 AI 编程工具

Node.js 就绪后，全局安装你需要的 AI 编程工具：

终端 — 安装 AI 编程工具
# Codex (OpenAI)
npm install -g @openai/codex

# Claude Code (Anthropic)
npm install -g @anthropic-ai/claude-code

# OpenCode
npm install -g opencode-ai

# Hermes
npm install -g @hermes-ai/cli

⚠️ MimoCode 平台差异

npm install 成功输出

👆 当 npm 输出类似“added packages”的成功信息时，说明全局 CLI 工具已经安装完成，可以在终端中直接启动。

MimoCode 需要安装平台专属包，请根据你的操作系统选择正确的命令：

平台安装命令
Windowsnpm install -g @mimo-ai/cli @mimo-ai/mimocode-windows-x64
GNU/Linuxnpm install -g @mimo-ai/cli
macOSnpm install -g @mimo-ai/cli
Unix官方未明确标注 Unix 安装方式，建议联系客服 quickapi@lz-0315.com 获取支持。

CC-Switch 设置参考

作为参考，下图为 CC-Switch 配置界面，展示了 QuickAPI 集成设置：

CC-Switch 设置

👆 这是 CC-Switch 设置面板，包含 QuickAPI 配置（base_url、api_key、模型选择）。

通用配置参数

无论使用哪个工具，以下参数是通用的：

参数值说明
API Base URLhttps://api.quickapi.store/v1默认接入地址
API Key你的 API Key从控制台获取
模型名称参考模型广场实时模型列表

TUI 版与 APP 版的区别

部分 AI 编程工具提供两种版本，配置方式略有不同：

版本说明安装方式适用场景
TUI 版终端用户界面（Terminal UI），命令行运行通过 npm/pip 包管理器安装，或下载二进制文件服务器、WSL、远程开发环境
APP 版桌面应用程序（Desktop App），图形界面从官网下载安装包安装本地桌面环境
💡 建议

如果你在服务器或远程环境中使用，推荐安装 TUI 版；如果是本地桌面使用，APP 版体验更佳。

Codex 手动配置

TUI 版

方法一：环境变量

终端 — Linux / macOS 环境变量
# Linux / macOS
export OPENAI_BASE_URL="https://api.quickapi.store/v1"
export OPENAI_API_KEY="YOUR_API_KEY"

# Windows PowerShell
$env:OPENAI_BASE_URL="https://api.quickapi.store/v1"
$env:OPENAI_API_KEY="YOUR_API_KEY"
Codex TUI 终端运行界面

👆 配置完成后，在终端运行 codex。如果 TUI 正常打开，说明 Codex 已经接入 QuickAPI。

方法二：配置文件

在 ~/.codex/config.toml 中添加：

终端 — 编辑 ~/.codex/config.toml
[api]
base_url = "https://api.quickapi.store/v1"
key = "YOUR_API_KEY"

APP 版

从 OpenAI 官网下载桌面应用，然后在设置中配置：

Codex APP — 设置步骤
  1. 打开 Codex APP，进入 Settings（设置）
  2. 找到 API Configuration 或 Custom Endpoint
  3. 填入：
    • API Base URL: https://api.quickapi.store/v1
    • API Key: YOUR_API_KEY
  4. 保存并重启应用

Claude Code 手动配置

TUI 版

环境变量

终端 — Linux / macOS 环境变量
# Linux / macOS
export ANTHROPIC_BASE_URL="https://api.quickapi.store/v1"
export ANTHROPIC_API_KEY="YOUR_API_KEY"

# Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://api.quickapi.store/v1"
$env:ANTHROPIC_API_KEY="YOUR_API_KEY"
Claude Code TUI 终端运行界面

👆 设置环境变量后运行 claude。终端界面正常出现，就说明 Claude Code 可以通过 QuickAPI 调用模型。

配置文件

在 ~/.claude/config.json 中添加：

终端 — 编辑 ~/.claude/config.json
{
  "apiUrl": "https://api.quickapi.store/v1",
  "apiKey": "YOUR_API_KEY"
}

APP 版

从 Anthropic 官网下载桌面应用，然后在设置中配置：

Claude Code APP — 设置步骤
  1. 打开 Claude Code APP，进入 Settings（设置）
  2. 找到 API Configuration 或 Custom Endpoint
  3. 填入：
    • API Base URL: https://api.quickapi.store/v1
    • API Key: YOUR_API_KEY
  4. 保存并重启应用

VSCode 插件手动配置

Continue

在 VSCode 设置（settings.json）中添加：

VSCode — settings.json
{
  "continue.openAiUrl": "https://api.quickapi.store/v1",
  "continue.apiKey": "YOUR_API_KEY",
  "continue.model": "gpt-4o-mini"
}

Codium

在 VSCode 设置中添加：

VSCode — settings.json
{
  "codium.apiBaseUrl": "https://api.quickapi.store/v1",
  "codium.apiKey": "YOUR_API_KEY"
}

Roocode

在 VSCode 设置中添加：

VSCode — settings.json
{
  "roocode.apiBaseUrl": "https://api.quickapi.store/v1",
  "roocode.apiKey": "YOUR_API_KEY",
  "roocode.model": "gpt-4o-mini"
}

VSCode Copilot（OpenAI 兼容插件）

VSCode — settings.json
{
  "copilot.openai.apiBaseUrl": "https://api.quickapi.store/v1",
  "copilot.openai.apiKey": "YOUR_API_KEY",
  "copilot.openai.model": "gpt-4o-mini"
}

Hermes 手动配置

环境变量

终端 — 环境变量
export OPENAI_BASE_URL="https://api.quickapi.store/v1"
export OPENAI_API_KEY="YOUR_API_KEY"

配置文件

在 Hermes 配置目录中创建或编辑 config.json：

终端 — config.json
{
  "api_base": "https://api.quickapi.store/v1",
  "api_key": "YOUR_API_KEY",
  "model": "gpt-4o-mini"
}

OpenClaw 手动配置

环境变量

终端 — 环境变量
export OPENAI_BASE_URL="https://api.quickapi.store/v1"
export OPENAI_API_KEY="YOUR_API_KEY"

配置文件

在 OpenClaw 配置目录中编辑：

终端 — config.json
{
  "api": {
    "base_url": "https://api.quickapi.store/v1",
    "api_key": "YOUR_API_KEY"
  }
}

OpenCode 手动配置

TUI 版

环境变量

终端 — Linux / macOS 环境变量
# Linux / macOS
export OPENAI_BASE_URL="https://api.quickapi.store/v1"
export OPENAI_API_KEY="YOUR_API_KEY"

# Windows PowerShell
$env:OPENAI_BASE_URL="https://api.quickapi.store/v1"
$env:OPENAI_API_KEY="YOUR_API_KEY"
OpenCode TUI 终端运行界面

👆 配置完成后运行 opencode。看到 TUI 界面说明 OpenCode 已经读取 QuickAPI 地址和 Key。

配置文件

在 OpenCode 配置文件中添加：

终端 — config.json
{
  "api_base": "https://api.quickapi.store/v1",
  "api_key": "YOUR_API_KEY",
  "model": "gpt-4o-mini"
}

APP 版

从官网下载桌面应用，然后在设置中配置：

OpenCode APP — 设置步骤
  1. 打开 OpenCode APP，进入 Settings（设置）
  2. 找到 API Configuration 或 Custom Endpoint
  3. 填入：
    • API Base URL: https://api.quickapi.store/v1
    • API Key: YOUR_API_KEY
  4. 保存并重启应用

MimoCode 手动配置

⚠️ 平台专属安装

配置前请确保已使用正确的平台包安装 MimoCode：

平台安装命令
Windowsnpm install -g @mimo-ai/cli @mimo-ai/mimocode-windows-x64
GNU/Linuxnpm install -g @mimo-ai/cli
macOSnpm install -g @mimo-ai/cli
Unix官方未明确标注 Unix 安装方式，建议联系 quickapi@lz-0315.com 获取支持。

环境变量

终端 — Linux / macOS 环境变量
# Linux / macOS
export OPENAI_BASE_URL="https://api.quickapi.store/v1"
export OPENAI_API_KEY="YOUR_API_KEY"

# Windows PowerShell
$env:OPENAI_BASE_URL="https://api.quickapi.store/v1"
$env:OPENAI_API_KEY="YOUR_API_KEY"

配置文件

在 MimoCode 配置文件中添加：

终端 — config.json
{
  "api_base": "https://api.quickapi.store/v1",
  "api_key": "YOUR_API_KEY",
  "model": "gpt-4o-mini"
}

个人安全设置（访问令牌）

查询账户余额需要访问令牌（Access Token），而非 API Key。在个人安全设置中获取：

个人资料页面

👆 在 QuickAPI 控制台中进入 个人安全设置，获取你的访问令牌。

接入节点选择

根据网络环境选择最优节点：

接入方式Base URL适用场景
北京腾讯云 → 阿里云 ESAhttps://api-bj.quickapi.store/v1华北地区
直接到阿里云 ESAhttps://api.quickapi.store/v1默认推荐，全国通用
香港 Cloudflare Tunnelhttps://quickapi.lz-0315.com/v1海外/港澳台
IX 直链腾讯云服务器api-bj.lz-0315.com/v1相当于直连北京腾讯云（通过 IX 骨干网）

验证配置

配置完成后，可以通过以下方式验证：

curl 测试

终端 — curl 测试
curl https://api.quickapi.store/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

返回模型列表即表示配置成功。

curl 模型列表返回结果

👆 如果能看到 JSON 格式的模型列表，说明 Base URL 和 API Key 都配置正确。

Python 测试

终端 — Python 测试
from openai import OpenAI

client = OpenAI(
    base_url="https://api.quickapi.store/v1",
    api_key="YOUR_API_KEY"
)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Hello"}]
)
print(response.choices[0].message.content)

常见问题

Q: 配置后无法连接怎么办？

A: 请检查：

  1. API Key 是否正确
  2. Base URL 是否完整（包含 /v1）
  3. 网络是否正常，尝试切换接入节点

Q: 如何切换模型？

A: 在工具设置中修改模型名称即可，支持的模型列表请访问 模型广场。

Q: 多个工具可以共用一个 API Key 吗？

A: 可以，所有工具共享同一个 API Key 和配额。

Q: 环境变量和配置文件哪个优先级高？

A: 通常情况下环境变量优先级高于配置文件，具体取决于各工具的实现。

Q: TUI 版和 APP 版配置有什么区别？

A: TUI 版通过环境变量或配置文件进行配置；APP 版通过图形界面的设置页面配置。最终效果相同，只是配置方式不同。

Q: 我是 GNU/Linux 用户，无法安装 CC-Switch 怎么办？

A: 请直接按照本教程手动配置。TUI 版工具（如 Codex TUI、Claude Code TUI）在 GNU/Linux 上运行良好，通过环境变量即可快速接入。

Q: 我不熟悉 Node.js / npm，需要学习吗？

A: 只需掌握基础命令即可。按照上方前置准备：环境搭建章节操作，即可完成 Node.js 安装、镜像配置和工具安装（npm install -g），无需深入了解 Node.js。

最近更新:
贡献者: longzheng268,QiCheng Wang