跳转到内容
API 码头

FAQ 常见问题

本页汇总接入、账户、计费、稳定性四大类的常见问题与解决方案。如果你的问题不在其中，请联系客服处理。

接入问题

Section titled “接入问题”
command not found: claude 怎么办？

最常见原因是 Claude Code 的可执行文件目录不在 PATH 中。

macOS / Linux：

Terminal window
# 检查 PATH 是否包含 ~/.local/bin
echo $PATH | tr ':' '\n' | grep local/bin


# 若输出为空，将目录追加到 shell 配置
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Windows PowerShell：

Terminal window
# 检查 PATH 是否包含 %USERPROFILE%\.local\bin
$env:PATH -split ';' | Select-String 'local\\bin'


# 若输出为空，永久追加
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

设置完成后 关闭并重新打开终端，再次执行 claude --version 验证。

安装脚本报 syntax error？

通常是网络问题导致下载到的不是脚本本身，而是一段 HTML 错误页（被运营商劫持或代理回包）。

排查步骤：

Terminal window
# 检查到 Google Cloud Storage 的连通性
curl -sI https://storage.googleapis.com
  • 若连接异常，请挂代理后重试
  • macOS 可改用 Homebrew 安装：brew install --cask claude-code
  • 提示「区域不可用」时，使用代理切到美国 / 日本节点重试
VS Code 的 Claude Code 插件无法登录？

VS Code 插件默认会读取系统环境变量或 ~/.claude/settings.json。如果没读到中转配置，会尝试走官方登录，从而提示需要登录。

解决方案（任选其一）：

  • 在 shell 中导出 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN，然后从该终端启动 VS Code
  • 编辑 ~/.claude/settings.json，写入 env 字段（参考 Claude Code CLI - settings.json 配置）
  • 在 VS Code 的 settings.json 中显式声明插件环境变量

修改后重启 VS Code。

调用报连接超时？

按以下顺序排查：

  1. Base URL 是否拼写正确：必须是 https://apimatou.cc，注意末尾不要多加 / 或路径。
  2. 本地网络是否正常：curl -I https://apimatou.cc 应返回 2xx / 3xx。
  3. 是否启用了不兼容的代理：某些 HTTP 代理会拦截 SNI，建议关闭代理或切换为 SOCKS5。
  4. 客户端是否要求带 /v1：OpenAI SDK 类客户端需要填 https://apimatou.cc/v1，Claude Code 环境变量填 https://apimatou.cc。

账户与令牌

Section titled “账户与令牌”
令牌分组之间有什么区别？

API 码头的令牌按 分组 区分可用模型与计费方式，例如通用分组、Codex 分组、绘图分组等。每个分组支持的模型、倍率均不同。

分组的具体定义不在文档维护，请前往 模型广场 与控制台令牌页查看最新说明。

令牌突然失效了？

常见原因：

  • 令牌被手动禁用或删除
  • 令牌额度耗尽或所属账户欠费
  • 调用的模型不在该令牌分组允许的范围内

处理：在控制台「令牌」页确认状态；如确认无误仍失效，删除原令牌重新创建一个新令牌。

如何查询剩余额度与用量？

两种方式：

  • 登录 API 码头控制台，在「使用记录」「额度」页查看
  • 通过 API 接口查询：GET /dashboard/billing/usage（需带令牌鉴权）

Claude Code 内可随时输入 /cost 查看当前会话费用。

同一个令牌能在多设备上使用吗？

可以。同一令牌可在多台机器、多个客户端上同时使用，没有并发锁。但请注意：

  • 令牌等同账号凭证，请勿公开分享
  • 高并发可能触发模型源限流，建议按机器或项目拆分多个令牌便于隔离与排查
卡密怎么兑换？

控制台 → 钱包管理 → 兑换，输入卡密即可到账。购买卡密后请及时兑换，如遇兑换异常或未到账请联系客服处理。

卡密购买地址：pay.ldxp.cn/shop/NHZH3LZ2

计费与退款

Section titled “计费与退款”
模型倍率是怎么算的？

倍率 = API 码头在模型源官方定价基础上的乘数。最终计费 = 模型官方美元价格 × API 码头倍率，并按 1 RMB = 1 USD 兑换比例扣费。

具体倍率请前往 模型广场 查看，文档不在此重复维护。

报「余额不足」或「insufficient quota」？

余额耗尽。请前往控制台完成充值后重试。如果确认有余额但仍报错，请检查：

  • 是否使用了错误的令牌（多账号场景）
  • 令牌是否设置了用量上限
  • 是否被风控拦截
退款政策是怎样的？

退款政策以控制台公告与客服答复为准，本页不臆造具体规则。如需退款（误充值、未消费余额退款等），请联系客服提交申请。

为什么 Claude Code 提示费用比官方还高？

可能的原因：

  • 切换到了倍率更高的模型（例如 Opus）
  • 单次会话上下文过长，每次请求都重发大量历史 token
  • 没有启用 Prompt Caching，重复的系统提示与代码上下文被反复计费

建议先 /cost 查看当前会话明细，再按 省钱技巧 优化。

稳定性与服务

Section titled “稳定性与服务”
API 码头与直接用官方有什么区别？

主要区别：

  • 国内可直连：调用走国内可达的中转地址，无需翻墙即可日常使用（Claude Code 等工具的安装阶段仍需访问官方下载源）
  • 1 RMB = 1 USD 计费：按官方美元计费体系换算扣费，无需海外信用卡
  • 聚合多家模型：同一令牌可访问 Claude、GPT、Gemini 等多家模型
  • 中文支持：控制台、文档、客服均为中文
是否需要翻墙？
  • 调用 API 码头：不需要翻墙，中转地址国内可直连
  • 安装 Claude Code 等工具：安装时需要访问 Anthropic / OpenAI 官方下载源，可能需要代理；安装完成后调用走 API 码头即可断开代理
如何联系客服？

如遇充值、兑换、调用异常等问题，请联系客服处理。具体联系方式以控制台实时展示为准。