Cue 음성과 Claude Code로 작은 버그 수정하기

입력 방법 선택하기

다른 앱에서 버그 설명을 수집할 때 Cue를 활용하세요.브라우저에서 문제를 재현하거나, 이슈를 읽거나, 동료의 메모를 정리하는 상황일 수 있습니다. 세부 내용이 생생할 때 임시 메모에 증상을 말로 입력한 뒤 문장을 확인하고, 재사용할 수 있는 요청서로 정리해 Claude Code에 전달하세요. 코딩 작업을 시작하기 전에 여러 앱에 흩어진 맥락을 모을 때 유용한 방식입니다.

프로젝트와 요청이 이미 준비되어 있다면 Claude Code에서 바로 계속하세요.기존 세션에서 짧게 보충할 내용은 직접 입력하거나 붙여넣으면 됩니다. Claude Code 자체에도 음성 입력 기능이 있습니다. 공식 음성 입력 안내서(영문)는 CLI의 /voice를 설명하며, Claude.ai 계정과 로컬 마이크가 필요합니다. 환경 및 계정 요건을 확인하세요. 이 경우 Cue는 선택 사항이며, 요청서를 수집하거나 편집하거나 재사용할 필요가 있을 때 임시 메모를 거치는 것이 도움이 됩니다.

Cue Dictation으로 외부 앱에 입력하기

아래 실습에서는 이 방식을 사용합니다. Cue가 포커스된 임시 메모나 지원되는 프롬프트 입력란에 텍스트를 넣습니다. 내용을 확인하고 전송하는 것은 사용자의 몫이며, 코딩은 Claude Code가 자체 환경에서 수행합니다. Cue 커넥터는 필요하지 않습니다. 메모를 전달해도 다른 앱의 기록, 파일, 권한이 자동으로 넘어가지는 않습니다.

Cue 안에서 Claude 커넥터 사용하기

이는 Cue에서 외부 Agent를 사용하는 별도의 방식입니다. 작업을 보내기 전에 연결, 로그인 상태, 선택한 프로젝트와 권한을 확인하고, 해당 경로에서 사용하는 계정과 과금 방식도 확인하세요. Claude 선택 항목이 보인다는 사실만으로 사용 준비가 끝났다고 볼 수는 없습니다. 설치된 버전에서 실제로 제공되는 컨트롤을 따르세요.

Cue Agent에서 호스팅 모델 사용하기

Cue Agent에게 제공한 증상을 요청서 초안으로 정리하게 한 뒤, 검토하고 전달할 수도 있습니다. Cue Agent에서 Anthropic 모델을 선택해도 Claude Code가 시작되거나 저장소 접근 권한이 부여되지는 않습니다. 호스팅 모델의 이용 자격과 과금은 Cue 계정을 따르며, 외부 Agent 연결과는 별개입니다.

0 개수 보존 실습을 해보세요. Dictation으로 입력한 뒤 텍스트를 명시적으로 전달합니다. 먼저 증상을 말하고 메모에서 zero, null, undefined를 확인한 다음 F-01부터 F-03까지의 자료를 Claude Code에 제공하세요. 직접 실행해서 원래의 실패하는 단언문, 범위가 제한된 패치, 같은 테스트가 통과한 결과를 확보하면 실습이 완료됩니다.

검증할 수 있는 하나의 변경 사항으로 시작하기

이 가이드는 버그 보고 브리프 작성하기를 넘어, 코딩 Agent가 보고서를 전달받은 후 수행할 작업을 설명합니다. 첫 번째 작업은 잘못된 결과, 예상 결과, 그리고 둘 다 발생하는 조건을 서술할 수 있을 만큼 작게 유지하십시오. 버그 수정을 리디자인, 종속성 업그레이드 또는 릴리스와 결합하지 마십시오.

1. 영향을 받는 화면과 임시 메모를 엽니다. 공유 권한이 있는 정보만 사용하십시오. 메모의 입력 필드에 포커스를 맞추고, Cue Settings에 표시된 Dictation 단축키를 사용하고, 녹음을 확인한 다음 증상을 설명합니다. 구성된 제어 기능 사용을 중지하고 처리를 기다린 후 텍스트가 한 번 나타나는지 확인하십시오.
2. 보내기 전에 이름, 숫자, 부정어를 수정하십시오. Dictation은 말을 캡처할 뿐 리포지토리 편집 권한을 부여하지 않습니다. Cue Agent에 보고서 구조화를 요청하는 경우 초안을 요청하고 앱 컨텍스트가 없을 때 관련 메모를 명시적으로 제공하십시오.
3. 대상 프로젝트에서 Claude Code를 엽니다. 작업 디렉터리, 브랜치 및 기존 변경 사항을 확인합니다. 검토한 브리프를 붙여넣거나 포커스가 맞춰진 프롬프트 필드에 짧은 후속 내용을 받아쓰기하십시오. 터미널 프롬프트에 셸 명령을 직접 받아쓰기하지 마십시오.
4. 변경 사항을 제안하기 전에 관련 구현과 테스트를 점검하도록 Claude Code에 요청하십시오. 오류를 재현할 수 없는 경우 패치를 추측할 권한이 아니라 누락된 입력이나 환경 세부 정보를 제공하십시오.

