手动配置
2026/7/28大约 4 分钟
手动配置教程
适用于无法使用 CC-Switch / Codex++ 等特殊环境,直接编辑各工具的配置文件进行接入。
通用配置参数
无论使用哪个工具,以下参数是通用的:
| 参数 | 值 | 说明 |
|---|---|---|
| API Base URL | https://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
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/config.toml 中添加:
[api]
base_url = "https://api.quickapi.store/v1"
key = "YOUR_API_KEY"APP 版
从 OpenAI 官网下载桌面应用,然后在设置中配置:
- 打开 Codex APP,进入 Settings(设置)
- 找到 API Configuration 或 Custom Endpoint
- 填入:
- API Base URL:
https://api.quickapi.store/v1 - API Key:
YOUR_API_KEY
- API Base URL:
- 保存并重启应用
Claude Code 手动配置
TUI 版
环境变量
# 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/config.json 中添加:
{
"apiUrl": "https://api.quickapi.store/v1",
"apiKey": "YOUR_API_KEY"
}APP 版
从 Anthropic 官网下载桌面应用,然后在设置中配置:
- 打开 Claude Code APP,进入 Settings(设置)
- 找到 API Configuration 或 Custom Endpoint
- 填入:
- API Base URL:
https://api.quickapi.store/v1 - API Key:
YOUR_API_KEY
- API Base URL:
- 保存并重启应用
VSCode 插件手动配置
Continue
在 VSCode 设置(settings.json)中添加:
{
"continue.openAiUrl": "https://api.quickapi.store/v1",
"continue.apiKey": "YOUR_API_KEY",
"continue.model": "gpt-4o-mini"
}Codium
在 VSCode 设置中添加:
{
"codium.apiBaseUrl": "https://api.quickapi.store/v1",
"codium.apiKey": "YOUR_API_KEY"
}Roocode
在 VSCode 设置中添加:
{
"roocode.apiBaseUrl": "https://api.quickapi.store/v1",
"roocode.apiKey": "YOUR_API_KEY",
"roocode.model": "gpt-4o-mini"
}VSCode Copilot(OpenAI 兼容插件)
{
"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:
{
"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 配置目录中编辑:
{
"api": {
"base_url": "https://api.quickapi.store/v1",
"api_key": "YOUR_API_KEY"
}
}OpenCode 手动配置
TUI 版
环境变量
# 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 配置文件中添加:
{
"api_base": "https://api.quickapi.store/v1",
"api_key": "YOUR_API_KEY",
"model": "gpt-4o-mini"
}APP 版
从官网下载桌面应用,然后在设置中配置:
- 打开 OpenCode APP,进入 Settings(设置)
- 找到 API Configuration 或 Custom Endpoint
- 填入:
- API Base URL:
https://api.quickapi.store/v1 - API Key:
YOUR_API_KEY
- API Base URL:
- 保存并重启应用
MimoCode 手动配置
环境变量
# 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 配置文件中添加:
{
"api_base": "https://api.quickapi.store/v1",
"api_key": "YOUR_API_KEY",
"model": "gpt-4o-mini"
}接入节点选择
根据网络环境选择最优节点:
| 接入方式 | Base URL | 适用场景 |
|---|---|---|
| 北京腾讯云 → 阿里云 ESA | https://api-bj.quickapi.store/v1 | 华北地区 |
| 直接到阿里云 ESA | https://api.quickapi.store/v1 | 默认推荐,全国通用 |
| 香港 Cloudflare Tunnel | https://quickapi.lz-0315.com/v1 | 海外/港澳台 |
| IX 直链腾讯云服务器 | api-bj.lz-0315.com/v1 | 相当于直连北京腾讯云(通过 IX 骨干网) |
验证配置
配置完成后,可以通过以下方式验证:
curl 测试
curl https://api.quickapi.store/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"返回模型列表即表示配置成功。
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: 请检查:
- API Key 是否正确
- Base URL 是否完整(包含
/v1) - 网络是否正常,尝试切换接入节点
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 上运行良好,通过环境变量即可快速接入。

