Claude Code 一键配置

YiJue.ai 提供 Claude Code 所需的 Anthropic Messages 兼容接口。配置工具会 交互式读取你的 YiJue.ai API Key，把 Base URL、Bearer Token、默认模型和动态 发现开关合并到 Claude Code 设置。以后每次启动 Claude Code，/model 都会拉取 YiJue 当前可用的最新文本模型，不需要逐个手写模型。

安装

在终端运行：

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

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

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

claude

凭据与配置恢复

配置命令中没有 Key，Key 不会进入 URL、Shell 历史或命令行参数。为保证 Claude Code 在启动模型发现前就能取得凭据，Key 会写入权限为 0600 的 settings.json；系统凭据存储另保留校验副本。工具会备份原配置并使用原子替换， undo 可安全恢复。

查看配置状态

状态检查不会显示完整 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_AUTH_TOKEN": "你的 YiJue.ai API Key",
  "ANTHROPIC_MODEL": "claude-yijue/gpt-5.6-sol",
  "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-yijue/gpt-5.6-sol",
  "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-yijue/gpt-5.6-terra",
  "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-yijue/gpt-5.6-luna",
  "CLAUDE_CODE_SUBAGENT_MODEL": "claude-yijue/gpt-5.6-luna",
  "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1",
  "CLAUDE_CODE_EFFORT_LEVEL": "max"
}

Claude Code 每次启动都会请求 /v1/models?limit=1000，新增或下线的可调用文本 模型会同步到 /model。发现列表显示真实模型名；claude-yijue/ 是兼容前缀， 用于通过 Claude Code 的模型过滤，YiJue 网关收到请求后会去掉前缀并路由到真实 模型。图片生成模型不会进入 Claude Code 的文本模型选择器。

已有环境变量的优先级

Claude Code 会优先读取 Shell 中现有的 ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_API_KEY。它们可能覆盖一键配置写入的 Token。安装器会提示冲突， 但不会擅自删除用户已有配置。

你可以先检查：

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 流式事件。
• 默认高、中、轻量档分别映射到 gpt-5.6-sol、gpt-5.6-terra 和 gpt-5.6-luna，也可以在 /model 选择其他已发布文本模型。
• 支持从 /v1/models 动态发现 YiJue 当前发布的全部 Claude Code 可调用文本模型。
• 兼容 ID 仅用于 Claude Code 识别，实际调用、计费和控制台记录均使用真实模型 ID。
• /v1/messages/count_tokens 暂未实现；Claude Code 会进行本地估算。
• 一键配置只修改当前用户的 Claude Code 配置，不会自动配置远程环境。

参考：Claude Code LLM gateway、 Claude Code 环境变量。

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