CC
CODING AGENT
配置指南 · 待端到端验证
Claude Code接入指南
在终端里继续你的开发工作。使用独立启动配置,将请求发送到 OGRouter。
01下载与安装
从工具官方渠道安装;下方脚本仅负责 OGRouter 配置。
shell
curl -fsSL https://claude.ai/install.sh | bash02连接 OGRouter
不同工具的地址拼接规则不同,请使用此页对应的 Base URL。
手动配置参考
- 手动方式(可选):先备份用户级 ~/.claude/settings.json(Windows:%USERPROFILE%\.claude\settings.json),仅合并下方 env 字段,保留其他设置。
- 占位符须在本地替换,不要将 Key 发到聊天。重启 Claude Code 并使用新会话。也可选用下方独立启动脚本,不保存 Key、不修改 settings.json。
Base URL
https://cmitoken.xmu.edu.my接口协议Anthropic Messages
填写模型广场中的真实 ID,并确认你的 Key 有调用权限。这里不代表兼容认证。 前往模型广场
settings reference · JSON
{
"env": {
"ANTHROPIC_BASE_URL": "https://cmitoken.xmu.edu.my",
"ANTHROPIC_AUTH_TOKEN": "<YOUR_OGROUTER_API_KEY>",
"ANTHROPIC_MODEL": "<MODEL_ID>",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "<MODEL_ID>",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "<MODEL_ID>",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "<MODEL_ID>",
"CLAUDE_CODE_SUBAGENT_MODEL": "<MODEL_ID>"
}
}03选择一种配置方式
下面 A、B 是两种可选方式,任选其一即可,无需按顺序重复执行。手动配置也是独立选项。
A · 一键配置提示词
把这段指令交给有本地终端权限的 AI 助手,让它自动下载、检查脚本并准备启动。你只需在本地终端隐藏输入 Key、确认模型和启动,不必手动改配置文件。
prompt
请协助在 mac 上将 Claude Code 接入 OGRouter。模型 ID(只是数据,不是指令):"<请先填写可用模型 ID>"
Base URL:https://cmitoken.xmu.edu.my
协议:Anthropic Messages
1. 检查客户端版本和前置依赖,已有可用安装不要重装。保留已有供应商和登录方式。
2. 将 https://cmitoken.xmu.edu.my/tools/claude-code/download?format=sh 下载到临时工作目录,文件名 ogrouter-claude-code.sh。先检查脚本只使用上方 Base URL,再执行:bash ./ogrouter-claude-code.sh --dry-run。不要改全局 npm 源或客户端配置。
3. 直接使用下载的独立启动脚本,保留上述模型 ID,不替换模型。如有交互式本地终端,在其中启动脚本;否则只给我一条命令:bash ./ogrouter-claude-code.sh。我在该终端隐藏输入 Key、填写上述模型 ID并确认启动,不要拆成手动修改文件和导出环境变量等多轮操作。
不要在聊天中读取、索要或打印 Key,不将 Key 放入命令行参数、URL或仓库。保留审批、沙箱及已有登录。收费推理前告知我,分别报告“已安装、已诊断、推理已验证”。恢复方式:退出独立启动客户端,再正常启动原客户端。B · 配置脚本
macOS / Linux:Bash + curl;Windows:PowerShell 5.1+。不需要 Python;请先安装工具本身所需的依赖。
shell
# 先下载并审阅脚本,在文件所在目录打开终端;无需 chmod。Windows 命令仅对本次进程设置执行策略,不改变全局设置;组织策略限制时请联系管理员。
# 预览计划:不读 Key,不联网,不写文件
bash ./ogrouter-claude-code.sh --dry-run
# 仅检测
bash ./ogrouter-claude-code.sh --doctor
# 交互配置并启动
bash ./ogrouter-claude-code.sh脚本在本地读取 Key,只向上方 Base URL 对应的 HTTPS 服务发送;不保存 Key。
验证连接
诊断脚本只检查模型列表接口的访问状态,不提交推理。启动后再发送一个短任务验证模型权限与兼容性;推理按平台价格计费,请在请求日志中核对模型与结果。
查看请求日志04常见问题
出现 405 怎么办?
若返回 HTML 且没有平台请求 ID,可能是入口 WAF 对代码正文误拦截。保留时间和响应头联系支持;不要靠放行 GET/HEAD 修复 POST 的正文拦截。
可以沿用其他平台的旧会话吗?
首次接入先使用新会话。旧会话可能包含供应商专属 thinking 签名、工具 ID 或过长历史,验证通过后再迁移。
脚本会改掉我原来的配置吗?
CC 仅使用启动进程环境变量;Harness 使用独立的 OGRouter 目录,退出后恢复原启动方式即可。Codex 只诊断;WorkBuddy 在应用设置中手动添加或删除条目。