ccLoad
AI API gateway that ends manual channel switching with smart routing, auto failover, exponential cooldown, multi-URL scheduling, live request monitoring and soft-error detection.
File Explorer
Download Latest Version (.zip)- openai.yaml
- release.sh
- SKILL.md
- openai.yaml
- core-snapshot.manifest
- provider-adapters.manifest
- provider-adapters.md
- list_go_tests.go
- verify.sh
- verify_core_scope.sh
- SKILL.md
- ccload-release
- sync-cliproxy-core
- generate-release-notes.sh
- release.yml
- test.yml
- Dockerfile.release
- ccload-dashboard.jpeg
- ccload-logs.jpg
- ccload.jpg
- credential.go
- credential_test.go
- service.go
- service_test.go
- credential.go
- credential_test.go
- service.go
- service_test.go
- gpt-5-codex.md
- gpt-5.1.md
- gpt-5.2.md
- gpt-5.4-mini.md
- gpt-5.4.md
- gpt-5.5.md
- gpt-5.6.md
- LICENSE
- README.md
- active_requests.go
- active_requests_test.go
- admin_active_requests.go
- admin_active_requests_debug_test.go
- admin_active_requests_handler_test.go
- admin_anthropic_auth.go
- admin_antigravity_auth.go
- admin_api_test.go
- admin_auth_tokens.go
- admin_auth_tokens_test.go
- admin_auth_tokens_update_delete_test.go
- admin_billing.go
- admin_channel_editor.go
- admin_channels.go
- admin_channels_duplicate_test.go
- admin_channels_more_test.go
- admin_channels_url_stats_test.go
- admin_channels_wrapper_test.go
- admin_codex_auth.go
- admin_codex_auth_test.go
- admin_codex_overdraft.go
- admin_codex_quota_reset.go
- admin_cooldown.go
- admin_cooldown_detection.go
- admin_cooldown_test.go
- admin_crud_test.go
- admin_csv.go
- admin_cursor_auth.go
- admin_cursor_auth_test.go
- admin_debug_log.go
- admin_debug_log_test.go
- admin_list_shapes_test.go
- admin_logs_bootstrap.go
- admin_models.go
- admin_models_test.go
- admin_oauth_cleanup.go
- admin_oauth_import.go
- admin_oauth_import_aggregate.go
- admin_oauth_import_files.go
- admin_oauth_import_jobs.go
- admin_oauth_usage.go
- admin_settings.go
- admin_settings_handler_test.go
- admin_settings_response_test.go
- admin_settings_validation_test.go
- admin_stats.go
- admin_stats_public_test.go
- admin_stats_test.go
- admin_testing.go
- admin_testing_image.go
- admin_testing_stream.go
- admin_testing_stream_test.go
- admin_testing_test.go
- admin_types.go
- admin_types_test.go
- admin_types_validation_test.go
- admin_xai_auth.go
- admin_xai_oauth.go
- admin_xai_usage_test.go
- admin_zai_auth.go
- admin_zai_auth_test.go
- admin_zai_oauth.go
- admin_zai_oauth_test.go
- anthropic_cch.go
- anthropic_credentials.go
- anthropic_request.go
- anthropic_response_encoding.go
- anthropic_retry.go
- anthropic_usage_headers.go
- anthropic_wire.go
- antigravity_credentials.go
- antigravity_retry.go
- antigravity_wire.go
- api_token_session_limiter.go
- auth_middleware_test.go
- auth_service.go
- auth_service_handlers_test.go
- auth_service_unit_test.go
- auth_token_provisioning.go
- auth_token_provisioning_test.go
- auto_update.go
- auto_update_test.go
- billing_integration_test.go
- channel_check_scheduler.go
- channel_check_scheduler_test.go
- channel_concurrency_limiter.go
- channel_concurrency_limiter_test.go
- channel_rpm_limiter.go
- channel_rpm_limiter_test.go
- codex_credentials.go
- codex_instructions.go
- codex_multi_agent_v2.go
- codex_multi_agent_v2_test.go
- codex_session_cache.go
- codex_session_cache_test.go
- codex_upstream_websocket.go
- codex_usage_headers.go
- codex_utls_transport.go
- codex_utls_transport_test.go
- codex_wire.go
- concurrent_key_selection_test.go
- config_service.go
- config_service_test.go
- cost_cache.go
- cost_cache_test.go
- csv_integration_test.go
- cursor_credentials.go
- cursor_wire.go
- cursor_wire_test.go
- custom_rules.go
- custom_rules_test.go
- dashboard_channels.go
- dashboard_scope.go
- dashboard_scope_test.go
- detection_log.go
- detection_log_test.go
- forward_async_test.go
- handlers.go
- handlers_test.go
- health_cache.go
- health_cache_test.go
- host_override.go
- host_override_test.go
- http_read_timeout_test.go
- http_runtime_metrics.go
- key_selector.go
- key_selector_counter_test.go
- key_selector_test.go
- log_service.go
- log_service_test.go
- middleware_zstd.go
- middleware_zstd_test.go
- model_catalog_sync.go
- model_catalog_sync_test.go
- oauth_base_url.go
- oauth_credential_refresh_tracker.go
- oauth_quota_cost.go
- process_stats.go
- process_stats_darwin.go
- process_stats_linux.go
- process_stats_stub.go
- process_stats_test.go
- process_stats_unix.go
- protocol_capability.go
- protocol_hotpath_bench_test.go
- proxy_cursor_integration_test.go
- proxy_debug.go
- proxy_error.go
- proxy_error_test.go
- proxy_forward.go
- proxy_forward_context_done_test.go
- proxy_forward_soft_error_test.go
- proxy_forward_test.go
- proxy_gemini.go
- proxy_gemini_openai_integration_test.go
- proxy_gemini_other_integration_test.go
- proxy_gemini_test.go
- proxy_handler.go
- proxy_handler_test.go
- proxy_integration_protocol_response_test.go
- proxy_integration_test.go
- proxy_protocol_detect.go
- proxy_protocol_detect_test.go
- proxy_responses_websocket.go
- proxy_responses_websocket_test.go
- proxy_sse_parser.go
- proxy_sse_parser_test.go
- proxy_stream.go
- proxy_stream_test.go
- proxy_transport.go
- proxy_util.go
- proxy_util_test.go
- proxy_zai_integration_test.go
- request_context.go
- response_merge.go
- responses_execution_session.go
- responses_retry.go
- responses_websocket_connection_limiter.go
- responses_websocket_session.go
- selector.go
- selector_balancer.go
- selector_balancer_test.go
- selector_cooldown.go
- selector_model_matcher.go
- selector_test.go
- server.go
- server_misc_test.go
- server_runtime_config_test.go
- smooth_weighted_rr.go
- smooth_weighted_rr_test.go
- socket_unix.go
- socket_windows.go
- static.go
- static_handler_test.go
- stats_cache.go
- stats_cache_lite_test.go
- stats_cache_test.go
- test_helpers_test.go
- test_main_test.go
- thinking_suffix.go
- token_counter.go
- token_counter_test.go
- token_stats_shutdown_test.go
- upstream_connection_age.go
- upstream_connection_age_test.go
- url_fallback.go
- url_selector.go
- url_selector_test.go
- web_auth_test.go
- web_identity.go
- xai_credentials.go
- xai_credentials_test.go
- xai_wire.go
- xai_wire_test.go
- zai_credentials.go
- zai_wire.go
- zai_wire_test.go
- credential.go
- credential_test.go
- service.go
- service_test.go
- defaults.go
- detection.go
- detection_test.go
- manager.go
- manager_1308_test.go
- manager_test.go
- sdk_agent_service.connect.go
- sdk_bridge_control_service.connect.go
- sdk_cursor_service.connect.go
- sdk_custom_tool_callback_service.connect.go
- sdk_store_callback_service.connect.go
- sdk_agent_service.pb.go
- sdk_bridge_control_service.pb.go
- sdk_cursor_service.pb.go
- sdk_custom_tool_callback_service.pb.go
- sdk_errors.pb.go
- sdk_messages.pb.go
- sdk_store_callback_service.pb.go
- bridge.go
- bridge_install.go
- bridge_install_test.go
- bridge_ready.go
- bridge_ready_test.go
- constants.go
- credential.go
- credential_test.go
- headers.go
- models.go
- models_test.go
- runner.go
- sdk_error.go
- sdk_runner.go
- sdk_runner_test.go
- sdk_stream.go
- service.go
- service_test.go
- toolalias.go
- tools.go
- tools_test.go
- usage.go
- usage_test.go
- ordered_conn.go
- ordered_conn_test.go
- auth_token.go
- auth_token_additional_test.go
- auth_token_test.go
- config.go
- config_additional_test.go
- debug_log.go
- health.go
- log.go
- model_test.go
- stats.go
- system_setting.go
- thinking_suffix.go
- web_session.go
- snapshot.go
- usage.go
- usage_test.go
- cliproxy_adapter.go
- register.go
- claude_gemini_request.go
- claude_gemini_request_test.go
- claude_gemini_response.go
- claude_gemini_response_test.go
- claude_openai_compat_test.go
- claude_openai_request.go
- claude_openai_request_test.go
- claude_openai_response.go
- claude_openai_response_test.go
- claude_openai-responses_request.go
- claude_openai-responses_request_test.go
- claude_openai-responses_response.go
- claude_openai-responses_response_test.go
- claude_openai_responses_compat_test.go
- codex_claude_compat_test.go
- codex_claude_parallel_function_calls_test.go
- codex_claude_request.go
- codex_claude_request_test.go
- codex_claude_response.go
- codex_claude_response_test.go
- codex_claude_response_web_search.go
- codex_gemini_request.go
- codex_gemini_request_test.go
- codex_gemini_response.go
- codex_gemini_response_test.go
- codex_openai_request.go
- codex_openai_request_test.go
- codex_openai_response.go
- codex_openai_response_test.go
- codex_openai-responses_request.go
- codex_openai-responses_request_test.go
- codex_openai-responses_response.go
- codex_openai-responses_response_test.go
- anthropic_response.go
- bytes.go
- bytes_test.go
- cache_control.go
- cache_control_test.go
- claude_messages.go
- claude_messages_test.go
- claude_system.go
- file_data.go
- file_data_test.go
- gemini.go
- request.go
- request_test.go
- responses.go
- responses_test.go
- gemini_claude_compat_test.go
- gemini_claude_request.go
- gemini_claude_request_test.go
- gemini_claude_response.go
- gemini_claude_response_test.go
- safety.go
- gemini_openai_file_data_test.go
- gemini_openai_request.go
- gemini_openai_request_test.go
- gemini_openai_response.go
- gemini_openai_response_test.go
- gemini_openai_signature_test.go
- gemini_openai-responses_request.go
- gemini_openai-responses_request_test.go
- gemini_openai-responses_response.go
- gemini_openai-responses_response_test.go
- signature_carrier.go
- signature_carrier_test.go
- mime_type.go
- openai_claude_compat_test.go
- openai_claude_request.go
- openai_claude_request_test.go
- openai_claude_response.go
- openai_claude_response_test.go
- openai_gemini_request.go
- openai_gemini_request_test.go
- openai_gemini_response.go
- openai_gemini_response_test.go
- openai_openai-responses_request.go
- openai_openai-responses_request_test.go
- openai_openai-responses_response.go
- openai_openai-responses_response_test.go
- openai_openai-responses_tools.go
- antigravity_claude_request.go
- antigravity_claude_response.go
- signature_validation.go
- signature_validation_test.go
- web_search.go
- antigravity_gemini_request.go
- antigravity_gemini_request_test.go
- antigravity_gemini_response.go
- antigravity_gemini_response_test.go
- antigravity_openai_file_data_test.go
- antigravity_openai_request.go
- antigravity_openai_request_test.go
- antigravity_openai_response.go
- antigravity_openai_response_test.go
- antigravity_openai-responses_request.go
- antigravity_openai-responses_request_test.go
- antigravity_openai-responses_response.go
- antigravity_openai-responses_response_test.go
- models.json
- models.go
- claude.go
- claude_messages_sanitize.go
- claude_messages_sanitize_compat_test.go
- claude_test.go
- claude_validation.go
- gemini_sanitize.go
- gemini_sanitize_test.go
- gemini_validation.go
- gemini_validation_test.go
- gpt_validation.go
- gpt_validation_test.go
- grok_validation.go
- grok_validation_test.go
- kimi_validation.go
- kimi_validation_test.go
- provider_compatibility.go
- provider_compatibility_test.go
- convert.go
- suffix.go
- text.go
- types.go
- claude_attribution.go
- claude_attribution_test.go
- claude_schema.go
- claude_schema_test.go
- claude_tool_id.go
- claude_tool_id_test.go
- claude_tool_result.go
- function_name.go
- gemini_schema.go
- gemini_schema_test.go
- gjson.go
- gjson_test.go
- translator.go
- LICENSE
- UPSTREAM.md
- errors.go
- gemini_openai_test.go
- registry.go
- registry_codex_anthropic_stream_test.go
- registry_codex_gemini_stream_test.go
- registry_codex_tool_names_test.go
- registry_gemini_anthropic_test.go
- registry_gemini_codex_test.go
- registry_request_semantics_test.go
- registry_stream_toolcalls_test.go
- registry_structured_response_test.go
- registry_test.go
- test_helpers_test.go
- transform_plan_gemini_test.go
- types.go
- types_test.go
- builder.go
- builder_test.go
- tables.go
- apikey.go
- apikey_test.go
- auth_token_stats.go
- auth_token_stats_test.go
- auth_tokens.go
- auth_tokens_ensure_test.go
- auth_tokens_mysql_test.go
- auth_tokens_test.go
- auth_tokens_update_stats_test.go
- auth_tokens_upsert_test.go
- config.go
- config_test.go
- cooldown.go
- cooldown_extras_test.go
- cooldown_internal_test.go
- cooldown_test.go
- debug_log.go
- helpers.go
- log.go
- log_test.go
- metrics.go
- metrics_aggregate_rows.go
- metrics_basic_test.go
- metrics_filter.go
- metrics_finalize.go
- oauth_quota_cost.go
- query.go
- query_test.go
- rebind.go
- rebind_test.go
- replica.go
- store_impl.go
- system_settings.go
- system_settings_test.go
- test_helpers_test.go
- transaction.go
- transaction_deadline_test.go
- url_state.go
- url_state_test.go
- vacuum_test.go
- web_sessions.go
- web_sessions_test.go
- cooldown_auth_error_test.go
- cooldown_consistency_test.go
- store_impl_concurrent_test.go
- test_store_helpers_test.go
- autovacuum_test.go
- bench_hybrid_test.go
- cache.go
- cache_benchmark_test.go
- cache_isolation_test.go
- channel_cache_additional_test.go
- dialect_helpers.go
- docker_test_helpers.go
- factory.go
- factory_additional_test.go
- health_success_rate_test.go
- hybrid_reconcile.go
- hybrid_store.go
- hybrid_store_auth_tokens_test.go
- hybrid_store_test.go
- hybrid_writebehind.go
- migrate.go
- migrate_columns.go
- migrate_data.go
- migrate_mysql_test.go
- migrate_parse_test.go
- migrate_postgres_test.go
- migrate_sqlite_test.go
- mysql_factory_failure_test.go
- store.go
- sync_manager.go
- sync_manager_test.go
- anthropic.json
- codex.json
- gemini.json
- openai.json
- api_tester.go
- api_tester_test.go
- http.go
- store.go
- templates.go
- templates_test.go
- testutil_test.go
- types.go
- apikeys.go
- apikeys_test.go
- classifier.go
- classifier_1308_test.go
- classifier_test.go
- cost_calculator.go
- cost_calculator_bench_test.go
- cost_calculator_test.go
- flexible_bool.go
- flexible_bool_test.go
- gemini_pricing_test.go
- model_pricing_catalog.go
- models_dev_catalog.go
- models_dev_catalog_test.go
- models_fetcher.go
- models_fetcher_predefined_test.go
- models_fetcher_test.go
- money.go
- money_test.go
- openai_pricing_test.go
- parse.go
- parse_test.go
- protocols.go
- protocols_bench_test.go
- protocols_test.go
- rate_limiter.go
- rate_limiter_test.go
- time.go
- time_bench_test.go
- time_env_test.go
- time_test.go
- uuid_local.go
- uuid_local_test.go
- banner.go
- release_latest.go
- updater.go
- updater_test.go
- version.go
- billing.go
- constants.go
- credential.go
- credential_test.go
- service.go
- service_test.go
- sso.go
- sso_billing_test.go
- constants.go
- credential.go
- credential_test.go
- headers.go
- service.go
- service_test.go
- usage.go
- usage_test.go
- fetch-cursor-sdk-bridge.sh
- sdk_agent_service.proto
- sdk_bridge_control_service.proto
- sdk_cursor_service.proto
- sdk_custom_tool_callback_service.proto
- sdk_errors.proto
- sdk_messages.proto
- sdk_store_callback_service.proto
- LICENSE
- manifest.json
- assets.go
- bridge.lock
- channels.css
- highlight-theme.css
- logs.css
- styles.css
- tokens.css
- channels-codex-auth.js
- channels-codex-auth.test.js
- channels-cooldown-detection.js
- channels-cooldown-detection.test.js
- channels-custom-rules.js
- channels-custom-rules.test.js
- channels-data.js
- channels-filters.js
- channels-import-export.js
- channels-import-export.test.js
- channels-init.js
- channels-init.test.js
- channels-keys.js
- channels-modals.js
- channels-modals.test.js
- channels-render.js
- channels-render.test.js
- channels-sort.js
- channels-state.js
- channels-test.js
- channels-test.test.js
- channels-urls.js
- channels-urls.test.js
- date-range-selector.js
- echarts.min.js
- filter-query.js
- filter-state.js
- filter-state.test.js
- highlight.min.js
- i18n.js
- i18n.test.js
- index.js
- index.test.js
- login.js
- logs-channel-editor.js
- logs-debug-copy.test.js
- logs.js
- markdown-renderer.js
- markdown-renderer.test.js
- marked.min.js
- marked.umd.js.map
- merged-response-client.js
- model-entry-parser.js
- model-entry-parser.test.js
- model-test-advanced-options.js
- model-test-advanced-options.test.js
- model-test-chat-channel-state.js
- model-test-chat-channel-state.test.js
- model-test-chat-session.js
- model-test-chat-session.test.js
- model-test-image.js
- model-test-image.test.js
- model-test.js
- page-filters.js
- purify.min.js
- purify.min.js.map
- service-health.js
- settings.js
- settings.test.js
- stats.js
- template-engine.js
- theme-init.js
- token-expiry.js
- token-expiry.test.js
- token-model-test.js
- token-model-test.test.js
- tokens.js
- trend.js
- ui.js
- upstream-detail-modal.js
- upstream-detail-modal.test.js
- web-auth.js
- web-auth.test.js
- en.js
- zh-CN.js
- apple-touch-icon.png
- brand-mark.svg
- brand-wordmark.svg
- channels.html
- favicon-192.png
- favicon-512.png
- favicon.ico
- favicon.svg
- index.html
- login.html
- logs.html
- manifest.json
- model-test.html
- settings.html
- stats.html
- tokens.html
- trend.html
- www.css
- ccload-dashboard.jpeg
- ccload-logs.jpg
- ccload.jpg
- nav.js
- www.js
- en.js
- zh-CN.js
- .gitignore
- config.html
- DEPLOY.md
- feedback.html
- index.html
- install.html
- README.md
- usage.html
- .dockerignore
- .env.docker.example
- .env.example
- .gitignore
- .golangci.yml
- buf.gen.yaml
- buf.yaml
- CLAUDE.md
- codegraph.json
- com.ccload.service.plist.template
- docker-compose.build.yml
- docker-compose.yml
- Dockerfile
- embed.go
- go.mod
- go.sum
- LICENSE
- main.go
- Makefile
- README.md
- README.zh-CN.md
# Installation Guide
git clone https://github.com/caidaoli/ccLoad
Downloads the entire project code from GitHub to your computer.
cd ccLoad
Moves into the project folder you just downloaded.
2. Docker
Easy Recommended- Git Needed to download the project code from GitHub.
- Docker Desktop Needed to build and run containers. Install it and keep it running in the background.
curl -o docker-compose.yml https://raw.githubusercontent.com/caidaoli/ccLoad/master/docker-compose.yml
Runs the command against the services defined in the compose file.
curl -o .env https://raw.githubusercontent.com/caidaoli/ccLoad/master/.env.docker.example
Type this command into your terminal and run it.
docker-compose up -d
Runs the command against the services defined in the compose file.
docker pull ghcr.io/caidaoli/ccload:latest
Type this command into your terminal and run it.
docker run -d --name ccload \
Runs the built image as an actual container.
Pulled directly from this repo's README.
3. Go
Mediumgo build -tags sonic -o ccload .
Compiles the Go program into an executable.
go run -tags sonic .
Runs the Go program directly without a separate build step.
Pulled directly from this repo's README.
4. Make
Medium- Git Needed to download the project code from GitHub.
- Make Usually pre-installed on Linux/macOS. On Windows, install separately (e.g. via MSYS2 or WSL).
make build
Compiles the code based on the generated build configuration to produce an executable.
make dev
Compiles the code based on the generated build configuration to produce an executable.
make race-fast # high-value race subset
Compiles the code based on the generated build configuration to produce an executable.
make race # full race suite
Compiles the code based on the generated build configuration to produce an executable.
make verify-web # frontend node:test checks
Compiles the code based on the generated build configuration to produce an executable.
Pulled directly from this repo's README.
