AI 재테크 에이전트 만들기: Codex와 하네스 공개 요약
강의에서 다룬 Codex 앱, VS Code, Codex CLI, 프롬프트·컨텍스트·스킬·하네스 흐름을 공개용으로 다시 정리했습니다. 실습 자료와 확장 링크는 후기 작성자 전용 실행팩에서 제공합니다.
AI 재테크 에이전트 만들기: Codex와 하네스 공개 요약
안녕하세요 mouseco 입니다. :)
이번 글은 소모임에서 진행한 “AI를 활용한 나만의 재테크 에이전트 만들기” 강의의 공개 요약본입니다.
처음 공개 글은 너무 짧게 방향만 적어두었는데, 강의에서 실제로 전달하고 싶었던 흐름은 조금 더 길었습니다. 핵심은 AI에게 종목을 찍어달라는 이야기가 아닙니다. 내가 매일 반복해서 확인하는 뉴스, 금리, 환율, 공시, 관심 섹터 정보를 내 기준으로 정리해주는 개인 운영 시스템을 만드는 이야기였습니다.
강의 흐름은 크게 이렇게 잡았습니다.
| 순서 | 내용 |
|---|---|
| 1 | Codex 앱을 먼저 켜고, AI 에이전트와 대화하며 작업을 시작합니다. |
| 2 | VS Code를 설치해 내 컴퓨터의 작업 폴더와 터미널에 익숙해집니다. |
| 3 | Codex 앱의 도움을 받아 Codex CLI까지 연결합니다. |
| 4 | 프롬프트, 컨텍스트, 스킬, 하네스의 차이를 이해합니다. |
| 5 | 재테크 에이전트를 예시로 반복 업무를 구조화합니다. |
| 6 | 이후 OpenClaw, Hermes 같은 도구로 확장할 수 있다는 방향만 봅니다. |
공개 글에서는 전체적인 설계 흐름을 남기고, 후기 작성자 전용 실행팩에는 실제로 다시 따라가기 위한 세부 자료와 확장 링크를 따로 정리했습니다.
먼저 결론
강의에서 가장 현실적인 출발점으로 잡은 흐름은 이렇습니다.
Codex 앱
→ VS Code
→ Codex CLI
→ 프롬프트와 컨텍스트 정리
→ 스킬과 하네스 구조 설계
→ 나만의 반복 업무 에이전트 만들기
처음부터 “완전 자동 투자 봇”을 만들려고 하면 바로 막힙니다. 투자 판단, 데이터 신뢰성, API 연결, 자동 실행, 알림, 보안까지 한꺼번에 얽히기 때문입니다.
그래서 출발점은 작게 잡는 편이 좋습니다.
매일 아침 내가 관심 있는 자산과 연결된 뉴스와 지표를 사실, 해석, 확인할 점으로 나눠 정리하는 브리핑 에이전트 정도면 충분합니다.
이 정도만 만들어도 AI 활용 감각이 완전히 달라집니다. 단순히 “오늘 뉴스 요약해줘”라고 묻는 수준에서 벗어나, 내가 반복해서 보는 기준을 하나의 작업 흐름으로 만들 수 있기 때문입니다.
1. 왜 Codex 앱에서 시작했나
강의에서는 처음부터 터미널 명령어를 외우는 방식으로 가지 않았습니다.
완전 입문자 입장에서는 PowerShell, Git, Node.js, PATH, CLI 같은 단어가 한꺼번에 나오면 바로 부담이 커집니다. 그래서 먼저 Codex 앱을 켜고, 앱 안에서 AI에게 설치와 확인 과정을 물어보는 방식으로 접근했습니다.
Codex 앱을 먼저 쓰면 좋은 점은 단순합니다.
| 상황 | 혼자 할 때 | Codex 앱과 같이 할 때 |
|---|---|---|
| 설치 방법을 모를 때 | 검색 결과를 여러 개 열어봐야 합니다. | 지금 내 환경 기준으로 순서를 물어볼 수 있습니다. |
| 오류가 날 때 | 오류 메시지를 보고 멈추기 쉽습니다. | 오류를 그대로 보여주고 다음 조치를 물어볼 수 있습니다. |
| 명령어가 무서울 때 | 복사해서 붙여넣는 것도 부담됩니다. | 실행 전 “이 명령이 뭘 하는지” 설명을 요구할 수 있습니다. |
| 설치 확인이 어려울 때 | 설치된 건지 아닌지 헷갈립니다. | 확인 명령까지 이어서 요청할 수 있습니다. |
제가 보기엔 여기서 중요한 건 “AI가 코딩을 대신한다”보다 조금 앞 단계입니다.
AI가 내 컴퓨터 작업 환경을 같이 만져주는 파트너가 된다는 점입니다.
이 감각이 생기면 코딩을 모르는 사람도 설치, 오류 확인, 문서 정리, 파일 수정 같은 작업을 조금씩 시도해볼 수 있습니다.
2. VS Code는 작업대입니다
Codex 앱이 대화형 작업실이라면, VS Code는 내 파일을 열어보고 수정하는 작업대에 가깝습니다.
처음에는 VS Code를 “개발자만 쓰는 무서운 프로그램”처럼 느끼기 쉽습니다. 하지만 강의에서 필요한 수준은 아주 단순했습니다.
- 작업 폴더를 하나 만듭니다.
- VS Code에서 그 폴더를 엽니다.
- 왼쪽 파일 목록을 봅니다.
- 아래쪽 터미널을 엽니다.
- Codex가 안내하는 명령을 현재 폴더에서 실행합니다.
이 정도만 해도 많은 일이 가능합니다.
| VS Code에서 보는 것 | 의미 |
|---|---|
| Explorer | 내 프로젝트 파일 목록 |
| Terminal | 명령을 실행하는 곳 |
| Editor | 파일 내용을 직접 확인하고 수정하는 곳 |
| Source Control | Git 변경사항을 보는 곳 |
강의에서 VS Code를 같이 본 이유는, 에이전트가 아무리 좋아도 결국 “어느 폴더에서, 어떤 파일을, 어떤 명령으로” 작업하는지 알아야 하기 때문입니다.
완전 자동화보다 먼저 필요한 것은 작업 위치 감각입니다.
내가 지금 어느 폴더에 있는지
어떤 파일이 바뀌었는지
명령을 어디에서 실행해야 하는지
결과가 성공인지 실패인지
이 네 가지가 보이면 AI 에이전트를 훨씬 안정적으로 쓸 수 있습니다.
3. Codex 앱과 Codex CLI는 역할이 다릅니다
강의에서 자주 나온 질문 중 하나가 이것이었습니다.
Codex 앱을 설치했는데, Codex CLI는 또 뭐예요?
쉽게 나누면 이렇게 볼 수 있습니다.
| 구분 | Codex 앱 | Codex CLI |
|---|---|---|
| 위치 | 데스크톱 앱 또는 앱 화면 | PowerShell, 터미널, VS Code 터미널 |
| 느낌 | 대화형 작업실 | 현재 폴더에서 바로 부르는 실행 도구 |
| 강점 | 설명, 방향 잡기, 설치 도움, 프로젝트 관리 | 파일 수정, 명령 실행, 자동화 흐름 |
| 처음 사용자에게 | 진입 장벽이 낮습니다. | 터미널 감각이 조금 필요합니다. |
| 추천 흐름 | 앱에서 시작합니다. | 앱의 도움을 받아 CLI까지 연결합니다. |
둘 중 하나만 골라야 하는 관계가 아닙니다.
처음에는 Codex 앱으로 시작하고, 어느 정도 익숙해지면 VS Code 터미널에서 Codex CLI를 부르는 식으로 이어가면 됩니다. 앱은 전체 흐름을 잡기 좋고, CLI는 실제 작업 폴더 안에서 빠르게 실행하기 좋습니다.
이걸 재테크 에이전트로 비유하면 이렇습니다.
Codex 앱: 무엇을 만들지 같이 설계하는 곳
VS Code: 자료와 파일을 놓는 작업대
Codex CLI: 그 작업대 안에서 바로 움직이는 실행 도구
4. 프롬프트, 컨텍스트, 스킬, 하네스
재테크 에이전트를 만들 때 제일 중요한 개념은 도구 이름이 아닙니다. 저는 강의에서 아래 네 단어를 구분하는 것이 더 중요하다고 봤습니다.
| 개념 | 쉽게 말하면 | 재테크 예시 |
|---|---|---|
| 프롬프트 | 이번 한 번 시키는 말 | “오늘 경제 뉴스 정리해줘.” |
| 컨텍스트 | 판단에 필요한 배경 | “나는 장기 관점에서 금리, 환율, AI 반도체, 비트코인을 봐.” |
| 스킬 | 특정 일을 잘하기 위한 절차 | 뉴스 수집, 공시 확인, 리스크 문장 검토 |
| 하네스 | 여러 절차를 묶은 운영 구조 | 수집 → 분류 → 검증 → 브리핑 작성 |
처음에는 누구나 프롬프트로 시작합니다.
오늘 경제 뉴스 정리해줘.
조금 지나면 컨텍스트를 붙입니다.
나는 장기 투자 관점에서 ETF, 금리, 환율, 미국 증시,
국내 정책 뉴스, AI 반도체, 비트코인을 보고 있어.
오늘 주요 뉴스 중 내 관심사와 관련 있는 것만 골라서,
사실, 해석, 내가 확인할 점으로 나눠서 정리해줘.
여기까지도 충분히 유용합니다. 하지만 매일 아침 같은 일을 반복한다면, 매번 같은 기준을 다시 쓰는 것도 번거롭습니다. 그때부터 스킬과 하네스가 필요해집니다.
스킬은 일을 잘게 나눠서 안정적으로 처리하게 만드는 장치입니다.
하네스는 그 스킬들을 어떤 순서로 연결할지 정하는 운영 구조입니다.
프롬프트는 한 번 묻는 방식이고, 컨텍스트는 나를 알려주는 방식이고, 스킬은 일을 나누는 방식이고, 하네스는 그 일을 매번 같은 기준으로 굴리는 방식입니다.
5. 재테크 에이전트는 이렇게 작게 시작하면 됩니다
강의의 예시는 재테크였지만, 핵심은 재테크가 아닙니다. 반복해서 보는 자료를 내 기준으로 정리하는 구조가 핵심입니다.
그래도 재테크 예시로 시작하면 이해가 쉽습니다.
처음 목표는 이렇게 잡으면 됩니다.
| 항목 | 내용 |
|---|---|
| 목적 | 장기 투자 관점의 아침 재테크 브리핑 만들기 |
| 입력 | 관심 키워드, 관심 자산, 뉴스, 거시 지표, 내가 적어둔 메모 |
| 분류 기준 | 비트코인, 미국 AI 반도체, 국내 정책 수혜 섹터, 금리, 환율 |
| 출력 형식 | 오늘의 핵심 3줄, 관심 축별 신호, 내가 확인할 것 |
| 검증 기준 | 날짜 확인, 사실/해석 분리, 투자 권유 표현 제거 |
| 전달 방식 | 처음에는 Markdown 파일, 나중에는 이메일이나 메신저 |
처음부터 자동매매나 실시간 알림을 목표로 잡으면 복잡도가 너무 올라갑니다. 그래서 저는 수동 실행 가능한 브리핑부터 만드는 쪽이 좋다고 봅니다.
흐름은 이렇게 나눌 수 있습니다.
뉴스와 지표 수집
→ 내 관심 축별 분류
→ 사실과 해석 분리
→ 리스크 표현 확인
→ 아침 브리핑 작성
→ 저장 또는 전달
각 단계는 하나의 스킬이 될 수 있습니다.
| 단계 | 맡는 일 |
|---|---|
| 수집기 | 필요한 뉴스와 지표 후보를 모읍니다. |
| 분류기 | 내 관심 자산이나 주제와 연결되는 자료를 고릅니다. |
| 검증기 | 날짜, 출처, 과장 표현, 투자 권유 표현을 확인합니다. |
| 작성기 | 매일 읽기 좋은 브리핑 형식으로 정리합니다. |
| 전달기 | 파일, 이메일, 메신저 등으로 보내는 단계입니다. |
여기서 가장 중요한 기준은 “AI가 수익을 내준다”가 아닙니다.
좋은 재테크 에이전트는 시장을 맞히는 도구가 아니라, 내가 시장을 더 일관된 기준으로 보게 만드는 도구에 가깝습니다.
6. 공개용으로 따라가볼 수 있는 최소 실습 흐름
공개 글에서는 세부 설치 명령과 확장 링크를 모두 풀어놓지는 않겠습니다. 대신 어떤 순서로 복습하면 되는지 흐름만 남기겠습니다.
1단계. 내 작업 폴더를 하나 만듭니다
처음부터 큰 프로젝트를 만들 필요는 없습니다.
finance-agent-practice
같은 이름의 폴더를 하나 만들고, VS Code에서 열면 됩니다. 이 폴더는 앞으로 내 재테크 에이전트의 실험장이라고 생각하면 됩니다.
2단계. 내 관심 축을 문서로 적습니다
처음부터 API를 붙일 필요는 없습니다. 먼저 내가 무엇을 보고 싶은지 적는 것이 먼저입니다.
예를 들어 이런 식입니다.
관심 축:
- 비트코인
- 미국 AI 반도체
- 국내 정책 수혜 섹터
- 금리와 환율
- 장기 ETF
브리핑 기준:
- 사실과 해석을 분리한다.
- 투자 권유처럼 보이는 표현은 쓰지 않는다.
- 날짜와 출처가 애매하면 표시한다.
- 내가 추가로 확인할 질문을 남긴다.
이 문서가 바로 컨텍스트의 출발점입니다.
3단계. 한 번짜리 프롬프트로 시작합니다
처음에는 하네스까지 가지 말고, 한 번짜리 프롬프트로 감을 잡는 것이 좋습니다.
아래 관심 축을 기준으로 오늘 경제 뉴스를 정리하는 브리핑 형식을 설계해줘.
관심 축:
- 비트코인
- 미국 AI 반도체
- 국내 정책 수혜 섹터
- 금리와 환율
- 장기 ETF
출력은 오늘의 핵심 3줄, 관심 축별 신호, 확인된 사실, 해석, 내가 확인할 점으로 나눠줘.
투자 권유 표현은 쓰지 말고, 근거가 약한 내용은 따로 표시해줘.
이 단계에서 중요한 것은 완벽한 자동화가 아닙니다. 내가 원하는 출력 형식을 찾는 것입니다.
4단계. 반복되는 기준을 분리합니다
몇 번 써보면 매번 반복되는 문장이 보입니다.
- 관심 축
- 출력 형식
- 검증 기준
- 금지 표현
- 저장 형식
이 반복 기준을 따로 빼두면 컨텍스트가 됩니다. 그리고 그 컨텍스트를 바탕으로 “이제 이 작업을 매일 같은 순서로 하게 만들어줘”라고 요청하면 하네스 설계로 넘어갈 수 있습니다.
7. 자주 막히는 지점
터미널이 너무 낯설 때
터미널은 처음부터 외워야 하는 공간이 아닙니다. 일단은 “명령을 실행하는 창” 정도로만 이해해도 됩니다.
중요한 건 명령어를 외우는 것이 아니라, 명령을 실행하기 전에 AI에게 이렇게 묻는 습관입니다.
이 명령이 무엇을 하는지 설명해줘.
내 PC에서 실행해도 되는지 확인해줘.
실행 후 어떤 결과가 나오면 성공인지 알려줘.
설치는 된 것 같은데 안 될 때
대부분은 현재 폴더, PATH, 로그인 상태, 터미널 재시작 문제입니다.
이럴 때는 오류 메시지를 그대로 복사해서 AI에게 보여주는 것이 제일 빠릅니다.
아래 오류가 났어.
원인을 추측하지 말고, 확인해야 할 순서대로 알려줘.
프롬프트는 좋은데 결과가 매번 흔들릴 때
이건 프롬프트만의 문제가 아닐 수 있습니다.
반복 기준이 문서로 분리되어 있지 않거나, 검증 단계가 없거나, 출력 형식이 매번 달라지기 때문입니다. 이때부터 하네스가 필요해집니다.
내가 매일 반복하는 작업을 단계로 나눠줘.
각 단계의 입력, 출력, 확인 기준을 표로 정리해줘.
처음에는 자동화하지 말고 수동 실행 가능한 구조로 설계해줘.
8. 후기 작성자 전용 실행팩에는 무엇이 더 있나
이 공개 글은 전체 그림을 이해하기 위한 요약본입니다.
후기 작성자 전용 실행팩에는 실제로 강의 흐름을 다시 이어갈 수 있도록 더 구체적인 내용을 넣어두었습니다.
| 구분 | 공개 요약본 | 후기 작성자 전용 실행팩 |
|---|---|---|
| Codex 시작 | 앱, VS Code, CLI 역할 설명 | 실제로 다시 따라갈 수 있는 설치와 확인 흐름 |
| 프롬프트 | 개념과 예시 | 강의 흐름에 맞춘 복습용 요청문 |
| 하네스 | 왜 필요한지 설명 | 스킬과 하네스 구조를 더 구체적으로 확장하는 방식 |
| 재테크 에이전트 | 수동 브리핑 MVP 방향 | 개인 기준에 맞게 확장하는 starter 흐름 |
| 다음 단계 | OpenClaw, Hermes 방향 소개 | 관련 링크와 참고 자료 정리본 |
공개 글은 지도에 가깝습니다.
후기 작성자 전용 실행팩은 실제로 다시 걸어가볼 수 있는 복습 노트에 가깝습니다.
정리
이번 강의에서 말하고 싶었던 핵심은 “AI에게 투자 답을 물어보자”가 아니었습니다.
먼저 Codex 앱을 켜고, VS Code에서 작업 폴더를 열고, Codex CLI까지 연결합니다. 그다음 내가 반복해서 보는 기준을 컨텍스트로 정리하고, 자주 하는 작업을 스킬과 하네스 구조로 나눕니다.
흐름을 다시 쓰면 이렇습니다.
Codex 앱으로 시작
→ VS Code에서 작업 위치 감각 잡기
→ Codex CLI로 실제 폴더에서 실행
→ 프롬프트에 컨텍스트 붙이기
→ 반복 기준을 스킬로 나누기
→ 전체 흐름을 하네스로 묶기
→ 나만의 재테크 브리핑 에이전트로 확장
좋은 에이전트는 한 번에 모든 것을 자동으로 해주는 마법 도구가 아닙니다.
좋은 에이전트는 내가 반복하던 일을 더 일관된 기준으로 굴러가게 만드는 개인 운영 시스템입니다.
이번 공개 글은 그 구조를 잡기 위한 첫 지도입니다. 실제 복습 자료와 확장 링크는 후기 작성자 전용 실행팩에서 이어서 보면 됩니다.