跳到主要内容

Claude Code 一键配置

YiJue.ai 提供 Claude Code 所需的 Anthropic Messages 兼容接口。配置工具会 交互式读取你的 YiJue.ai API Key，将凭据交给系统安全存储，并合并 Claude Code 设置；不会把 Key 写进下载 URL、命令参数或 settings.json。

安装​

在终端运行：

curl -fsSL https://yijue.ai/docs/install/yijue-claude-setup.py | python3 - install

工具随后会在终端要求输入 YiJue.ai API Key。粘贴时不回显字符属于 正常现象。

安装完成后，重新打开终端并运行：

claude
凭据存储与配置恢复

配置命令中没有 Key。工具不会把 Key 放进 URL、Shell 历史、命令行参数或 Claude 的 JSON 配置；macOS 使用钥匙串，受支持的 Linux 环境使用系统秘密存储。 工具会保留原配置，写入前创建恢复信息，并使用原子替换避免半写入文件。

查看配置状态​

状态检查不会显示完整 Key：

curl -fsSL https://yijue.ai/docs/install/yijue-claude-setup.py | python3 - status

它会检查 YiJue.ai 的 Claude Code 设置是否仍在、凭据引用是否可用，以及配置 是否发生了外部修改。

撤销配置​

curl -fsSL https://yijue.ai/docs/install/yijue-claude-setup.py | python3 - undo

如果 settings.json 未变化，撤销会恢复安装前备份；如果文件已经变化，撤销 只处理当前值仍等于安装器写入值的条目，并跳过外部修改的条目。

配置了什么​

安装器会把以下模型设置合并进 Claude Code，不会覆盖其他偏好：

Claude Code 模型配置
{
  "ANTHROPIC_BASE_URL": "https://yijue.ai",
  "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
  "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
  "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
  "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
  "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash"
}

API Key 不在这个配置中。Claude Code 会通过 apiKeyHelper 从系统安全存储读取。 YiJue.ai 网关同时接受 Bearer 和 x-api-key 鉴权，并转发普通响应、工具调用与 SSE 流式事件。

安装器不会修改你的推理强度设置。

已有环境变量的优先级​

Claude Code 会优先读取现有的 ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_API_KEY。如果你的 Shell 或 Claude 设置中已经存在这些变量，它们 可能覆盖 apiKeyHelper。安装器会提示冲突，但不会擅自删除用户已有配置。

你可以先检查：

env | grep -E '^ANTHROPIC_(AUTH_TOKEN|API_KEY|BASE_URL)='

确认这些变量属于旧配置后，再到对应的 Shell 配置文件中手动移除；不要把变量 的值复制到工单或聊天中。

验证​

进入一个临时目录启动 Claude Code，发送一条短消息：

mkdir -p /tmp/yijue-claude-test
cd /tmp/yijue-claude-test
claude

然后回到 YiJue.ai 控制台查看最近调用、Token 与费用。 这能同时验证客户端、网关鉴权、上游响应和计费记录。

当前兼容边界​

  • 支持 /v1/messages 普通响应、工具调用和 SSE 流式事件。
  • 支持 Claude Opus、Sonnet、Haiku 名称到当前 DeepSeek 模型的网关映射。
  • /v1/messages/count_tokens 暂未实现；Claude Code 会进行本地估算。
  • apiKeyHelper 只影响 Claude Code CLI，不会自动配置 Claude Desktop 或远程 Claude Code 环境。

参考：DeepSeek Claude Code 接入说明、 Claude Code 环境变量。

遇到问题请参考错误排查。