이 튜토리얼은 명시적인 텍스트 인수인계를 사용합니다. Cue의 선택 사양인 외부 Agent 선택기는 자체 연결, 인증 및 권한 확인이 필요하며, Claude 옵션이 표시된다고 해서 커넥터 작동이 증명되는 것은 아닙니다. Cue 자체 Agent용으로 Anthropic 모델을 선택하는 것 또한 Claude Code를 실행하는 것과 동일하지 않습니다. 경로를 선택하기 전에 Agent 및 모델 차이점을 확인하십시오. 다른 도구의 기존 대화가 메모와 함께 자동으로 이동하지는 않습니다.

실습: 결과 라벨에서 0 개수 보존하기

다음의 가상 JavaScript 실습은 의도적으로 규모가 작습니다. 작업은 Cue나 업무용 애플리케이션을 수정하는 것이 아니라 라벨 함수를 수정하는 것입니다. 새 일회용 폴더에만 이 파일들을 생성하십시오. 테스트를 실행하려면 Node.js가 필요합니다. 코드 예제는 Cue 명령이 아닌 일반 JavaScript입니다.

Source F-01 — 의도된 동작: 이 연습의 입력은 0 이상의 정수와 누락된 값을 나타내는 null 또는 undefined로 한정합니다. 0도 유효한 개수이므로 0 results를 표시하고, 양의 정수는 기존의 '숫자 + results' 형식을 유지합니다. 누락된 값은 No count를 표시해야 합니다. 입력 유효성 검사, 단수형 표현, 다른 입력 타입이나 값에 대한 동작은 연습 범위에서 제외하며, 이에 대한 검증 규칙은 정의하지 않습니다.

Source F-02 — 시작 구현, result-label.mjs:

export function resultLabel(count) {
  return count ? `${count} results` : 'No count';
}

Source F-03 — 현재 관찰 결과: resultLabel(0)을(를) 호출하면 No count이(가) 반환됩니다. 이는 제공된 코드에서 비롯된 것이며, 기록된 Cue 또는 Claude Code 실행 결과가 아닙니다. 이 연습은 귀하의 프로젝트에서 다른 버그를 유발하는 원인을 규명하지 않습니다.

임시 메모에 다음과 같이 말해 보십시오. “0개의 결과는 실제 카운트이지 누락된 카운트가 아닙니다. F-01부터 F-03까지 사용하십시오. 이 차이만 수정하고 null과 undefined는 누락된 상태로 유지하며 원래 버그를 포착하는 테스트를 보여주십시오. 아무것도 게시하지 마십시오.” 전사된 메모에 여전히 zero, null, undefined가 올바르게 표기되어 있는지 확인하십시오.

여기서 음성을 사용하는 목적은 문제가 생생할 때 의도를 포착하는 것입니다. 맞춤법이 중요한 경우 코드에서 식별자를 복사하십시오. 모든 문장 부호를 말하거나 전체 파일을 소리 내어 읽을 필요는 없습니다.

실패하는 회귀 테스트를 요청한 후 최소 패치 요구하기

Claude Code에 다음과 같은 공개 동작 검사가 포함된 result-label.test.mjs을(를) 추가하도록 요청하십시오. 실제 프로젝트에서는 이 예제의 설정을 강제하는 대신 기존 테스트 러너를 사용하십시오.

import assert from 'node:assert/strict';
import test from 'node:test';
import { resultLabel } from './result-label.mjs';

test('zero is a count; only null or undefined is missing', () => {
  assert.equal(resultLabel(0), '0 results');
  assert.equal(resultLabel(null), 'No count');
  assert.equal(resultLabel(undefined), 'No count');
  assert.equal(resultLabel(3), '3 results');
});

node --test result-label.test.mjs을(를) 실행합니다. F-02에 대해 zero 단언은 실패해야 합니다. 누락된 Node 설치, 가져오기 오류 또는 실행되지 않는 테스트는 예상된 회귀 실패가 아닙니다. 구현을 변경하기 전에 실제 출력을 저장하십시오.

함수의 대체 후보는 다음과 같습니다.

export function resultLabel(count) {
  return count === null || count === undefined ? 'No count' : `${count} results`;
}

해당 후보를 일회용 실습에만 적용하십시오. 테스트를 다시 실행하고 변경된 함수를 검사하십시오. 녹색 통과 결과는 이 네 가지 입력을 다루는 것일 뿐, 가능한 모든 입력이 유효하다거나 무관한 애플리케이션을 안전하게 배포할 수 있음을 증명하지는 않습니다.

