Guides on 4Router Docs

Cherry Studio

Mon, 01 Jan 0001 00:00:00 +0000

Cherry Studio 适合把多个模型统一接到一个桌面客户端里管理。对于大多数普通用户，这是最省事的一种接入方式。

更新基准：本文示例按 2026-04-10 当前平台公开模型与分组编写。

(一) 接入前准备

一个可用的 sk-... 令牌
至少一个你准备使用的模型名称
已安装的 Cherry Studio 客户端

如果你还没有安装客户端，可以先下载 Cherry Studio：

https://docs.cherry-ai.com/docs/en-us/cherry-studio/download

(二) 添加 4Router 服务商

打开 Cherry Studio 后，新增一个自定义服务商，按下面填写：

字段	建议值
服务商名称	`4Router`
协议 / 类型	`OpenAI`
API Key	你的 `sk-...`
API 地址	`https://4router.net` 或 `https://4router.net/v1`

如果你的 Cherry Studio 版本要求填写完整 OpenAI 兼容地址，优先填：

1https://4router.net/v1

如果它要求的是站点根地址，再填：

1https://4router.net

(三) 添加模型

保存之后，进入这个服务商的模型管理页面，把你要用的模型手动加进去。

建议优先按分组加模型：

AppCodex：gpt-5.4、gpt-5.4-mini
AppClaude：claude-opus-4-6、claude-sonnet-4-6

如果你在控制台或令牌页面看到了分组选项，通常可以这样理解：

AppCodex：给 GPT / Codex 系列模型使用
AppClaude：给 Claude 系列模型使用

(四) 推荐操作顺序

打开 设置
进入 模型服务
新增一个 自定义服务商
按上面的字段填写 4Router
保存
进入模型管理，手动添加模型名称
新建对话并切换到刚添加的模型

(五) 第一次测试

建议先各测一条：

Claude Code

Mon, 01 Jan 0001 00:00:00 +0000

Claude Code 建议按平台选教程，不同系统下的安装、环境变量和配置文件位置都不一样。

更新基准：本文示例按 2026-04-10 当前平台公开模型与分组编写。

先选平台

接入前你需要准备

一个 4Router 账户
一个可用的 sk-... 令牌
Node.js 18 或更高版本
Claude Code 客户端

Claude Code 这一类客户端怎么填

网关地址：https://4router.net
令牌：你的 sk-...
分组：优先确认你的令牌可用 AppClaude

不要把地址直接写成 /v1/messages，客户端会自己拼接口路径。

当前推荐模型

首选：claude-opus-4-6
更均衡的选择：claude-sonnet-4-6
更轻量：claude-haiku-4-5-20251001

建议阅读顺序

先看对应系统的安装方式
再看编辑器或插件集成页面
按页面里的配置方式写入 settings.json 或环境变量
最后照着页面里的最小测试命令启动一次 claude

Claude Code JetBrains

Mon, 01 Jan 0001 00:00:00 +0000

当前建议分组：AppClaude 当前建议模型：claude-opus-4-6

在阅读本页之前，请先完成你所在系统的 Claude Code CLI 配置，并确认在终端里直接运行 claude 没有问题。

(一) 安装 JetBrains IDE

适用于 IntelliJ IDEA、PyCharm、GoLand、WebStorm 等 JetBrains IDE。

安装你正在使用的 JetBrains IDE
打开目标项目

(二) 最稳妥的接入方式

Claude Code 在 JetBrains 里最稳妥的用法，是先把本机 CLI 配好，然后直接在 IDE 自带终端里运行：

1claude

这样不依赖额外插件，也最接近你在终端中的真实行为。

(三) 如果你使用插件集成

如果你安装了 Claude Code 相关插件，优先确认两件事：

插件调用的是本地 claude 命令
你的 ~/.claude/settings.json 或系统环境变量已经完成配置

只要 CLI 已经能走 4Router，大多数插件集成也会复用这套本地配置。

(四) 推荐测试方式

先打开 JetBrains 内置终端，执行：

1claude

然后发送一个最短测试：

1如果你已经接到 4Router，请只回复：AppClaude 已连接

确认 CLI 正常后，再回到插件面板里测试。

Claude Code KiloRooCode

Mon, 01 Jan 0001 00:00:00 +0000

当前建议分组：AppClaude 当前建议模型：claude-opus-4-6

在阅读本页之前，请先完成你所在系统的 Claude Code CLI 配置，并确认在终端里直接运行 claude 没有问题。

(一) 适用场景

这页适用于你在 VSCode、Cursor 或兼容编辑器中使用：

KiloCode
RooCode

并希望底层仍然走本机的 Claude Code CLI。

(二) 推荐配置

打开 KiloCode / RooCode 的设置页，按下面选择：

