码头中转站使用文档
官网 ↗进入控制台 ↗
使用指南

中转配置教程

创建密钥,选择连接方式,再完成一次简单测试。CC Switch 与手动配置任选一种即可。

更新于 2026.09.20 · 适用于 matouapi.com
01

获取自己的 API 密钥

  1. 打开 码头控制台,登录你的账号;没有账号时按登录页提示注册。
  2. 进入 API 密钥,选择「创建密钥」,填入容易识别的名称,例如“我的 Codex”。
  3. 按使用工具选择厂商与分组。Codex 选 OpenAI;Claude Code 选 Anthropic。
  4. 根据需要设置限额、有效期,创建后复制密钥并妥善保存。
你要使用的工具厂商分组选择
Codex 桌面 / CLIOpenAI如 codex-pro;以账号实际可见选项为准
Claude CodeAnthropic如 cc-max;以账号实际可见选项为准
不同分组的模型、价格、额度与权限可能不同。先看分组说明;密钥限额不会增加账号余额,也不会自动开通订阅。
02

使用 CC Switch 配置

CC Switch 用来管理客户端连接配置,适合希望少编辑文件的用户。

  1. 前往 CC Switch 官方发布页 ↗,下载适合系统和芯片架构的安装包。Windows 选择对应安装包,macOS 选择对应 Mac 安装包,不要下载 Source code。
  2. 安装并打开 CC Switch。若首次启动发现已有配置,先导入或备份。
  3. 回到控制台的 API 密钥列表,打开目标密钥的「使用密钥」。如果界面提供「导入 CC Switch」,选择对应客户端后导入,在 CC Switch 中确认地址与密钥。
  4. 如果没有一键导入入口,在 CC Switch 切到 Claude Code 或 Codex,添加自定义供应商,名称填写“码头中转站”,按下表填写。
  5. 保存并启用该供应商,完全退出目标客户端后重新打开。CC Switch 只管理配置,不代替客户端本身。
配置项Claude CodeCodex
Base URLhttps://matouapi.comhttps://matouapi.com/v1
API KeyAnthropic 分组密钥OpenAI 分组密钥
模型选择当前分组支持的模型 ID,以「使用密钥」提示为准
协议(若有此项)Anthropic / MessagesOpenAI Responses
控制台密钥→CC Switch 供应商→启用并重启客户端

按钮名称可能随 CC Switch 版本变化。检查目标客户端与供应商是否正确,再应用配置。

03

手动配置 Claude Code(可选)

已经通过 CC Switch 配好的用户可跳到第 4 步。手动配置前,先按 Claude Code 官方安装指南 ↗ 安装客户端,并确认终端能够运行 claude --version。

在 Finder 按 ⌘ Shift G,输入 ~/.claude 并前往。

找不到目录时,在用户主目录新建 .claude 文件夹。用纯文本编辑器编辑文件,注意不要保存成 .txt。

编辑 settings.json。下面是新文件的最小模板;如果文件已有内容,请把这两项合并到已有 env 中,保留其他设置。

settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://matouapi.com",
    "ANTHROPIC_AUTH_TOKEN": "替换为你的码头_API_KEY"
  }
}

将占位文字换成自己的 Anthropic 分组密钥并保存。新开终端,进入你的项目目录,输入 claude。使用 /model 选择当前分组支持的模型;若默认模型不可用,请按控制台提供的模型 ID 配置。

配置文件含明文密钥,请保存在用户主目录。不要整份覆盖已有配置,也不要为了连接中转关闭安全审批或修改与连接无关的设置。
04

确认连接成功

发送一条简短消息,例如“只回复:连接成功”。客户端获得正常回答后,到控制台的用量记录中查看这次请求,核对时间、模型和费用。

实际请求可能产生费用。只看到客户端打开或配置保存成功,还不能说明模型已经接通。

遇到错误,先查看 常见问题,不要连续重复发送大量请求。

码头中转站 · matouapi.com 使用文档