코드 모드(Code mode)

코드 모드는 소프트웨어 엔지니어링에 초점을 맞춘 간결한 도구 세트로 Cortex Code CLI(CoCo)를 실행해요. 에이전트를 파일, 셸, 코드 검색 도구로 제한하고 Snowflake 데이터 도구, MCP(Model Context Protocol) 서버, 스킬, 팀 및 스케줄링 기능을 꺼요.

출처: Code mode

본문

코드 모드는 더 작은 도구 세트와 코딩에 맞게 조정된 시스템 프롬프트를 제공하므로 기본 모드보다 턴당 더 적은 토큰을 전송해요. 코딩 중심 작업(애플리케이션 코드와 dbt 프로젝트 작성, 리팩터링, 디버깅)에서는 소프트웨어 엔지니어링 작업에 대해 비슷한 작업 품질로 토큰 비용을 낮춰줘요.

코드 모드는 기본적으로 꺼져 있으며, CLI는 표준 모드로 시작돼요.

코드 모드 활성화하기

--mode 플래그로 코드 모드 세션을 시작해요.

cortex --mode code

--mode는 standard(기본값) 또는 code를 허용해요. 대화형 세션과 headless(--print) 세션에서 동일하게 작동해요.

모든 세션에서 코드 모드를 기본값으로 만들려면 ~/.snowflake/cortex/settings.json에 agentMode를 설정해요.

{
  "agentMode": "code"
}

agentMode를 standard로 설정하면(또는 생략하면) 기본 모드가 유지돼요. 설정을 참고하세요.

코드 모드에서 달라지는 것

코드 모드는 에이전트가 사용할 수 있는 도구를 변경해요. Snowflake 연결은 여전히 인증과 모델 접근에 사용되며, 에이전트가 호출할 수 있는 도구만 제한돼요.

코드 모드에서 사용 가능	코드 모드에서 비활성화
파일 편집(`read`, `write`, `edit`, `apply_patch`)	Snowflake 데이터 도구(`sql_execute`, dbt, 데이터 diff, 노트북)
셸(`bash`, 백그라운드 셸)	MCP 서버와 그 도구
코드 검색(`grep`, `glob`)	스킬(번들 및 사용자 정의)과 스킬 큐레이터
웹 검색 및 가져오기(fetch)	팀, 에이전트 간 메시징, cron 스케줄링
서브에이전트(`task`)	플랜 모드와 골 모드 도구
프로그램 방식 도구 호출(`python_repl`)	시맨틱 코드 검색 — 대신 `grep`과 `glob` 사용

Snowflake 데이터 도구가 꺼져 있으므로 코드 모드는 Snowflake 데이터를 쿼리하거나 수정하는 작업에는 적합하지 않아요. 데이터 작업에는 기본(표준) 모드를, 소프트웨어 엔지니어링 작업에는 코드 모드를 사용하세요.

각 모드를 사용할 시기

코드 모드 — 애플리케이션 코드 작성 또는 편집, 리팩터링, 버그 수정, 테스트 실행, dbt 프로젝트 빌드 또는 수정. 작업이 주로 파일과 셸이고 낮은 토큰 비용을 원할 때 가장 적합해요.
표준 모드(기본값) — Snowflake 데이터 접근(sql_execute, 계정에 대한 dbt 툴링), MCP 커넥터, 스킬, 팀, 플랜·골 모드가 필요한 모든 작업.

코드 모드(Code mode)