字段	建议值
API Provider	`Claude Code`
Claude Code Path	一般留空
Model	`claude-opus-4-6`

如果你更想要更快的响应速度，再把模型切到 claude-sonnet-4-6。

如果你确实改过本机 claude 命令路径，再手动填写路径。

(三) 为什么这样配

因为这里不是直接让 RooCode 自己去连 4Router，而是让它复用你已经配置好的 Claude Code CLI。

只要本机 claude 已经能正常走：

1https://4router.net

这里通常就不需要再重复配置一套网关。

(四) 第一次测试

建议先在普通终端里执行：

1claude

确认没问题之后，再回到 KiloCode / RooCode 里发一个最短请求。

Claude Code Linux

Mon, 01 Jan 0001 00:00:00 +0000

当前建议分组：AppClaude 当前建议模型：claude-opus-4-6

(一) 安装 Node.js 环境

Linux 安装方法

方法一：NodeSource

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

方法二：系统包管理器

1sudo apt update
2sudo apt install nodejs npm

验证安装：

1node --version
2npm --version

(二) 安装 Claude Code

1npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

如果你当前用户没有全局安装权限，可以用：

1sudo npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

验证安装：

Claude Code Mac

Mon, 01 Jan 0001 00:00:00 +0000

当前建议分组：AppClaude 当前建议模型：claude-opus-4-6

(一) 安装 Node.js 环境

方法一：Homebrew

1brew install node

方法二：官网下载

打开 https://nodejs.org/
下载 LTS 安装包
按默认选项安装

验证安装：

1node --version
2npm --version

(二) 安装 Claude Code

1npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

验证安装：

1claude --version

(三) 配置 Claude Code

方法一：写入 ~/.zshrc

1echo 'export ANTHROPIC_BASE_URL="https://4router.net"' >> ~/.zshrc
2echo 'export ANTHROPIC_AUTH_TOKEN="sk-REPLACE_ME"' >> ~/.zshrc
3source ~/.zshrc

方法二：编辑 ~/.claude/settings.json

1{
2  "env": {
3    "ANTHROPIC_BASE_URL": "https://4router.net",
4    "ANTHROPIC_AUTH_TOKEN": "sk-REPLACE_ME",
5    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
6  }
7}

(四) 开始使用 Claude Code

1claude

第一次建议只做一个最小测试：

Claude Code VSCode

Mon, 01 Jan 0001 00:00:00 +0000

当前建议分组：AppClaude 当前建议模型：claude-opus-4-6

在阅读本页之前，请先完成你所在系统的 Claude Code CLI 配置，并确认在终端里直接运行 claude 没有问题。

(一) 安装 VSCode

打开 https://code.visualstudio.com/
安装 VSCode 1.75.2 或更新版本

(二) 安装 Claude Code 相关扩展

打开 VSCode 扩展市场，搜索：

1Claude Code

安装后重启 VSCode。

(三) 配置 .claude/config.json

打开你的 .claude 目录：

Windows：C:\Users\你的用户名\.claude
macOS / Linux：~/.claude

创建或编辑 config.json，写入：

1{
2  "primaryApiKey": "4router"
3}

这里的值不需要填写真实密钥，只要这个字段存在即可。

注意这个文件是：

1config.json

不是：

1settings.json

settings.json 仍然负责你的 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 配置。

Claude Code Windows

Mon, 01 Jan 0001 00:00:00 +0000

当前建议分组：AppClaude 当前建议模型：claude-opus-4-6

(一) 安装 Node.js 环境

Windows 安装方法

方法一：官网下载

打开 https://nodejs.org/
下载 LTS 版本
双击 .msi 安装包
按默认选项完成安装

方法二：使用包管理器

1# Chocolatey
2choco install nodejs
3
4# Scoop
5scoop install nodejs

验证安装

1node --version
2npm --version

(二) 安装 Claude Code

1npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

验证是否安装成功：

1claude --version

(三) 配置 Claude Code

方法一：编辑 settings.json

打开 C:\Users\你的用户名\.claude\settings.json，如果文件不存在就手动创建。

Codex

Mon, 01 Jan 0001 00:00:00 +0000

Codex 建议按平台阅读教程。不同系统下的 Node.js 安装方式、配置文件路径和环境变量写法都有差异。

更新基准：本文示例按 2026-04-10 当前平台公开模型与分组编写。

先选平台

接入前你需要准备

一个 4Router 账户
一个可用的 sk-... 令牌
Node.js 18 或更高版本
可用的 Codex 模型名称

Codex 客户端怎么接 4Router

Codex 走的是 Responses API，因此配置时建议使用：

Base URL：https://4router.net/v1
wire_api = "responses"
分组：优先确认你的令牌可用 AppCodex
模型名：优先 gpt-5.4

