EN Configuration

Configuration

copilot-relay stores runtime configuration under:

~/.copilot-relay/config.yaml

The file is created from the package template on first start.

Example

host: 127.0.0.1
port: 4142
copilotBaseUrl: https://api.githubcopilot.com
claudeSetup: true
logLevel: info
logRetentionDays: 3
thinkEffort: xhigh
upstreamTimeoutSeconds: 180
webSearchBackend:
gptModel: gpt-5.5
opusModel: claude-opus-4.8

Keys

Key	Purpose
host	Local bind host for the Claude-compatible HTTP server. Keep 127.0.0.1 for local-only use.
port	Local port. Default: 4142.
copilotBaseUrl	GitHub Copilot API base URL. Keep the default unless you know you need a tenant-specific endpoint.
claudeSetup	When true, start updates ~/.claude/settings.json with the local relay endpoint.
logLevel	One of error, info, debug. Any other value fails startup.
logRetentionDays	Days to keep normal .log files under ~/.copilot-relay/logs/.
thinkEffort	Default upstream reasoning effort: none, low, medium, high, xhigh.
upstreamTimeoutSeconds	Max seconds one Claude request can wait for upstream Copilot calls. Default: 180.
webSearchBackend	Optional Copilot Responses model for bridge-managed WebSearch. Empty uses gptModel.
gptModel	Upstream model for non-Opus requests.
opusModel	Upstream model for requested models containing opus.

Hot reload vs restart

Hot-reloaded:

• logLevel
• thinkEffort
• upstreamTimeoutSeconds
• copilotBaseUrl
• webSearchBackend
• gptModel
• opusModel
• claudeSetup

Requires restart:

• host
• port

host and port require restart because the listening socket is already bound.

Claude Code settings

With claudeSetup: true, copilot-relay start writes:

ANTHROPIC_BASE_URL=http://127.0.0.1:4142
ANTHROPIC_AUTH_TOKEN=<dummy local token>

into:

~/.claude/settings.json

The token is intentionally a dummy value because copilot-relay authenticates to GitHub Copilot with your cached GitHub/Copilot tokens, not with Claude's token.

Runtime files

~/.copilot-relay/
  config.yaml
  github_token
  copilot_token.json
  logs/copilot-relay.2026-07-25.log   <- active, rotates at local midnight
  logs/copilot-relay.2026-07-24.log

github_token is the login source. copilot_token.json is a short-lived Copilot bearer-token cache with refresh metadata.