企业官网建设流程全解析

如何把 Claude Code Router 本机 Agent 登录态导入为供应商，免手工填 API Key 使用上游

【免费下载链接】claude-code-routerOne local control plane for every AI agent: route across models, fuse new capabilities, orchestrate tools, and stay fully in control.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-router

如果你本机已经用 Claude Code、Codex、ZCode 或 Kimi CLI 登录过上游服务，想在 Claude Code Router（CCR）里复用这份登录态发模型请求，就不必再去申请和粘贴常规 API Key。CCR 在添加供应商时会扫描本机已有的 Agent 登录状态，检测到可复用凭据后，添加弹窗会直接显示对应的导入入口；导入会创建一个普通供应商和配套的 provider plugin，让 CCR 复用本机 Agent 授权访问上游服务。本文介绍从添加供应商、选择导入入口，到用连通性检测和请求日志验证链路可用的完整操作。

前提条件

1. CCR 已安装并可以打开管理界面。桌面应用或 npm CLI 均可；CLI 要求 Node.js 22 或更高版本，安装与启动命令见 安装并启动 CCR。
2. 对应 Agent 在本机已处于登录状态：
   • Claude Code 导入读取的是本机 Claude Code OAuth 凭据，要求存在可用的 access token；
   • Codex 导入读取本机 Codex 登录文件和模型缓存，要求存在 access token 或 refresh token；
   • ZCode 导入读取 ZCode 本机配置中的供应商 API Key、API 地址和模型列表，要求同时存在可用的供应商 Key 和 Base URL；
   • Kimi CLI 导入读取~/.kimi-code/config.toml中的受管 OAuth 登录态或 API Key。

只检测到登录痕迹但没有可用 token 时，导入入口会显示不可导入的原因，处理方式见下文「导入入口不可用时」。

执行导入

1. 进入 CCR 的供应商页面，点击添加供应商。
2. CCR 会扫描本机已有的 Agent 登录状态。检测到可复用凭据后，添加弹窗中会显示对应 Agent 的导入入口，选择它即可，不需要在API 密钥字段里粘贴任何 Key。
3. 等待导入完成。导入创建的是一个普通供应商加配套 provider plugin，之后在供应商列表中可以像普通供应商一样查看和管理它。

导入完成后，四个 Agent 各自的供应商形态如下（字段值来自 供应商配置 文档）：

Codex 的 API 地址由导入自动指向 Codex 后端。账号用量方面：Claude Code 导入会使用 Anthropic OAuth 用量接口，Codex 导入会读取 Codex 额度、余额和 token 统计接口，可以在供应商列表、托盘或账号面板里查看额度状态。

验证链路可用

导入不等于请求一定可调通。按下面两步确认：

1. 检测连通性。在供应商表单中点击检测连通性：CCR 会用当前的 API 地址、认证、协议和所选模型发送一次真实测试请求，检测结果显示每个模型是否可用、命中的协议和上游返回的诊断信息。注意两点：

• 检测请求会限制输出长度，但仍可能产生额外 token 消耗或计入供应商侧请求次数，建议通过要检测的模型只勾选需要确认的模型，不要一次性检查全部；
• 检测结果只用于诊断连通性，不会自动修改模型列表或用量读取配置，供应商的模型仍以表单中的模型选择为准。

2. 发一条真实请求核对日志。在路由规则或 Agent 配置中选择导入的供应商与模型（文档以 Codex 为例：可直接选择Codex API/模型名），保存供应商并启动网关后，用 CCR 打开对应 Agent 发一条消息确认能正常回复，再到请求日志核对请求模型、最终供应商/模型、状态码和耗时。Agent 配置的完整接入方式见 接入 Agent 配置。

导入入口不可用时

各 Agent 的导入入口都有明确的可用条件，不满足时弹窗会显示原因而不是直接报错：

• Claude Code：只检测到登录痕迹但没有可用 access token 时不可导入。先在 Claude Code 中重新登录，再回到 CCR 的添加供应商弹窗重新扫描。
• Kimi CLI：没有可用的 OAuth token 时不可导入。先在 Kimi CLI 中运行/login，再回到 CCR 重新扫描。
• ZCode：只检测到登录态但没有可用供应商 API Key 时不可导入。先在 ZCode 中配置可用的模型供应商，再回到 CCR 添加供应商。
• Codex 模型缓存较旧：可以先打开 Codex 让它刷新模型列表，再回到 CCR 重新导入或编辑模型。

边界与后续

• 导入复用的是本机 Agent 的登录态，不替代「API 密钥」页面里的 CCR 客户端访问 Key：前者决定 CCR 调上游用哪份凭据，后者决定客户端访问 CCR 用哪份 Key。客户端 Key 仍需按 安装文档 创建。
• 供应商名称必须唯一；导入生成的Claude Code API、Codex API等名称若与已有供应商冲突，需先调整已有供应商名称。
• 默认模型只是起点，后续可以在供应商的模型列表中增减；需要管理多条上游 Key 时，凭据池仍按普通供应商的方式配置，详见 供应商配置 中的凭据与用量读取章节。

【免费下载链接】claude-code-routerOne local control plane for every AI agent: route across models, fuse new capabilities, orchestrate tools, and stay fully in control.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-router