MrKop One API
使用文档返回首页
平台概览API 接入API 参考模型说明额度规则三方工具接入常见问题错误码参考

MrKop One API v0.26.5

三方工具接入

MrKop One API 兼容 OpenAI / Anthropic 协议,支持任意兼容客户端的零改动接入。

Claude Code

Claude Code 是 Anthropic 官方 AI 编程助手 CLI。通过环境变量配置即可接入 MrKop One API。

环境变量配置

bash
# 1. API 地址(指向平台的 Anthropic 兼容端点)
export ANTHROPIC_BASE_URL=https://gw.mrkop.com/anthropic

# 2. API Key(在 Key 管理页面创建)
export ANTHROPIC_AUTH_TOKEN=sk-your-api-key

# 3. 默认模型(启动时使用的模型)
export ANTHROPIC_MODEL=deepseek-v4-pro

# 4. 模型层级映射(/model 命令切换时使用)
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro   # Opus 层级 → 最强推理
export ANTHROPIC_DEFAULT_SONNET_MODEL=glm-5.2   # Sonnet 层级 → 代码生成
export ANTHROPIC_DEFAULT_HAIKU_MODEL=kimi-for-coding    # Haiku 层级 → 快速响应

# 5. 子代理模型(Plan/Explore 等子任务使用的模型)
export CLAUDE_CODE_SUBAGENT_MODEL=kimi-for-coding

# 6. 推理努力程度
export CLAUDE_CODE_EFFORT_LEVEL=max

模型切换(/model 命令)

启动 Claude Code 后,使用 /model 交互命令切换模型:

Claude Code 层级 对应平台模型 适用场景
Opus deepseek-v4-pro 复杂推理、架构设计、深度分析
Sonnet glm-5.2 代码生成、重构、调试
Haiku kimi-for-coding 快速问答、简单任务、低成本

子代理(Plan/Explore)使用 kimi-for-coding,可单独通过 CLAUDE_CODE_SUBAGENT_MODEL 配置。

工作原理:Claude Code 内置 Opus / Sonnet / Haiku 三档层级,通过环境变量将每档映射到平台实际模型。用户在 Claude Code 中输入 /model 即可在三档之间切换,无需修改环境变量。

快速开始

bash
# 安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

# 配置环境变量(见上方)后,进入项目目录启动
cd your-project
claude

# 启动时直接指定模型
claude --model deepseek-v4-pro

各平台配置示例

Linux / Mac(写入 ~/.bashrc 或 ~/.zshrc):

bash
cat >> ~/.bashrc << 'EOF'
export ANTHROPIC_BASE_URL=https://gw.mrkop.com/anthropic
export ANTHROPIC_AUTH_TOKEN=sk-your-api-key
export ANTHROPIC_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_SONNET_MODEL=glm-5.2
export ANTHROPIC_DEFAULT_HAIKU_MODEL=kimi-for-coding
export CLAUDE_CODE_SUBAGENT_MODEL=kimi-for-coding
export CLAUDE_CODE_EFFORT_LEVEL=max
EOF
source ~/.bashrc

Windows PowerShell(以管理员身份运行):

powershell
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://gw.mrkop.com/anthropic", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-your-api-key", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "deepseek-v4-pro", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_OPUS_MODEL", "deepseek-v4-pro", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_SONNET_MODEL", "glm-5.2", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_HAIKU_MODEL", "kimi-for-coding", "User")
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_SUBAGENT_MODEL", "kimi-for-coding", "User")
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_EFFORT_LEVEL", "max", "User")

接入原理

Claude Code 原生的模型名(claude-opus-、claude-sonnet-、claude-haiku-*)会被平台自动映射到配置的实际模型。你也可以在 /model 命令中直接看到平台可用的模型列表。

平台已内置以下模型别名映射(用户无需关心,自动转换):

Claude Code 发送的模型名 平台实际路由到
claude-opus-*kimi-for-coding
claude-sonnet-*kimi-for-coding
claude-haiku-*kimi-for-coding
claude-fable-5kimi-for-coding

通过环境变量 ANTHROPIC_DEFAULT_*_MODEL 可覆盖上述默认映射,直接指定平台模型。

Trae

Trae 是字节跳动推出的 AI IDE,支持 OpenAI 兼容接口。

配置方式:在 Trae 设置中将 API Provider 改为自定义 OpenAI 兼容端点:

bash
API Base URL: https://gw.mrkop.com/v1
API Key: sk-your-api-key

模型选择后即可使用。

WorkBuddy

WorkBuddy 仅支持 OpenAI 协议。配置方式如下:

bash
export OPENAI_API_BASE=https://gw.mrkop.com/v1
export OPENAI_API_KEY=sk-your-api-key

其他第三方工具

任何支持 OpenAI 或 Anthropic 协议的自定义端点配置的工具均可接入:

工具 协议 Base URL 配置方式
Claude Code Anthropic https://gw.mrkop.com/anthropic 环境变量 ANTHROPIC_BASE_URL
Trae OpenAI https://gw.mrkop.com/v1 设置页自定义端点
WorkBuddy OpenAI https://gw.mrkop.com/v1 环境变量 OPENAI_API_BASE
Continue OpenAI https://gw.mrkop.com/v1 config.json 中 apiBase
Cursor OpenAI https://gw.mrkop.com/v1 设置页 OpenAI Base URL
Aider OpenAI https://gw.mrkop.com/v1 环境变量 OPENAI_API_BASE

通用原则:任何支持自定义 API Base URL 的 OpenAI/Anthropic 兼容客户端均可接入。只需将 Base URL 指向 https://gw.mrkop.com/anthropic(Anthropic 协议)或 https://gw.mrkop.com/v1(OpenAI 协议),并使用你在 Key 管理 页面创建的 API Key 即可。