建议阅读顺序

先装好 Node.js
再装 Codex
写 config.toml
再进入编辑器或 IDE 集成页面
配置 API Key
用 codex 做一次最小测试

Codex JetBrains

Mon, 01 Jan 0001 00:00:00 +0000

当前建议分组：AppCodex 当前建议模型：gpt-5.4

在阅读本页之前，请先完成你所在系统的 Codex CLI 配置，并确认在终端里直接运行 codex 没有问题。

(一) 安装 JetBrains IDE

适用于 IntelliJ IDEA、PyCharm、GoLand、WebStorm 等 JetBrains IDE。

(二) 最稳妥的使用方式

Codex 在 JetBrains 里最稳妥的使用方式，是直接打开 IDE 自带终端并运行：

1codex

这样可以直接复用你已经配置好的：

~/.codex/config.toml
4ROUTER_API_KEY

(三) 如果你使用 JetBrains 里的 Codex 相关集成

如果你装了 Codex 相关插件或 AI 面板集成，优先确认它是否复用了本机 Codex 配置。

关键点仍然只有三项：

base_url = "https://4router.net/v1"
wire_api = "responses"
环境变量 4ROUTER_API_KEY 已经存在

(四) 推荐测试步骤

先在系统终端运行一次 codex
再在 JetBrains 内置终端运行一次 codex
最后再测试插件或面板集成

最小测试内容：

1Print a short hello from the AppCodex group on 4Router.

(五) 常见问题

系统终端正常，IDE 终端不正常：通常是 JetBrains 启动时没有继承你的环境变量。
插件里报找不到模型：先退回 CLI 检查 config.toml。
只有聊天能用，代理任务不能用：优先检查是否真的走了 Responses API。
请求失败：先去控制台确认当前令牌能否使用 AppCodex 分组。

Codex Linux

Mon, 01 Jan 0001 00:00:00 +0000

当前建议分组：AppCodex 当前建议模型：gpt-5.4

(一) 安装 Node.js 环境

方法一：NodeSource

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

方法二：系统包管理器

1sudo apt update
2sudo apt install nodejs npm

验证安装：

1node --version
2npm --version

(二) 安装 Codex

1npm install -g @openai/codex --registry=https://registry.npmmirror.com

如果你遇到权限问题：

1sudo npm install -g @openai/codex --registry=https://registry.npmmirror.com

验证安装：

Codex Mac

Mon, 01 Jan 0001 00:00:00 +0000

当前建议分组：AppCodex 当前建议模型：gpt-5.4

(一) 安装 Node.js 环境

方法一：Homebrew

1brew install node

方法二：官网下载

打开 https://nodejs.org/
下载 LTS 安装包
按默认选项安装

验证安装：

1node --version
2npm --version

(二) 安装 Codex

1npm install -g @openai/codex --registry=https://registry.npmmirror.com

验证安装：

1codex --version

(三) 配置 Codex

编辑 ~/.codex/config.toml：

 1disable_response_storage = true
 2model = "gpt-5.4"
 3model_reasoning_effort = "high"
 4model_provider = "4router"
 5
 6[model_providers.4router]
 7name = "4Router"
 8base_url = "https://4router.net/v1"
 9env_key = "4ROUTER_API_KEY"
10wire_api = "responses"

把 Key 写入 ~/.zshrc：

Codex VSCode

Mon, 01 Jan 0001 00:00:00 +0000

当前建议分组：AppCodex 当前建议模型：gpt-5.4

在阅读本页之前，请先完成你所在系统的 Codex CLI 配置，并确认在终端里直接运行 codex 没有问题。

(一) 安装 VSCode

打开 https://code.visualstudio.com/
安装 VSCode 1.75.2 或更新版本

(二) 安装 Codex 扩展

打开 VSCode 扩展市场，搜索：

1Codex

安装后重启 VSCode。

(三) 准备本地配置

Codex 的 VSCode 集成通常会复用本机的 ~/.codex/config.toml。

确认你的配置文件至少包含：

1model_provider = "4router"
2model = "gpt-5.4"
3
4[model_providers.4router]
5name = "4Router"
6base_url = "https://4router.net/v1"
7env_key = "4ROUTER_API_KEY"
8wire_api = "responses"

然后确认环境变量已经存在：

Codex Windows

Mon, 01 Jan 0001 00:00:00 +0000

当前建议分组：AppCodex 当前建议模型：gpt-5.4

(一) 安装 Node.js 环境

Windows 安装方法

方法一：官网下载

打开 https://nodejs.org/
下载 LTS 版本
双击安装包完成安装

方法二：包管理器

1choco install nodejs
2scoop install nodejs

