企业官网建设流程全解析

如何在 9Router 中通过 OAuth 连接 Claude Code（Pro/Max）并使用 cc/ 系列模型？

【免费下载链接】9routerUnlimited FREE AI coding. Connect Claude Code, Codex, Cursor, Cline, Copilot, Antigravity to FREE Claude/GPT/Gemini via 40+ providers. Auto-fallback, RTK -40% tokens, never hit limits.项目地址: https://gitcode.com/GitHub_Trending/9r/9router

如果你已经拥有 Claude Code 的 Pro 或 Max 订阅，想把 Claude 4.5 系列模型接入 9Router，再从本地 CLI 工具或 API 调用中使用cc/前缀的模型，本文覆盖从安装 9Router、OAuth 连接、验证连接到实际使用模型的完整路径。9Router 是一个本地运行的 AI 模型路由器：连接 Claude Code 后，它会启用自动 token 刷新和配额追踪，把请求转发到你已付费的 Claude Code 订阅额度上，而不是按 API 计费。

适用前提（依据 安装文档）：

• Node.js 20.0.0+（npm 10.0.0+ 随 Node.js 附带）
• 操作系统：macOS、Linux、Windows（推荐 WSL）
• 一个 Claude Code Pro（$20/月）或 Max（$100/月）订阅账号
• 约 200MB 磁盘空间

准备：安装并启动 9Router

全局安装（官方推荐方式）：

npm install -g 9router

如果安装报EACCES: permission denied，安装文档给出的方案是修改 npm 前缀目录（npm config set prefix '~/.npm-global'）后重装，而不是使用 sudo。

启动服务：

9router

首次启动会发生：

1. 服务在http://localhost:20128启动，Dashboard 自动在浏览器打开；
2. 数据目录创建在~/.9router；
3. API key 自动生成。

登录 Dashboard 的默认密码是123456，文档要求在 Settings → Change Password 中立即修改。然后在 Dashboard → Settings → API Keys 复制你的 API key，后续验证命令会用到它，格式示例为9r_1234567890abcdef1234567890abcdef（文档示例）。

通过 OAuth 连接 Claude Code

在 Dashboard 中执行 OAuth 流程，依据 Subscription Providers 文档：

1. 进入 Dashboard → Providers，点击Connect Claude Code；
2. 浏览器打开后登录你的 Claude.ai 账号（即 Claude Code Pro/Max 订阅所用的账号），授权 9Router；
3. 授权完成后自动 token 刷新（Auto token refresh）启用，配额追踪（Quota tracking）同时开始。

文档把 OAuth 标注为订阅类提供商（Claude Code、Codex、Gemini CLI、GitHub Copilot）的首选连接方式，参见 Quick Start。

验证连接成功

分两步确认连接真正可用。

第一步，确认 9Router 服务本身在运行：

curl http://localhost:20128/health

文档给出的预期响应（示例）：

{ "status": "ok", "version": "1.0.0" }

第二步，确认cc/模型已出现在可用模型列表中。下面命令中的your-api-key请替换为你在 Dashboard 复制的 API key：

curl http://localhost:20128/v1/models \ -H "Authorization: Bearer your-api-key"

连接成功后，返回的data列表中应包含 Claude Code 的模型条目，文档示例响应：

{ "object": "list", "data": [ { "id": "cc/claude-opus-4-5-20251101", "object": "model", "created": 1234567890, "owned_by": "claude-code" } ] }

另外，Dashboard → Providers 中的配额追踪面板会显示 Claude Code 的实时用量，例如文档示例（非固定数值）：Quota: 75% used / Reset: 2h 15m (5-hour) / Weekly reset: 3 days。

可用的 cc/ 系列模型

连接 Claude Code 后，可用的模型 ID 及文档给出的适用建议（来自 Subscription Providers 文档）：

Claude Code 配额类型为 5 小时滚动窗口 + 每周重置（Pro/Max 相同）。

使用 cc/ 模型

方式一：在 Claude Code CLI 中配置 9Router

Claude Code 集成文档给出了通过环境变量把 Claude Code 指向 9Router 的做法。在~/.bashrc、~/.zshrc或~/.bash_profile中设置：

