部署相关

部署CC-Gateway需要什么环境? +

CC-Gateway需要Docker环境运行。大多数现代操作系统都支持Docker,包括macOS、Windows、Linux。推荐至少1GB内存和10GB磁盘空间。

可以用Docker Compose还是Docker Run? +

两种方式都可以。docker-compose更方便管理,推荐使用。具体配置请参考 Docker部署 页面。

如何更新CC-Gateway到最新版本? +

使用docker pull命令拉取最新镜像,然后重启容器:

docker pull cc-gateway:latest
docker-compose up -d

配置相关

如何设置标准化的device_id? +

device_id需要是64位的十六进制字符串(0-9和a-f)。你可以使用以下命令生成一个:

openssl rand -hex 32

团队成员应使用相同的device_id,这样在服务端看起来就像同一台设备。

为什么要统一email? +

如果团队成员使用不同的邮箱,通过OAuth认证时会暴露多个身份。建议使用一个统一的、不重要的邮箱作为标准身份。

配置中的platform只能设置darwin吗? +

建议使用darwin(macOS)作为标准化平台,因为这是Claude Code官方支持的平台,也是最常见的配置。如果你的团队都是Linux用户,也可以统一使用linux。

使用相关

设置了环境变量但不起作用? +

请检查以下几点:

  • 环境变量是否已经source(如运行了 source ~/.zshrc
  • 终端会话是否重启
  • CC-Gateway服务是否正常运行(docker logs cc-gateway
  • 防火墙是否允许访问8080端口
Claude Code支持自定义API地址吗? +

是的。Claude Code支持通过环境变量 ANTHROPIC_API_BASEANTHROPIC_API_KEY 使用自定义API地址。

使用CC-Gateway会影响API响应速度吗? +

CC-Gateway的代理转发会带来轻微的延迟,通常在10-50ms之间。对于大多数使用场景来说,这个延迟是可以接受的。

安全相关

API密钥存储安全吗? +

建议通过环境变量传递API密钥,而不是直接写在配置文件中:

api_key: ${ANTHROPIC_API_KEY}

同时确保config.yaml文件的权限设置为600,防止未授权访问。

CC-Gateway会记录日志吗? +

CC-Gateway会记录运行日志,但默认不会记录API请求和响应的详细内容。你可以通过 log_level 配置日志详细程度。建议生产环境使用 warnerror 级别。

其他问题

可以同时在多台机器上运行CC-Gateway吗? +

可以。但需要注意:所有实例应使用相同的identity配置(device_id、email等),这样才能在服务端保持一致的身份。同时确保API密钥可以访问。

如何联系开发者获取支持? +

你可以通过以下方式获取支持: