Yuan API

Claude Code 专项问题 ​

Claude Code 使用 Yuan API 地址：

text
https://api.apixhm.com
bash
export ANTHROPIC_AUTH_TOKEN="你的 API Key"
export ANTHROPIC_BASE_URL="https://api.apixhm.com"

首次启动无法连接 ​

确认终端能够访问 api.apixhm.com，并检查代理是否对命令行生效。不要把 Claude Code 地址写成带 /v1 的地址。

401 Invalid API Key / 无效令牌 ​

  • Key 是否复制完整，是否混入空格或换行。
  • 是否设置了 ANTHROPIC_AUTH_TOKEN。
  • ANTHROPIC_BASE_URL 是否是 https://api.apixhm.com。
  • 是否有旧的 ANTHROPIC_API_KEY、ANTHROPIC_API_TOKEN 或 OAuth 状态覆盖当前配置。

OAuth 登录冲突导致 API Key 失效 ​

如果之前登录过官方 Claude，旧 OAuth 状态可能优先于自定义环境变量。退出旧登录状态后，重新打开终端，再验证 Yuan API 环境变量。

Key 含不可见字符 ​

不要从截图、PDF 或 OCR 文本中复制 Key。优先使用控制台复制按钮，并检查变量值中没有回车、空格或零宽字符。

启动时要求认证 ​

检查环境变量优先级和 .claude 配置文件。修改后要关闭整个终端窗口并重新打开，不只是新建一个标签页。

WebFetch 或工具功能异常 ​

第三方接口和工具调用存在兼容性差异。先测试普通文本，再逐项开启工具；如果只有单个工具失败，不一定代表基础 API 不可用。

权限或文件读写被拒绝 ​

这通常是本地终端权限或 Claude Code 权限设置问题，与 API Key 不一定相关。先在终端单独执行对应命令，确认命令本身可运行。

Copyright © 2026 Yuan API