설정

환경 변수

아래 값들은 shell 또는 .env 파일에 설정합니다.

변수	필수	설명
CLAUDE_BIN_PATH	예(binary builds)	Claude Code SDK의 cli.js에 대한 절대 경로입니다. assistants.claude.claudeBinaryPath가 설정되지 않은 compiled Archon binary에서는 필수입니다. Dev mode(bun run)에서는 node_modules를 통해 자동으로 해석됩니다.
CLAUDE_USE_GLOBAL_AUTH	아니요	claude /login의 credential을 사용하려면 true로 설정합니다(다른 Claude token이 없을 때 기본값)
CLAUDE_CODE_OAUTH_TOKEN	아니요	claude setup-token에서 받은 OAuth token입니다(global auth의 대안)
CLAUDE_API_KEY	아니요	pay-per-use 방식으로 사용할 Anthropic API key입니다(global auth의 대안)
CODEX_BIN_PATH	아니요	Codex CLI binary의 절대 경로입니다. compiled Archon build에서 auto-detection을 override합니다.
CODEX_ACCESS_TOKEN	예(Codex 사용 시)	Codex access token입니다(AI Assistants 참고)
DATABASE_URL	아니요	PostgreSQL connection string입니다(기본값: SQLite)
LOG_LEVEL	아니요	debug, info(기본값), warn, error
PORT	아니요	server port입니다(기본값: 3090, Docker: 3000)

프로젝트 설정

저장소에 .archon/config.yaml을 만듭니다.

assistants:
  claude:
    model: sonnet  # or 'opus', 'haiku', 'inherit'
    settingSources:
      - project
  codex:
    model: gpt-5.3-codex
    modelReasoningEffort: medium

# docs:
#   path: packages/docs-web/src/content/docs  # Optional: default is docs/

전체 옵션은 설정 레퍼런스를 참고하세요.