解答使用CC-Gateway过程中的常见疑问
CC-Gateway需要Docker环境运行。大多数现代操作系统都支持Docker,包括macOS、Windows、Linux。推荐至少1GB内存和10GB磁盘空间。
两种方式都可以。docker-compose更方便管理,推荐使用。具体配置请参考 Docker部署 页面。
使用docker pull命令拉取最新镜像,然后重启容器:
docker pull cc-gateway:latest
docker-compose up -d
device_id需要是64位的十六进制字符串(0-9和a-f)。你可以使用以下命令生成一个:
openssl rand -hex 32
团队成员应使用相同的device_id,这样在服务端看起来就像同一台设备。
如果团队成员使用不同的邮箱,通过OAuth认证时会暴露多个身份。建议使用一个统一的、不重要的邮箱作为标准身份。
建议使用darwin(macOS)作为标准化平台,因为这是Claude Code官方支持的平台,也是最常见的配置。如果你的团队都是Linux用户,也可以统一使用linux。
请检查以下几点:
source ~/.zshrc)docker logs cc-gateway)是的。Claude Code支持通过环境变量 ANTHROPIC_API_BASE 或 ANTHROPIC_API_KEY 使用自定义API地址。
CC-Gateway的代理转发会带来轻微的延迟,通常在10-50ms之间。对于大多数使用场景来说,这个延迟是可以接受的。
建议通过环境变量传递API密钥,而不是直接写在配置文件中:
api_key: ${ANTHROPIC_API_KEY}
同时确保config.yaml文件的权限设置为600,防止未授权访问。
CC-Gateway会记录运行日志,但默认不会记录API请求和响应的详细内容。你可以通过 log_level 配置日志详细程度。建议生产环境使用 warn 或 error 级别。
可以。但需要注意:所有实例应使用相同的identity配置(device_id、email等),这样才能在服务端保持一致的身份。同时确保API密钥可以访问。