678APIdocs
Claude Code
在 Claude Code 中使用 678API
Claude Code 支持通过环境变量连接兼容网关。配置 678API 地址与密钥后，可直接在项目目录中启动。
获取 Claude Code
安装与检查
curl -fsSL https://claude.ai/install.sh | bash
claude doctor如果已经安装 Claude Code，只需保持客户端为较新版本，不需要重复安装。
临时配置
export ANTHROPIC_BASE_URL="https://www.678api.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
cd /path/to/your/project
claudeANTHROPIC_AUTH_TOKEN 会作为认证令牌发送。关闭当前终端后，这组临时环境变量会失效。
需要退出 Claude / Anthropic 账号吗？
通常不需要。设置 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 后，本次终端会优先使用 678API 网关。要恢复官方服务，运行 unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN 并重新打开 Claude Code。
持久化到 Claude Code
也可以把环境变量写入 ~/.claude/settings.json：
{
"env": {
"ANTHROPIC_BASE_URL": "https://www.678api.com",
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY"
}
}密钥安全
~/.claude/settings.json 包含 API Key，请不要提交到仓库或分享截图。团队项目不要把真实密钥写入项目级配置。
验证与排查
| 现象 | 检查方式 |
|---|---|
| 仍然要求登录 Anthropic | 重新打开终端，运行 env | grep ANTHROPIC，确认两个变量已生效。 |
| 401 / unauthorized | 重新复制 API Key，确认没有空格、换行或重复的 Bearer 前缀。 |
| model not found | 确认 678API 控制台中存在 Claude Code 当前请求的模型，并检查账户分组权限。 |
| 余额不足或请求立即失败 | 检查钱包余额、订阅额度和用量日志。 |