验证安装：

1node --version
2npm --version

(二) 安装 Codex

1npm install -g @openai/codex --registry=https://registry.npmmirror.com

验证安装：

1codex --version

(三) 配置 Codex

打开 C:\Users\你的用户名\.codex\config.toml，如果文件不存在就手动创建。

写入：

 1disable_response_storage = true
 2model = "gpt-5.4"
 3model_reasoning_effort = "high"
 4model_provider = "4router"
 5
 6[model_providers.4router]
 7name = "4Router"
 8base_url = "https://4router.net/v1"
 9env_key = "4ROUTER_API_KEY"
10wire_api = "responses"

然后设置环境变量：

一键配置

Mon, 01 Jan 0001 00:00:00 +0000

下载4RouterAi软件，登录账号即可使用，无需配置key以及模型参数等即可使用ClaudeCode和Codex。

如果系统提示风险忽略即可，软件由github action自动编译，无安全风险。

1. 下载软件

点击下方下载软件

点此下载

如果下载失败可以加群1094738104获取安装包

下载后直接安装即可

2. 软件使用教程

按照上图完成登录即可直接使用claude code和codex，模型和参数以及其余优化配置均会自动配置完成。

自动配置采用AppCodex和AppClaude这两个分组，倍率由路由情况动态变化，使用熟练后可以切换到其他分组以降低成本(模型分组说明)

手动配置

Mon, 01 Jan 0001 00:00:00 +0000

如果你是第一次使用，推荐使用一键配置(点击)

1. 先拿到 Key

打开 https://4router.net 注册或登录。
进入控制台创建一个新的 API Key。
记下你准备使用的模型名称。

2. 记住这两个地址

OpenAI 兼容 Base URL：https://4router.net/v1
Claude / Anthropic 兼容 Base URL：https://4router.net

3. 先确认模型分组

当前推荐从这几组模型开始：

AppCodex：gpt-5.4、gpt-5.4-mini、gpt-5.3-codex
AppClaude：claude-opus-4-6、claude-sonnet-4-6

按设备和工具查看

工具	Windows	Mac	Linux	VSCode	JetBrains	KiloCode / RooCode
Cherry Studio	桌面端接入	桌面端接入	桌面端接入	桌面端接入	桌面端接入	-
Claude Code	Windows 教程	Mac 教程	Linux 教程	VSCode 教程	JetBrains 教程	使用教程
Codex	Windows 教程	Mac 教程	Linux 教程	VSCode 教程	JetBrains 教程	-

常见问题

401 或 invalid_api_key：通常是 Key 填错、复制时多了空格，或该 Key 已被禁用。
model_not_found：模型名称写错，或者该模型当前不在你的账户可用范围内。
Claude 模型请求失败但 GPT 正常：先检查你的令牌是否真的可用 AppClaude 分组。
GPT 模型请求失败但 Claude 正常：先检查你的令牌是否真的可用 AppCodex 分组。
客户端连不上：先确认你填的是正确的 Base URL，不同客户端不一定一样。
API Key 是否有效、目标模型是否在你当前账户可用范围内、客户端里填写的 Base URL 是否正确——遇到问题时先回到控制台检查这三件事。

模型分组

Mon, 01 Jan 0001 00:00:00 +0000

分组说明

分组	分组说明	当前推荐模型	是否支持第三方软件接入
`AppCodex`	专用于4RouterAi软件中codex的gpt模型，通过路由策略保障一定程度的可用性	根据app内推荐即可	☑️
`AppClaude`	用于4RouterAi软件中claudecode的claude模型，通过路由策略保障一定程度的可用性	根据app内推荐即可	❌
`ClaudeMax`	ClaudeCode Max满血号池，高性能使用，1M超长上下文	`claude-opus-4-6`、`claude-sonnet-4-6`、`claude-haiku-4-5-20251001`	❌
`GptPro`	Gpt Pro满血号池，高性能使用，支持fast模式和spark独占模型	`gpt-5.4`、`gpt-5.3-codex-spark`等	☑️
`GeminiAnti`	Google Ultra号池，多模态优选，支持nano banana系列模型	`gemini-3.1-pro-preview`、`gemini-3.1-flash-image`等	☑️
`ClaudeApi`	ClaudeCode Api，满血接入，不保障稳定性	`claude-opus-4-6`、`claude-sonnet-4-6`、`claude-haiku-4-5-20251001`	☑️
`ClaudeAnti`	Antigravity2Api，1M上下文，延迟偏高	`claude-opus-4-6`、`claude-sonnet-4-6`、`claude-haiku-4-5-20251001`	☑️

第三方软件接入指在非原生软件使用，如ClaudeMax只能在ClaudeCode和4RouterAI这两个软件平台使用。