Claude Code 原生使用 Anthropic API 语义。OpenAI Compatible 不等于 Anthropic Compatible。在配置前，必须确认当前服务明确提供 Claude Code 或 Anthropic 协议兼容入口；不能仅因为模型名称里有 Claude，就把 OpenAI Base URL 直接填入 Claude Code。
开始前检查
- 在 AI快站 API 文档或客服处确认 Claude Code 当前使用的协议和专用地址。
- 确认服务提供的是 Anthropic 兼容接口，而不只是 OpenAI 兼容接口。
- 为 Claude Code 创建独立 Key，不与生产服务共用。
配置步骤
Claude Code 常见配置通过环境变量完成。具体变量和认证方式应以当前 Claude Code 官方文档与 AI快站接入说明为准。典型检查项包括：
ANTHROPIC_BASE_URL
ANTHROPIC_AUTH_TOKEN 或对应认证变量
默认模型与小模型设置配置完成后，新开一个终端，先确认变量是否存在，不要直接打印完整 Key：
test -n "$ANTHROPIC_BASE_URL" && echo "Base URL 已设置"
test -n "$ANTHROPIC_AUTH_TOKEN" && echo "认证变量已设置"然后进入一个不含敏感代码的测试目录，执行短任务：
阅读当前目录中的 README，并用三条要点总结，不要修改文件。先验证只读任务，再验证写文件和执行命令。
常见问题
返回 404 或接口格式错误
最常见原因是把 OpenAI 的 /v1/chat/completions 地址交给了需要 Anthropic Messages 格式的客户端。核对专用 Base URL 和协议，不要反复更换 Key。
能聊天但工具调用异常
中间兼容层可能只转换文本请求，没有完整转换工具调用、流式事件或用量字段。生产使用前必须测试读文件、改文件、执行命令和长任务。
环境变量修改后没有生效
关闭并重新打开终端，确认配置写入了当前 Shell 使用的启动文件。不要在多个配置文件中同时设置相互冲突的地址。
下一步
确认协议兼容后，再为 Claude Code 设置独立用量限制和项目级安全规则。私有仓库、密钥文件和客户数据应加入明确的排除范围。