开发者文档

文档 / Claude Code

Claude Code

在 Claude Code 中使用虾马AI

为当前支持 Claude Code 请求方式的分组创建 API Key，然后从“使用密钥”复制实时生成的环境变量或用户级配置。模型、分组和地址均以当前控制台为准。

配置真源Key 列表中的“使用密钥”
持久配置用户目录下的 .claude/settings.json
验收依据客户端成功响应 + /usage 记录

开始前准备

  1. 安装并确认 Claude Code 可以在本机启动。安装和版本要求以客户端当前官方说明为准。
  2. 登录虾马AI，从模型广场确认目标能力当前所属分组。
  3. 进入API Key 管理，为 Claude Code 单独创建一把 Key，并设置合理额度、有效期和限速。
  4. 如果“使用密钥”没有显示 Claude Code 选项，说明当前 Key 分组不应按本文推断配置，应返回模型广场核对分组。

从“使用密钥”获取实时配置

  1. 在 Key 列表找到目标 Key，点击使用密钥。
  2. 选择 Claude Code，再选择 macOS / Linux、Windows CMD 或 PowerShell。
  3. 临时测试可在新终端运行页面生成的环境变量；长期使用则保存页面生成的用户级配置。
  4. 已有 settings.json 时，先备份并用 JSON 解析器合并 env 字段，避免重复键、缺少逗号或覆盖其他设置。
“使用密钥”是完整配置的唯一真源。本文只解释字段职责和操作流程，不复制可能随站点、分组或客户端版本变化的具体值。

Claude Code 的 Base URL 口径

填写位置应使用的地址注意事项
ANTHROPIC_BASE_URL逐字复制“使用密钥”生成的值它是给 Claude Code 使用的基础地址，不等于完整 Messages 端点。
直接调用 Messages API按Anthropic Messages 接入说明使用完整端点直接 HTTP 请求和客户端环境变量的地址口径不同。
最终请求路径应只包含一次对应版本和 Messages 路径出现 /v1/v1/messages 时，通常是手工追加了客户端本会添加的路径。

控制台生成的字段有什么作用

  • ANTHROPIC_BASE_URL：告诉客户端将 API 请求发送到哪个基础地址。
  • ANTHROPIC_AUTH_TOKEN：保存当前虾马AI API Key，属于敏感凭据。
  • 控制台同时生成的流量或标头选项：用于减少与主要模型调用无关的请求或调整客户端附加信息，应按页面原样保留。
  • 某些分组可能生成额外模型映射字段。这些字段必须使用当前页面的值，不要从其他分组或旧教程复制。

macOS / Linux 配置

临时验证

打开一个新终端，运行“使用密钥”在 macOS / Linux 标签中生成的命令，再从同一个终端启动 Claude Code。用 export 设置的变量通常只对当前终端及其子进程生效。

持久配置

将页面生成的 settings.json 内容保存到页面标明的用户级路径。该文件包含完整 Key，应限制本机访问权限，不要放入项目目录。若选择写入 shell 配置文件，也应确保文件不会被同步或提交。

Windows 配置

CMD 或 PowerShell 临时验证

必须选择与你实际使用的 shell 相同的标签。CMD 的 set 和 PowerShell 的 $env: 语法不能混用；设置后应从同一窗口启动 Claude Code。

持久配置

将控制台生成的用户级配置保存到 %USERPROFILE%\.claude\settings.json。确认没有被保存成 settings.json.txt。如果在 WSL 内运行客户端，应改在 WSL 实际用户的目录中配置，而不是 Windows 用户目录。

重启并完成最小验证

  1. 关闭此前启动的 Claude Code 进程。使用持久配置时，重新打开终端或开发工具。
  2. 从已加载新配置的环境中启动 Claude Code，并开始一个新会话。
  3. 发送一个不含敏感代码或数据的最小请求，确认客户端能返回正常内容。
  4. 登录虾马AI并打开使用记录，按时间、Key 和模型定位这次调用。
  5. 以记录中的实际模型、输入、输出、缓存和费用字段为准。

常见问题

现象优先检查
仍然进入其他账户登录流程确认环境中存在控制台生成的鉴权变量，且 Claude Code 是从该环境启动。
环境变量未生效在同一终端检查变量是否存在；持久配置后重开终端和客户端，排除 IDE 使用旧环境。
配置文件无效用 JSON 解析器检查语法，确认文件路径和扩展名正确，避免覆盖已有根级字段。
401 或鉴权失败检查 Key 是否完整、启用且未过期，确认使用的是 ANTHROPIC_AUTH_TOKEN 当前生成值。
403、额度或权限错误检查账户余额、Key 额度、有效期、IP 规则以及当前分组。
404 或路径错误恢复控制台生成的 Base URL，排除重复追加 /v1 或完整端点。
模型或分组不匹配从模型广场核对当前归属，重新为正确分组创建 Key，不要跨分组拼接配置。
超时、TLS 或代理错误检查系统时间、代理、证书和网络；保留时间、状态码和请求 ID 后有限次重试。

继续查看错误排查与计费核对 →

联系支持时不要提交完整 Key、settings.json 或私密提示词。只提供时间和时区、客户端版本、操作系统、脱敏后的 Key 名称、模型、HTTP 状态、错误正文及请求 ID。

更新于 2026-08-13 · 操作路径与动态信息以当前控制台为准