Easy AI Code
Docs · Vol. I
§ 1 · 引言
Claude Code
中转服务
面向小范围测试的私有 Claude Code 中转。基于 CRS、Caddy、Tailscale、Fail2Ban 与每日备份构建，优先保证安全与稳定。
服务入口
Claude Code API 端点：
https://api.easyaicode.xyz/api/管理后台仅限管理员通过 Tailnet 访问。
§ 2 · 配置
Claude Code 配置
向管理员领取你的专属 API Key，然后在终端执行：
export ANTHROPIC_BASE_URL="https://api.easyaicode.xyz/api/"
export ANTHROPIC_AUTH_TOKEN="你的 API Key"
claude建议写入 shell 配置文件，不要把 Key 发到群聊或截图。
§ 3 · 脚本
一键配置
推荐先下载脚本，确认内容后运行：
curl -fsSLO https://docs.easyaicode.xyz/setup-claude-code.sh
less setup-claude-code.sh
bash setup-claude-code.sh
source ~/.zshrc
use-easyaicode
脚本不会内置 API Key，也不会打印你的 Key。卸载：bash setup-claude-code.sh --uninstall
§ 4 · 验证
快速验证
easyaicode-test
# 或者
claude -p "Reply with exactly: OK"返回 OK 即表示链路正常。
§ 5 · 排障
常见问题
- 401 / 403 — Key 错误、被禁用，或客户端类型受限。
- 429 — 触发并发或速率限制，降低并发后重试。
- 模型不可用 — 该 Key 可能限制了模型，联系管理员确认。
- 请求很慢 — Claude Code 工具调用可能较长，先用短 prompt 测试。
§ 6 · 隐私
隐私与日志
边缘访问日志仅记录请求元数据，不记录请求正文。授权头由 Caddy 脱敏。 CRS 后台可启用短期请求明细用于排障，正文预览保持关闭。
§ 7 · 合规
合规提醒
大规模转售或共享消费者订阅凭证可能违反上游服务条款，带来账号封禁、 隐私和财务风险。请仅在授权、小范围、可审计的前提下测试使用。