# Claude Code 接入指南

## 使用前提与开放范围

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

## 在当前终端配置

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

```bash
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"
```

```powershell
$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](/zh-CN/docs/claude-code.md)或 [CLAUDE.md 项目指令模板](/zh-CN/docs/CLAUDE.md)，与已有项目规则合并，不要覆盖原文件。

[官方网关配置说明](https://code.claude.com/docs/en/llm-gateway-connect) · [官方网关兼容范围](https://code.claude.com/docs/en/llm-gateway)。Token 计数、提示词缓存、后台模型等功能仍须针对实际供应商分别验证。