安装 Claude Code
请优先使用 Anthropic 官方安装方式。Windows 可使用 PowerShell 或 WinGet，macOS/Linux 可使用官方安装脚本。具体命令可能更新，请以官方文档为准。
配置 Api Halo
Anthropic Base URL：
令牌：Api Halo 控制台创建的 API Key
模型：令牌分组支持的 Claude 模型准确名称
https://apihalo.cn令牌：Api Halo 控制台创建的 API Key
模型：令牌分组支持的 Claude 模型准确名称
export ANTHROPIC_BASE_URL="https://apihalo.cn"
export ANTHROPIC_AUTH_TOKEN="你的_API_KEY"
export ANTHROPIC_MODEL="令牌分组支持的 Claude 模型名"若客户端版本只读取 ANTHROPIC_API_KEY，可将同一令牌写入该变量。不要同时保留互相冲突的旧配置。
让配置永久生效
Linux/macOS 可将变量写入 ~/.bashrc 或 ~/.zshrc，随后重新打开终端。Windows 应使用用户环境变量或 PowerShell 配置文件。
验证接入
- 完全关闭旧终端并重新打开。
- 启动 Claude Code，发送一个简短问题。
- 检查是否正常返回。
- 在 Api Halo 控制台日志中确认请求成功。
常见问题
提示认证失败怎么办？
重新复制令牌，检查变量名和多余空格；确认没有旧的 Anthropic Key 覆盖新值。
模型不可用怎么办？
核对令牌分组与模型广场，模型名称必须完全一致。
为什么修改后没有生效？
环境变量通常只在新进程中加载，应完全退出 Claude Code 和终端后重启。
配套在线工具
按本教程确认安装方式后，带入对应软件生成配置，再执行一次最小连接测试。