Claude Code

第 2 版 · 更新于 2026-11-12 · 阅读约 5 分钟

通过 Runtoken 接入 Claude Code CLI。

准备工作#

开始配置前，请准备：

已安装且可启动的 Claude Code，可运行 claude --version 确认；安装与升级方法见官方说明。
Runtoken 平台 API Key。
支持 Anthropic Messages 和所需工具调用的模型 ID。

连接配置#

使用以下配置连接 Messages 接口。文件与命令操作在客户端执行，并受其权限控制。

配置项	配置值	作用
网关基础地址	`https://api.runtoken.net`	Claude Code 会拼接 Messages 路径，不要附加 `/v1` 或 `/v1/messages`。
凭据变量	`ANTHROPIC_API_KEY`	通过 `x-api-key` 携带 Runtoken 平台 Key。
模型选择	`--model YOUR_MODEL_ID`	指定本次启动使用的模型。

ANTHROPIC_AUTH_TOKEN 使用的是另一个请求头中的 bearer token。本篇选择 ANTHROPIC_API_KEY，用于 Messages 接口；同一次测试不要同时配置两种凭据。

设置凭据并启动#

先打开单独的终端，在空的测试目录中操作。下面的命令只影响当前 shell 及从它启动的程序，不会修改 shell 启动文件或 Claude Code 设置文件。如果这些配置由公司统一管理，请先与管理员核对。

bash

mkdir runtoken-claude-test
cd runtoken-claude-test
unset ANTHROPIC_AUTH_TOKEN
export ANTHROPIC_BASE_URL="https://api.runtoken.net"
export ANTHROPIC_API_KEY="YOUR_PLATFORM_KEY"
claude --model "YOUR_MODEL_ID"

New-Item -ItemType Directory -Path runtoken-claude-test
Set-Location runtoken-claude-test
Remove-Item Env:ANTHROPIC_AUTH_TOKEN -ErrorAction SilentlyContinue
$env:ANTHROPIC_BASE_URL = "https://api.runtoken.net"
$env:ANTHROPIC_API_KEY = "YOUR_PLATFORM_KEY"
claude --model "YOUR_MODEL_ID"

运行前替换示例中的凭据和模型 ID。如果测试目录已存在，请另选一个空目录。

示例占位值	替换为
`YOUR_PLATFORM_KEY`	Runtoken 平台 API Key，不是管理 Key。
`YOUR_MODEL_ID`	从 Runtoken 模型目录复制的准确 Messages 模型 ID，正式使用前还需确认 Claude Code 兼容性。

命令只会清除测试 shell 中的 ANTHROPIC_AUTH_TOKEN，以免两种凭据冲突，其他位置的原有配置保持不变。交互启动时可能要求确认 API Key 和测试目录的信任，请阅读提示，并保留正常的工具权限确认。

检查连接与文件任务#

Claude Code 启动后，在会话内运行以下命令。

查看生效的配置text

/status

核对网关地址、生效的凭据来源和所选模型，具体显示名称可能随 CLI 版本变化。设置文件或公司管理配置可能覆盖当前值，因此应查看运行中的会话，而不只看终端里执行过哪些命令。

先发送一条简短的文本请求，再到 Runtoken 查找对应的请求记录。可按时间、模型和平台 Key 定位，核对请求状态及可见的用量或费用信息。仅收到回答，还不能证明请求经过了这个网关。

检查文件任务#

在空的测试目录中，请 Claude Code 完成以下小任务。

验证文件创建与后续修改text

创建 greeting.py 文件，包含一个 greet(name) 函数。
函数返回 "Hello, " 与传入名字拼接后的字符串。
不要安装依赖，也不要访问网络。
创建后重新读取文件，并解释它的作用。

阅读拟执行的修改，只批准该任务需要的文件操作。完成后，在同一会话中继续提出要求。

继续同一轮对话text

修改 greet(name)：当名字为空时，返回 "Hello, friend"。
重新读取更新后的文件，说明改动。

检查实际文件和差异，确认工具结果返回后能够继续完成任务，再在 Runtoken 中核对对应的模型请求。这比单次文本问答覆盖更多 Agent 执行环节，但不代表 Claude Code 的所有功能均已兼容。

能力与限制#

Runtoken 不会自动转换协议。本篇所选模型应使用 Messages 接口，不能只替换模型 ID 就改用 OpenAI Chat 模型。

能力	接入要求
网关地址与鉴权	使用基础域名，通过 `x-api-key` 发送平台 Key。
流式输出、文件工具与多轮续接	Messages 事件、工具调用与工具结果回传结构兼容。
上下文压缩、推理、缓存与 beta 功能	支持客户端实际发送的请求头与字段。
IDE 扩展、桌面应用与托管会话	分别配置各入口，不能将终端变量视为所有入口的通用配置。

Claude Code 可能发送基础 Messages 示例以外的请求头与字段。最小 API 请求成功有助于排错，但不能证明这些功能可用；token 计数和模型发现也需要单独核对。

排查问题#

结合实际生效的配置和平台请求记录，缩小问题范围。

现象	检查方向
`401` 或凭据被拒绝	确认平台 Key 未过期或被吊销，并通过 `ANTHROPIC_API_KEY` 使用；检查是否有其他 bearer token 或凭据助手生效。
模型不可用	从目录复制准确 ID，核对协议和访问权限，不要假设 `sonnet` 等别名已映射到 Runtoken 模型。
网关地址未显示或不一致	从已配置的终端启动 CLI，检查用户、项目和管理设置是否覆盖当前配置。
文本可用，工具操作后出现 `400`	记录 CLI 版本、模型和错误信息，检查被拒绝的字段或请求头，不将文本测试视为完整兼容验证。
`429`	阅读错误中的限额与重置说明，核对对应的速率或花费限制后再重试。
输出未完成，流式连接中断	保留部分结果；平台开始输出后不切换通道，重试可能产生另一笔请求，并涉及计费复核。

反馈问题时提供 CLI 版本、操作系统、模型 ID，以及可获得的请求 ID，并移除凭据和私有项目内容。

恢复配置与后续阅读#

恢复原有配置#

退出 Claude Code 并关闭测试终端。本篇没有修改持久配置，之后启动的会话会继续使用其正常继承的环境与设置。

如果你自行将网关值保存到了 shell 启动文件或设置文件，请根据原有配置还原对应条目。不要为了清除此项测试而删除整个设置文件或退出已有账号。

后续阅读#

底层请求格式见 Anthropic Messages，通用网关行为见接入指南。

客户端设置可参阅官方网关连接指南、模型配置及网关兼容要求。

这篇文档有帮助吗？