接入文档
CLI 环境检查
在配置 Claude Code、Codex 或其它命令行客户端前，确认本机环境变量、配置文件和网络路径。
当 CLI 客户端配置不生效时，通常是当前 shell 没读到环境变量、配置文件路径写错、或 Base URL 的 /v1 规则混淆。按下面顺序检查。
1 确认环境变量
echo "$ANTHROPIC_BASE_URL"
echo "$ANTHROPIC_AUTH_TOKEN"
echo "$OPENAI_BASE_URL"
echo "$OPENAI_API_KEY"不要把真实密钥发给他人，也不要贴到公开仓库。
2 确认路径规则
| 客户端 | Base URL 规则 |
|---|---|
| Claude Code | ANTHROPIC_BASE_URL 不带 /v1 |
| Codex | OPENAI_BASE_URL 或 base_url 带 /v1 |
| curl / Python OpenAI SDK | endpoint 使用 {Base URL}/v1/chat/completions |
3 直接用 curl 验证
curl
curl 成功，客户端失败时，优先回到客户端配置文件和环境变量；curl 也失败时，去 常见问题排查 按 401、余额、模型和路径继续排查。
4 检查配置文件位置
- Claude Code 全局配置：
~/.claude/settings.json - Claude Code 项目配置：
<项目根目录>/.claude/settings.json - Codex 配置：
~/.codex/config.toml
修改配置后，重开终端或重新启动客户端再试。