실제 수정의 경우 먼저 실패하는 검사를 요청하고, 제한된 구현을 승인한 다음, 동일한 검사와 인접한 기존 테스트를 통과하도록 요구하십시오. Anthropic의 공식 모범 사례는 검증 가능한 작업과 탐색 및 구현의 분리를 강조합니다. 본 실습은 음성에서 시작된 작업에 그 아이디어를 적용합니다. 해당 문서가 Cue 통합을 검증하지는 않습니다.

음성 기반 수정 승인 브리프 복사하기

전송하기 전에 대괄호 필드를 바꾸십시오. 인용된 자료가 명령 실행 권한으로 오인되지 않도록 작업 지침 아래에 출처를 유지하십시오.

작업: 이 리포지토리에서 아래에 설명된 단일 동작을 수정하십시오.
작업 위치: [확인된 프로젝트 및 브랜치]
소스: [검토된 증상, 입력, 예상 출력, 실제 출력]
범위: [하나의 동작 및 영향을 받는 영역]
보존 대상: [기존 작업 및 변경해서는 안 되는 동작]
먼저 현재 diff를 검사하고 실제 호출 경로를 찾으십시오.
공개 인터페이스를 통한 테스트로 버그를 재현하십시오.
설정 오류가 아니라 이 버그로 인해 실패함을 보여주십시오.
범위를 승인한 후 가장 작은 관련 변경을 수행하십시오.
해당 테스트와 적용 가능한 인접 검사를 다시 실행하십시오.
증거: 실제 명령, 종료 결과, 관련 출력 및 범위가 지정된 diff.
차단된 경우 누락된 사실을 밝히십시오. 통과를 위해 단언을 약화하지 마십시오.
커밋, 푸시, 배포, 자격 증명 변경 또는 관련 없는 파일 편집을 하지 마십시오.
남은 위험과 짧은 인수인계 내용을 반환하십시오. 릴리스 승인을 위해 멈추십시오.

수정 사항의 인수인계 준비 여부 결정하기

• 재현: 원래의 0 카운트 검사가 올바른 이유로 실패했습니다. Agent가 “재현할 수 없음”을 보고하면 작업은 조사 단계로 유지됩니다.
• 범위: 패치는 관련 없는 서식 지정, 유효성 검사 또는 종속성을 추가하지 않고 누락된 값과 0을 구분합니다. 작업 전에 수행된 변경 사항을 포함하여 변경된 모든 파일을 검토하십시오.
• 증거: 실제로 실행된 명령과 해당 출력을 요청하십시오. “테스트가 통과해야 함”은 실행 결과가 아닙니다. 환경 제한으로 검사를 수행할 수 없었던 경우 인수인계에 해당 제한을 유지하십시오.
• 제품 결과: 함수 테스트가 UI에서 해당 함수를 사용함을 증명하지는 않습니다. 실제 앱에서는 단위 또는 통합 검사가 통과한 후 사용자의 가시적 시나리오를 반복하십시오.
• 릴리스 상태: 로컬 수정, 커밋, 푸시 및 배포를 별도로 기록하십시오. 담당자가 다음 단계를 승인하고 리포지토리의 릴리스 검사를 통과할 때까지 프로덕션을 변경하지 마십시오.

이 실습을 위한 예시 인수인계 내용은 다음과 같습니다. “제안된 변경 사항은 누락된 값과 0을 분리합니다. 예상 적용 범위: 0, null, undefined 및 3. 실제 테스트 상태: 이 실행 결과에서 채워 넣으십시오. 기타 입력 및 UI 통합: 포함되지 않음.” 마지막의 불확실성을 확신에 찬 성공 진술로 바꾸지 마십시오.

실패를 숨기지 않고 복구하기

패치에 대한 두 번째 관점을 얻으려면 범위가 지정된 Codex 코드 검토로 계속 진행하십시오. 녹음으로 전달된 배경 정보의 경우 먼저 소스 연결 컨텍스트 패킷 빌드를 수행하십시오.

Cue로 사용해 보기

구성된 단축키를 사용하고 Cue Settings에서 활성 모드를 확인하십시오. 사용 가능한 앱 컨텍스트와 작업은 권한, 버전 및 계정에 따라 다릅니다. 기밀 자료를 제공하기 전에 개인정보 처리방침 (English)을 읽어보십시오. 본 가이드는 모든 처리가 사용자의 기기에 유지된다고 보장하지 않습니다.

컴퓨터용 Cue 다운로드 · 현재 요금제 (English)

도움이 필요하거나 오류를 발견하셨나요? Cue 지원팀에 문의 (English)하거나 eli@sophoninc.com으로 이메일을 보내십시오. Cue 버전, 플랫폼, 모드 및 민감 정보를 가린 예시를 포함해 주십시오. 비밀번호, 토큰 또는 비공개 회의 자료는 보내지 마십시오.