# Base URL for 9Router export ANTHROPIC_BASE_URL="http://localhost:20128/v1" # Optional: Set default models for aliases export ANTHROPIC_DEFAULT_OPUS_MODEL="cc/claude-opus-4-5-20251101" export ANTHROPIC_DEFAULT_SONNET_MODEL="cc/claude-sonnet-4-5-20250929" export ANTHROPIC_DEFAULT_HAIKU_MODEL="cc/claude-haiku-4-5-20251001"

然后重载 shell 配置（按你的 shell 选择）：

source ~/.zshrc # or ~/.bashrc

用echo $ANTHROPIC_BASE_URL可以确认变量已生效。之后即可使用别名或完整模型名调用：

# 使用 Opus 模型 claude --model opus "Explain quantum computing" # 使用完整模型名 claude --model cc/claude-opus-4-5-20251101 "Your prompt here"

该文档还提到 Claude Code 的配置存储在~/.claude/settings.json，可按需手动编辑。

方式二：在任意支持 OpenAI 兼容接口的工具中使用

Quick Start 文档列出的接入方式都以http://localhost:20128/v1为 Base URL，API key 取自 Dashboard，模型名直接填cc/模型 ID：

• Cursor IDE：Settings → Models → Advanced 中填写 OpenAI API Base URL、API Key 和 Model；
• Cline / Continue / RooCode：Provider 选 OpenAI Compatible，填 Base URL、API Key、Model；
• Codex CLI：

export OPENAI_BASE_URL="http://localhost:20128" export OPENAI_API_KEY="your-9router-api-key" codex "your prompt"

其中your-9router-api-key替换为 Dashboard 中的实际 key。

验证一次真实请求

用 curl 直接打一次 chat/completions，确认cc/模型端到端可用（同样替换your-api-key）：

curl http://localhost:20128/v1/chat/completions \ -H "Authorization: Bearer your-api-key" \ -H "Content-Type: application/json" \ -d '{ "model": "cc/claude-opus-4-5-20251101", "messages": [ {"role": "user", "content": "Hello!"} ] }'

请求成功后，Dashboard → Activity 中会出现对应请求的 token 用量记录（Quota Tracking 文档中展示的 Request 条目为文档示例）。

常见问题与限制

以下是与当前场景直接相关的已知问题，来自 Troubleshooting 文档 和 Subscription Providers 文档：

"Unauthorized" 或 "Token expired"：OAuth token 过期时，9Router 默认自动刷新，文档建议等待 30 秒重试；仍失败则走 Dashboard → Providers → [Provider Name] → Reconnect，重新完成一次 OAuth 流程。

"Model not found" 或 "Invalid model"：依次检查——Dashboard 中 Claude Code 连接状态是否激活（绿色）；模型 ID 是否带cc/前缀（正确：cc/claude-opus-4-5-20251101，错误：claude-opus-4-5-20251101）；用/v1/models列出实际可用模型；必要时 Reconnect 提供商。

"Quota exhausted" / Rate limiting：Claude Code 是 5 小时滚动 + 每周重置的配额，耗尽后等重置，或在 Dashboard → Combos 创建回退链（文档示例：cc/claude-opus → glm/glm-4.7 → if/kimi-k2），由 9Router 自动切换到下一档。

配额说明：Pro 与 Max 的模型范围相同（Opus/Sonnet/Haiku），差异在于额度大小；Max 为 $100/月，Pro 为 $20/月，两者都是 5 小时 + 每周重置。文档同时建议复杂任务用 Opus、快速任务用 Sonnet/Haiku，并按模型在 Dashboard 跟踪配额。

完成上述步骤后，你在 CLI 中输入的cc/claude-opus-4-5-20251101等请求会经由 9Router 路由到 Claude Code 订阅配额，并在 Dashboard 的配额追踪面板中实时消耗。如果配额耗尽需要低成本兜底，Subscription Providers 文档 的 Next Steps 指向了 Cheap/Free Providers 文档与 Combos 配置入口。

【免费下载链接】9routerUnlimited FREE AI coding. Connect Claude Code, Codex, Cursor, Cline, Copilot, Antigravity to FREE Claude/GPT/Gemini via 40+ providers. Auto-fallback, RTK -40% tokens, never hit limits.项目地址: https://gitcode.com/GitHub_Trending/9r/9router