U9 AI · DOCUMENTATION

Claude Code 接入指南

说明环境变量、Claude 模型前提、验证步骤及可下载的对接文档。

使用前提与开放范围#

先按官方说明安装 Claude Code，执行 claude --version 确认版本。本页配置的是 CLI，不是 Claude Desktop 桌面应用。你需要本站密钥、可用余额，以及明确通过 Anthropic Messages、流式输出和工具调用验证的 Claude 模型。视频模型、只支持 OpenAI 协议的文本模型都不能替代。下面是预留的接入模板，不代表所有 Claude Code 功能已经实测通过。

在当前终端配置#

在本机替换两个占位符。ANTHROPIC_BASE_URL 填根地址，不加 /v1；ANTHROPIC_AUTH_TOKEN 将本站密钥作为 Bearer token 发送。测试前排除其他网关环境变量或旧配置的干扰。

export ANTHROPIC_BASE_URL="https://u9ai.ai"
export ANTHROPIC_AUTH_TOKEN="YOUR_U9AI_API_KEY"
export ANTHROPIC_MODEL="YOUR_CLAUDE_MODEL_ID"
claude --model "$ANTHROPIC_MODEL"

$env:ANTHROPIC_BASE_URL = "https://u9ai.ai"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_U9AI_API_KEY"
$env:ANTHROPIC_MODEL = "YOUR_CLAUDE_MODEL_ID"
claude --model $env:ANTHROPIC_MODEL

配置后如何验收#

在 Claude Code 内执行 /status，确认当前网关和模型。先发送短问题，再在临时目录验证一次文件读取和完整工具调用往返。只通过 /models 查询，不能证明这些功能正常。小额测试同样可能扣费。

持久化和项目文件#

终端验证成功后，如需长期使用，把非敏感的地址、模型设置合并到现有用户配置。密钥交给本机私密配置或密钥管理工具保存，不要提交到 .claude/settings.json 或 CLAUDE.md。环境变量仅在当前终端会话生效。CLAUDE.md 用于提供项目说明，不能代替认证，也不会自动完成网关配置。

下载与官方参考#

下载完整接入 MD或 CLAUDE.md 项目指令模板，与已有项目规则合并，不要覆盖原文件。

官方网关配置说明 · 官方网关兼容范围。Token 计数、提示词缓存、后台模型等功能仍须针对实际供应商分别验证。