Codex 처음 시작하기 · Astra 연결 무료 가이드 | FORTIFY SEO
FORTIFY SEO · 무료 시작 가이드

Codex, 처음이라면
Astra 연결부터 시작하세요

설치하고, 연결하고, 내 프로젝트에 써보기.
어디서 시작할지 몰랐던 분들을 위해
기초 세팅부터 차근차근 정리했습니다.

AI 드마코 | FORTIFY SEO

처음부터 따라 하기 ↓

써보고는 싶은데, 어디서 시작하죠?

Codex가 좋다는 얘기는 들었는데 아직 설치하지 못했거나, Astra를 써보고 싶은데 어디서 연결하는지 모르겠다면 이 자료부터 보세요. 코딩을 공부하고 올 필요는 없습니다. 설치 화면을 열고, 명령어를 따라 입력하고, 막히는 부분을 확인하면서 시작하면 됩니다.

이미 AI로 뭔가 만들어본 분도 있을 겁니다. 화면은 제법 괜찮게 나왔는데, 거기서 뭘 더 해야 할지 모르겠는 거죠. 기능을 더 붙여야 할지, 사람을 모아야 할지, 이걸 서비스로 팔 수는 있는지.

이 자료는 우선 시작하는 데 걸리는 장벽부터 낮추려고 만들었습니다. Codex를 설치하고, 계정과 모델을 확인하고, 내 프로젝트를 열어 첫 작업을 맡기는 순서로 갑니다. 워드프레스 사이트가 있는 분을 위한 연결 방법도 따로 넣었습니다.

연결하고 나면 뭘 할 수 있나요?

홈페이지를 만드는 데만 쓰는 도구는 아닙니다. 다운로드·파일 변환 도구, 업무 프로그램, 키워드 분석 사이트, 편집 자동화, 게임처럼 사람들이 직접 쓰는 기능을 만들 수 있습니다. 외부 서비스를 연결하면 영상 제작, 광고 소재 관리, SNS 업로드와 모니터링으로도 넓혀갈 수 있고요.

내 업무에 쓰거나, 고객에게 제작해주거나, 여러 사람이 이용하는 유료 서비스로 운영하는 방향도 생각해볼 수 있습니다. 다만 만들 수 있는 것과 사람들이 돈을 내고 쓰는 것은 별개의 문제입니다. 누가 필요한지, 어떻게 알릴지, 계속 쓸 이유가 무엇인지가 남습니다.

여러분이 하고 싶은 작업을 Codex에 맡길 수 있도록 기본 환경부터 준비합니다. 그다음 기획, 기능 개선, 검색 노출, 수익화까지 배우고 싶다면 마지막의 과정 안내를 확인해보세요.

만들기가 쉬워질수록, 그다음이 중요해집니다

전에는 아이디어가 있어도 구현에서 막혔습니다. 개발자를 찾아야 했고, 원하는 것을 설명해야 했고, 수정할 때마다 비용과 일정을 고민해야 했죠. 이제는 내 컴퓨터에서 직접 요청하고 결과를 확인해볼 수 있습니다. 머릿속에만 있던 것을 꺼내보기가 훨씬 쉬워졌습니다.

그런데 비슷한 결과물을 다른 사람도 만들 수 있다면 어떨까요. 화면 하나를 완성했다는 사실만으로는 선택받기 어렵습니다. 실제로 써보니 편한지, 필요한 사람이 발견할 수 있는지, 한 번 쓰고 다시 찾아올 이유가 있는지에서 차이가 납니다.

그래서 지금 시작한다는 건 새 도구의 이름을 먼저 아는 것보다, 내 일을 맡겨보고 고치는 경험을 쌓는 데 의미가 있습니다. 처음에는 작은 작업이어도 괜찮습니다. 직접 써본 사람은 다음에 무엇을 물어봐야 할지, 어디가 부족한지 조금씩 알게 됩니다.

처음이면 설치부터, 이미 쓰고 있다면 연결부터Codex가 처음이라면 순서대로 따라오세요. 설치를 끝냈다면 로그인·Astra 선택으로, 이미 작업 중이라면 사이트 연결이나 다음 단계로 이동해도 됩니다. 자료는 무료이며, 이용하는 AI·호스팅·외부 서비스 비용은 별도입니다.

CHAPTER 0 시작 전에 알아둘 이름 몇 가지

설명마다 Codex, Astra, API 같은 이름이 나오니 시작도 하기 전에 복잡하게 느껴질 수 있습니다. 지금은 아래 정도만 구분하면 됩니다.

이름지금 알아둘 것
Codex파일을 읽고, 코드를 만들고, 작업을 실행하는 OpenAI의 도구입니다.
GPT-6 Astra작업을 이해하고 답을 만드는 OpenAI 모델입니다. 사용하는 계정과 환경에서 제공하는지 확인해야 합니다.
터미널컴퓨터에 글로 명령을 입력하는 창입니다. 이 가이드에서는 명령어를 복사해 실행합니다.
프로젝트 폴더내가 만들 파일과 작업 내용을 모아두는 폴더입니다.
워드프레스사이트와 콘텐츠를 관리하는 도구입니다. 모든 프로젝트에 필요한 것은 아닙니다.
Vercel만든 웹사이트나 웹앱을 인터넷에 올릴 때 선택할 수 있는 배포 서비스입니다.
Orca사용 중인 버전의 기능에 따라 Codex 연결과 프로젝트 작업을 이어갈 수 있는 환경입니다. 필수 준비물은 아닙니다.

Astra를 따로 설치한 뒤 Codex와 연결하는 식으로 생각할 필요는 없습니다. Codex에서 로그인한 계정이 사용할 수 있는 모델을 확인하고 선택하는 순서입니다. 모델의 기능과 앱의 음성·화면 공유 기능도 구분해서 보세요. Astra 공식 안내 ↗

지금 필요한 준비물

컴퓨터, 인터넷, 사용할 OpenAI 계정을 준비하세요. 처음부터 서버나 도메인을 살 필요는 없습니다. 내 컴퓨터에서 작업을 시작한 뒤, 사이트를 공개하거나 기존 사이트에 연결할 때 필요한 것을 준비하면 됩니다.

지금 열어두면 편한 창은 세 가지입니다

이 가이드를 읽는 브라우저, 명령을 입력할 터미널, 작업 파일을 볼 폴더입니다. 설치하는 동안에는 브라우저와 터미널을 오가고, 작업을 시작한 뒤에는 폴더에 실제로 파일이 생겼는지 확인하게 됩니다. 처음부터 여러 편집기와 자동화 도구를 동시에 익힐 필요는 없습니다.

또 하나 구분해두세요. 터미널에 codex를 입력하는 것은 프로그램을 여는 일이고, 그 안에서 “이 파일을 읽어줘”라고 말하는 것은 작업을 맡기는 일입니다. 같은 창에 표시되더라도 지금 어느 입력 화면에 있는지에 따라 쓸 수 있는 명령이 달라집니다.

비용은 어디서 생기나요?

자료를 읽는 비용과 도구를 사용하는 비용은 나누어 보면 이해하기 쉽습니다. Codex를 쓰는 계정의 이용 조건이 있고, 나중에 사이트를 올리면 호스팅과 도메인 비용이 생길 수 있습니다. 영상 생성처럼 외부 API를 붙이면 그 서비스의 이용료도 따로 봐야 합니다.

지금 단계에서는 사용할 계정의 조건부터 확인하세요. 아직 무엇을 만들지 정하지 않았다면 서버부터 결제할 이유는 없습니다. Codex가 다른 서비스 가입을 제안해도 어떤 작업에 필요한지, 지금 꼭 필요한지 설명을 듣고 결정하면 됩니다.

CHAPTER 1 Codex 설치하기

여기서는 Windows와 Mac에서 따라 할 수 있는 터미널 방식으로 설명합니다. 이미 Codex를 사용하고 있다면 다음 장으로 넘어가세요.

1Node.js 설치

Node.js 공식 사이트에서 LTS 설치 파일을 받습니다. 실행한 뒤 기본 설정으로 설치하세요. 이 가이드에서 사용하는 Codex 설치 명령을 실행하기 위한 준비입니다.

2터미널 열기

Windows는 시작 메뉴에서 PowerShell을 검색해 엽니다. Mac은 Spotlight에서 터미널을 검색하세요. 아래 명령을 한 줄씩 입력하고 Enter를 누릅니다.

node --version
npm --version

두 명령 모두 버전 숫자가 나오면 다음으로 넘어가세요. 설치했는데 인식하지 못하면 터미널을 닫고 다시 열어보세요.

node는 설치한 실행 환경을, npm은 프로그램을 설치하는 도구를 확인하는 명령입니다. 표시된 숫자를 외울 필요는 없습니다. 두 도구 모두 호출되는지 확인하는 과정이라고 생각하세요.

명령을 입력했을 때 글자가 여러 줄 올라와도 당황하지 마세요. 설치 진행 내용이나 안내일 수 있습니다. 입력할 수 있는 줄이 다시 나타날 때까지 기다린 뒤 다음 명령을 넣습니다. 오류가 보이면 맨 마지막 줄만 지우고 재시도하기보다, 어떤 명령에서 어떤 메시지가 나왔는지 남겨두세요.

3Codex 설치 명령 실행

아래 명령을 복사해서 실행합니다. 설치가 끝나면 두 번째 명령으로 버전을 확인하세요.

npm install -g @openai/codex
codex --version
PowerShell에서 스크립트 실행 오류가 뜬다면npm 대신 npm.cmd, codex 대신 codex.cmd로 실행해보세요. 시작 메뉴에서 명령 프롬프트(cmd)를 열어 같은 명령을 실행해도 됩니다.

Codex 버전이 표시되면 설치는 끝났습니다. 이제 사용할 계정으로 로그인하겠습니다. 설치 방식이 달라졌거나 오류가 계속되면 공식 CLI 안내를 함께 확인하세요.

설치하면서 자주 헷갈리는 부분

명령어는 위에서부터 한 줄씩 실행하세요. 웹페이지에 적힌 설명 문장이나 코드 블록 바깥의 글까지 복사하면 엉뚱한 명령으로 인식할 수 있습니다. 영문 철자를 외워서 옮기기보다 필요한 줄을 그대로 복사하는 편이 편합니다.

이 과정은 새 프로젝트를 만들 때마다 반복하는 작업이 아닙니다. 같은 컴퓨터에 Codex가 설치되어 있다면 다음에는 작업 폴더를 열고 실행하면 됩니다. 다른 컴퓨터로 옮겼거나 설치 상태에 문제가 생겼을 때 이 장으로 돌아오세요.

CHAPTER 2 로그인하고 Astra 선택하기

1Codex 실행

터미널에서 아래 명령을 입력합니다. 처음 실행하면 로그인 안내가 나옵니다.

codex
2사용할 계정으로 로그인

ChatGPT 계정으로 시작하려면 Sign in with ChatGPT를 선택합니다. 브라우저에서 사용할 계정으로 로그인하고 인증을 마친 뒤 터미널로 돌아오세요.

API 키로 접속하는 방식도 있지만 처음이라면 로그인 경로부터 확인하세요. ChatGPT 계정으로 사용하는 방식과 API 키로 사용하는 방식은 비용 기준이 다릅니다. 구독에 포함되는 이용 범위와 API 사용료를 같은 것으로 생각하지 마세요. 로그인 방식 안내 ↗

3모델 목록 확인

Codex가 실행된 상태에서 대화 입력창에 아래 명령을 입력합니다. 터미널에 바로 입력하면 동작하지 않으니, 먼저 Codex 대화 화면이 열려 있는지 확인하세요.

/model

목록에 GPT-6 Astra가 있다면 선택합니다. 추가 설정은 처음에는 기본값으로 시작해도 됩니다. 목록에 보이지 않으면 Codex 업데이트 여부와 계정의 모델 접근 권한을 확인하세요. 이름을 직접 입력한다고 접근 권한이 생기지는 않습니다.

4선택된 모델과 접속 상태 확인

아래 명령으로 현재 설정을 확인합니다. 대화가 가능한 상태까지 확인했다면 다음 장에서 작업 폴더를 준비합니다.

/status

명령어는 Codex 공식 명령 안내에서 확인할 수 있습니다. 다른 앱에서 Codex를 사용한다면 해당 앱의 모델 선택 화면을 확인하세요.

Astra가 아직 표시되지 않는 경우현재 사용할 수 있는 모델로 프로젝트 열기와 기본 작업을 먼저 익혀도 됩니다. Astra 사용 가능 여부는 로그인한 계정과 사용 환경에서 따로 확인하세요.

로그인은 됐는데 연결이 끝난 건가요?

여기서 확인한 것은 Codex가 내 계정으로 응답할 수 있는지입니다. 내 워드프레스나 배포 계정에 접근하는 것은 별도입니다. ChatGPT 로그인이 됐다고 내 사이트의 관리자 권한까지 자동으로 전달되지는 않습니다.

다음 장에서는 먼저 내 컴퓨터의 폴더를 열겠습니다. 파일을 읽고 작업할 수 있는지 확인한 뒤 사이트 연결로 넘어가면, 나중에 문제가 생겨도 계정 문제인지 폴더 문제인지 사이트 인증 문제인지 구분하기 쉽습니다.

모델을 고른 뒤에는 간단히 “한국어로 답해줘. 나는 처음 사용하는 사람이니 필요한 작업을 순서대로 설명해줘”라고 말해보세요. 답변이 오면 대화가 되는 상태입니다. 모델 이름은 답변 속 자기소개보다 모델 선택 화면과 /status에서 확인하세요.

CHAPTER 3 내 프로젝트를 열고 첫 요청하기

채팅창에서 설명을 듣는 것과 내 파일을 실제로 수정하게 하는 것은 다릅니다. Codex가 어느 폴더에서 작업할지 정해주겠습니다.

1작업 폴더 만들기

파일 탐색기나 Finder에서 문서 폴더 안에 my-first-project라는 폴더를 만듭니다. 기존 프로젝트가 있다면 그 폴더를 사용하세요. 중요한 파일은 먼저 복사해두는 편이 좋습니다.

2해당 폴더에서 터미널 열기

Windows는 폴더를 연 뒤 주소창에 powershell을 입력하고 Enter를 누릅니다. Mac은 폴더를 우클릭해 ‘폴더에서 새로운 터미널 열기’를 선택합니다. 메뉴가 없다면 터미널에 cd 를 입력한 뒤 폴더를 끌어다 놓고 Enter를 누르세요.

3Codex를 실행하고 폴더 확인

그 터미널에서 codex를 실행합니다. 폴더 신뢰나 접근 권한을 묻는다면 내가 선택한 작업 폴더가 맞는지 확인하고 진행하세요. 첫 요청은 아래처럼 해보세요.

첫 연결 확인
나는 Codex를 처음 사용해.
지금 작업 중인 폴더 경로와 그 안의 파일을 확인해줘.
기존 파일은 수정하지 말고, 무엇을 할 수 있는 상태인지 쉽게 설명해줘.

답변에 나온 폴더 경로가 내가 연 폴더와 같은지 보세요. 다른 폴더라면 작업을 시작하지 말고 올바른 위치에서 다시 실행합니다.

새로 만든 빈 폴더라면 파일이 없다고 나오는 것이 정상입니다. 반대로 기존 프로젝트를 열었다면 내가 알고 있는 파일이 보이는지 확인하세요. 폴더를 여러 개 만들어두고 헷갈리는 경우가 있으니, 처음에는 한 프로젝트를 한 폴더에 모아두는 편이 좋습니다.

하고 싶은 일을 내 말로 적어보세요

전문 용어를 몰라도 됩니다. ‘누가 쓰는지’와 ‘어떤 일을 편하게 하고 싶은지’를 먼저 적으세요. 아직 아이디어가 정해지지 않았다면 평소 반복하는 일이나 불편했던 상황부터 설명하면 됩니다.

“좋은 프로그램을 만들어줘”라고만 하면 Codex가 빈 부분을 추측하게 됩니다. 어떤 파일을 다루는지, 지금은 어떻게 일하는지, 결과를 어디서 보고 싶은지까지 알려주면 첫 답변부터 내 상황에 가까워집니다. 길고 그럴듯한 프롬프트보다 실제 상황을 정확히 적는 것이 먼저입니다.

예를 들어 작업에 쓰는 자료가 있다면 민감한 내용을 뺀 샘플을 폴더에 넣고 파일 이름을 알려주세요. 이미 사이트가 있다면 주소와 바꾸고 싶은 부분을 적으면 됩니다. 무엇을 준비해야 할지 모르겠다면 Codex가 먼저 질문하게 하세요.

내 첫 프로젝트 시작하기
나는 코딩을 처음 시작하는 사람이야.
만들고 싶은 것: [사이트, 업무 도구, 프로그램 등]
누가 사용할지: [나, 내 고객, 특정 업무를 하는 사람 등]
편하게 만들고 싶은 일: [평소 불편했던 상황을 내 말로 설명]
이미 가진 것: [기존 사이트 주소나 파일 / 없으면 없음]

바로 만들기 전에 내가 말한 내용을 정리해줘.
시작하는 데 꼭 필요한 질문부터 해줘.
설치하거나 가입해야 할 것이 있으면 이유와 순서를 설명해줘.
합의한 내용을 이 폴더의 project-note.md에 저장해줘.

폴더에 project-note.md가 생겼다면 직접 열어 읽어보세요. 내 의도와 다르게 적힌 부분을 고쳐달라고 요청합니다. 다음 작업을 시작할 때 이 파일을 먼저 읽게 하면 앞에서 정한 내용을 이어가기 편합니다.

.md는 글을 저장하는 파일 형식입니다. 메모장 같은 텍스트 편집기로 읽을 수 있습니다. 이름이 낯설어도 특별한 프로그램을 새로 배울 필요는 없습니다. 내가 만들려는 것, 이미 정한 것, 다음에 할 일이 알아볼 수 있게 적혀 있으면 됩니다.

다음 작업 이어가기
project-note.md를 먼저 읽어줘.
여기서 가장 먼저 해볼 작은 작업 하나를 제안해줘.
내가 확인할 수 있도록 실행 방법과 확인할 결과를 알려줘.
오류가 나면 전문 용어만 나열하지 말고 다음에 할 일을 설명해줘.

여기까지 하면 Codex에 내 프로젝트를 설명하고, 파일로 남기고, 작업을 이어가는 기본 흐름을 경험한 것입니다. 앞으로 무엇을 만들든 이 방식에서 시작하면 됩니다.

기본 사용 결과를 확인하고, 고치고, 이어가기

처음 요청하는 것까지는 했는데, 답변이 길게 나오면 다시 막힐 수 있습니다. 어디를 눌러야 하는지, 만들어졌다는 파일은 어디 있는지, 이제 끝난 건지 모르겠는 거죠. 이때부터는 결과를 내 눈으로 확인하는 순서를 익히면 됩니다.

“완료했습니다” 다음에 확인할 것

Codex가 작업을 마쳤다고 하면 실행 방법을 물어보세요. 웹페이지라면 열어볼 주소가 필요하고, 프로그램이라면 실행할 파일이나 명령이 필요합니다. 아직 실행하지 못한 부분이 있는지도 함께 설명해달라고 하세요.

만든 결과 직접 열어보기
지금 만든 결과를 내가 직접 확인하고 싶어.
어떤 파일이 생겼고 어디에 저장됐는지 알려줘.
열어볼 주소나 실행할 명령을 순서대로 설명해줘.
내가 직접 입력하거나 눌러볼 것과, 정상일 때 나오는 결과를 알려줘.
네가 확인한 부분과 아직 실행해보지 못한 부분도 구분해줘.

화면이 뜨면 실제로 쓸 때와 같은 순서로 움직여보세요. 글을 입력하고, 버튼을 누르고, 결과를 열어봅니다. 파일을 만드는 도구라면 그 파일까지 열어보세요. 화면에 완료라는 문구가 나오는 것과 내가 원하는 결과물이 제대로 만들어지는 것은 따로 확인할 일입니다.

수정 요청은 내가 본 현상부터 적습니다

“안 돼요”, “이상해요”만으로는 어디를 고쳐야 하는지 찾기 어렵습니다. 어떤 화면에서 무엇을 했고, 무엇을 기대했는데 실제로는 어떻게 됐는지 적어주세요. 코드의 원인을 추측하지 않아도 됩니다. 내가 겪은 일을 정확하게 전달하면 됩니다.

원하는 대로 동작하지 않을 때
확인한 화면이나 파일: [이름 또는 주소]
내가 한 행동: [입력한 내용과 누른 버튼]
기대했던 결과: [원래 나와야 하는 것]
실제로 나온 결과: [오류, 빈 화면, 잘못된 파일 등]

이 문제의 원인부터 확인해줘.
이미 잘 되는 부분을 유지하면서 필요한 부분을 수정해줘.
수정한 뒤 내가 같은 순서로 다시 확인할 수 있게 알려줘.

첫 수정이 끝나면 처음 문제가 생겼던 행동을 다시 해보세요. 해결됐다면 그다음 변경을 요청합니다. 디자인, 기능, 로그인, 결제를 한꺼번에 바꿔달라고 하면 결과가 달라졌을 때 어느 변경 때문인지 파악하기 어려워집니다.

오늘 작업을 마칠 때 남겨둘 메모

처음에는 대화가 길어져도 전부 기억할 것처럼 느껴집니다. 하지만 다음 날 다른 대화를 열거나 작업 환경을 바꾸면 설명을 다시 해야 할 수 있습니다. 실제 파일과 작업 메모를 함께 남겨두면 이어가기 수월합니다.

작업을 마치기 전에
오늘 작업 내용을 project-note.md에 반영해줘.
완료한 것, 확인한 결과, 남은 문제, 다음에 할 일을 적어줘.
다시 실행하는 방법과 필요한 파일 위치도 남겨줘.
비밀번호나 API 키는 메모에 넣지 마.
저장한 위치를 알려줘.

메모가 저장된 것을 확인한 뒤 Codex 대화창에 /quit를 입력하면 종료할 수 있습니다. 다음에 같은 프로젝트 폴더에서 다시 실행하고, 기존 대화를 찾고 싶다면 /resume를 사용하세요. 새 대화로 시작해도 작업 메모를 먼저 읽게 하면 됩니다. 종료·대화 이어가기 안내 ↗

대화 기록과 파일 백업은 역할이 다릅니다작업 메모에는 진행 내용을 적고, 잘 동작하는 파일은 별도로 보관하세요. 변경 전 상태로 돌아가고 싶을 때는 대화 내용만으로 복구하기 어려울 수 있습니다. 익숙해지면 Codex에 Git으로 변경 이력을 남기는 방법을 설명해달라고 요청해도 됩니다.

CHAPTER 4 사이트 연결하기 — 필요한 방식만 선택

‘사이트를 연결한다’는 말도 상황에 따라 다릅니다. 기존 워드프레스의 페이지를 수정하려는 사람과, 새 웹앱을 만들어 인터넷에 올리려는 사람은 준비할 것이 다릅니다. 내 상황에 맞는 항목만 따라가세요.

내 상황이어갈 방법
내 컴퓨터에서 쓸 프로그램지금 연 프로젝트 폴더에서 작업을 계속합니다. 사이트나 도메인 없이 시작할 수 있습니다.
새 웹앱을 만들어 공개하고 싶음로컬에서 먼저 확인한 뒤 Vercel 등 프로젝트에 맞는 배포 환경을 연결합니다.
워드프레스 사이트를 운영 중사이트 주소와 REST API 인증을 준비해 읽기·초안 작성부터 확인합니다.
검색용 콘텐츠와 서비스 기능을 함께 운영워드프레스에 기능을 붙이거나 콘텐츠 사이트와 별도 앱을 연결할 수 있습니다.

SEO·GEO를 고려한 콘텐츠 운영에 워드프레스를 활용할 수 있지만 필수 조건은 아닙니다. 웹앱에도 검색용 페이지를 만들 수 있습니다. 지금은 어떤 쪽이 내 작업에 맞는지만 구분하면 됩니다.

사이트 주소만 알려주면 수정할 수 있나요?

주소로 공개 화면을 보는 것과 내용을 수정할 권한을 갖는 것은 다릅니다. 사람도 홈페이지 주소를 안다고 관리자처럼 바꿀 수는 없죠. Codex에도 맡길 작업에 맞는 접근 방법이 필요합니다. 로컬 파일을 고칠지, 워드프레스의 페이지를 만들지, 배포된 앱을 업데이트할지에 따라 연결할 곳이 달라집니다.

호스팅은 사이트가 돌아가는 공간, 도메인은 사람들이 찾아오는 주소라고 생각하면 됩니다. 프로젝트 파일은 그 안에서 실행할 실제 내용이고요. 주소를 연결하는 일과 파일을 올리는 일을 구분해두면 설정 화면을 볼 때 덜 헷갈립니다.

워드프레스와 별도 앱, 무엇부터 고르면 될까요?

글과 페이지를 자주 발행하고 관리자 화면에서 내용을 운영하려면 워드프레스를 검토할 수 있습니다. 사용자가 입력하고 처리 결과를 받는 기능이 중심이라면 별도 웹앱이 더 잘 맞을 수도 있습니다. 내 컴퓨터에서만 쓸 업무 프로그램은 인터넷에 올리지 않고 시작할 수 있습니다.

중요한 것은 처음 고른 도구에 모든 기능을 억지로 맞추지 않는 겁니다. 이미 운영 중인 콘텐츠 사이트를 유지하면서 별도 기능을 연결할 수도 있습니다. 지금 가진 사이트와 하려는 작업을 Codex에 함께 설명하고, 새로 필요한 것부터 확인하세요.

새 웹앱을 공개하고 싶다면 · 배포 연결의 기본 순서

배포는 내 컴퓨터에서 만든 결과를 다른 사람도 접속할 수 있게 올리는 일입니다. 폴더를 열었다고 자동으로 사이트가 공개되는 것은 아닙니다.

  1. Codex에 프로젝트 실행 방법을 물어보고 내 브라우저에서 먼저 확인합니다.
  2. 프로젝트가 정적 파일인지, 서버나 데이터 저장이 필요한지 확인합니다.
  3. Vercel 같은 배포 서비스에서 계정과 프로젝트를 준비합니다. 비용과 사용 목적에 맞는 플랜을 확인하세요.
  4. 정적 파일은 Vercel Drop으로, 계속 수정할 프로젝트는 Git 저장소 연결 등 지원하는 방식으로 배포합니다.
  5. 생성된 주소를 직접 열어봅니다. 원하는 대로 보이면 그다음 내 도메인을 연결할 수 있습니다.
배포 준비 요청
이 프로젝트를 다른 사람도 접속할 수 있게 공개하고 싶어.
현재 구조에 Vercel이 맞는지부터 확인해줘.
내가 가입하거나 직접 입력해야 할 항목과 작업 순서를 알려줘.
인터넷에 올릴 파일과 올리면 안 되는 인증 파일을 구분해줘.
미리보기로 확인한 뒤 공개할 수 있게 안내해줘.

화면과 기능이 늘어나면 저장소나 별도 서버가 필요할 수 있습니다. 처음부터 모든 서비스를 연결하기보다 지금 프로젝트에 필요한 것부터 준비하세요. Vercel 배포 안내 ↗

워드프레스가 아직 없다면 · 사이트 준비하기

콘텐츠를 발행하며 사이트를 운영할 계획이라면 워드프레스가 한 가지 선택지입니다. 기존 사이트가 있는 분은 새로 만들 필요 없이 다음 연결 과정으로 넘어가세요.

  1. 클라우드웨이즈 등 워드프레스 호스팅을 선택하고 청구 금액을 확인합니다.
  2. 새 애플리케이션을 만들 때 WordPress를 선택합니다.
  3. Access Details에서 사이트 주소와 관리자 접속 정보를 확인합니다.
  4. 관리자에 로그인하고, 방문자가 보는 사이트도 별도 탭에서 열어봅니다.
  5. 도메인을 사용할 경우 도메인 연결과 SSL 설정을 마친 뒤 HTTPS 접속을 확인합니다.

메뉴별 설명이 필요하면 클라우드웨이즈 시작 안내를 참고하세요. 기본 워드프레스 세팅은 기존 가이드에도 정리되어 있습니다.

워드프레스가 있다면 · Codex에서 연결 확인하기

REST API는 워드프레스에 페이지를 읽거나 초안을 만들어달라고 요청하는 통로입니다. 아래 순서로 접근과 인증을 확인하겠습니다. 운영 중인 사이트라면 백업하거나 실습용 복사본에서 시작하세요.

1사이트의 API 주소 열기

아래 주소의 example.com을 내 사이트 주소로 바꿔 브라우저에서 엽니다. JSON 형식의 글자가 나오면 API 경로에 접속한 것입니다. 아직 수정 권한까지 확인한 것은 아닙니다.

https://example.com/wp-json/
2애플리케이션 비밀번호 만들기

워드프레스 관리자 → 사용자 → 프로필에서 ‘애플리케이션 비밀번호’를 찾습니다. 이름을 codex-connect로 입력하고 새 비밀번호를 만듭니다. 페이지 초안 작업에는 편집자 권한을 가진 연결용 계정을 사용할 수 있습니다.

이 값은 평소 로그인할 때 쓰는 비밀번호와 다릅니다. 공개 파일이나 대화에 그대로 붙여 넣지 말고, 아래처럼 실행할 때 숨김 입력으로 받게 하세요. 워드프레스 인증 안내 ↗

3Codex에 연결 확인 요청

아래 요청을 전달합니다. Codex가 안내하는 방법으로 스크립트를 실행하고, 사이트 주소·사용자명·발급한 비밀번호를 입력합니다.

워드프레스 연결 테스트
내 워드프레스와 연결을 확인하고 싶어. 나는 처음 해보는 사람이야.
내 운영체제에서 실행할 연결 테스트 스크립트와 실행 방법을 만들어줘.

- 사이트 URL과 사용자명은 실행할 때 입력받아.
- 애플리케이션 비밀번호는 숨김 입력으로 받고 저장하거나 출력하지 마.
- HTTPS 인증서를 검증하고 요청 시간 제한을 넣어줘.
- 먼저 GET /wp-json/wp/v2/users/me 로 인증을 확인해.
- 성공하면 내가 선택할 때만 POST /wp-json/wp/v2/pages 로 초안 한 개를 만들어.
  제목: Codex 연결 확인
  상태: draft
  본문: 연결 테스트용 초안입니다.
- 페이지 ID와 초안 상태를 알려줘.
- 요청이 시간 초과되면 재생성하기 전에 기존 초안을 먼저 확인해.
- 기존 페이지 수정이나 공개 발행은 하지 마.
4관리자에서 초안 확인

워드프레스 관리자 → 페이지에서 ‘Codex 연결 확인’을 찾습니다. 초안이 보이면 인증과 페이지 작성까지 확인한 것입니다. 없다면 오류 메시지를 Codex에 전달해 원인부터 확인하세요.

API가 연결되어도 테마 파일이나 모든 플러그인을 바로 수정할 수 있는 것은 아닙니다. 앞으로 맡길 작업에 따라 필요한 접근 방식이 달라집니다. 첫 연결에서는 초안 하나로 동작을 확인하면 충분합니다.

CHAPTER 5 Orca를 함께 쓰고 싶다면

Orca까지 꼭 설치해야 시작할 수 있는 것은 아닙니다. Codex에서 먼저 프로젝트를 열고 대화하는 흐름을 익혀두면, 다른 작업 환경에서도 무엇을 연결해야 하는지 이해하기 쉽습니다.

이미 Orca를 쓰고 있다면 현재 버전에서 제공하는 Codex 연결·인증 방식을 확인하고 같은 프로젝트 폴더를 열어보세요. 모델 선택 화면에 Astra가 제공되는지도 확인합니다. 앱에서 선택한 계정과 모델이 앞에서 쓴 환경과 같다고 가정하지 말고 직접 확인하세요.

환경을 옮길 때 챙길 것은 작업 파일입니다

새 환경에서 프로젝트를 연 다음에는 폴더 이름만 보지 말고 안에 있는 파일까지 확인하세요. 앞에서 만든 project-note.md와 실제 작업 파일이 있는 위치여야 합니다. 이름이 비슷한 빈 폴더를 열면 이전 작업이 없는 것처럼 보일 수 있습니다.

대화 기록, 로그인 상태, 사이트 연결 정보는 환경마다 다르게 관리될 수 있습니다. 앞에서 워드프레스에 연결했다고 새 환경에서도 바로 수정할 수 있다고 생각하지 말고, 파일 읽기와 필요한 연결부터 확인하세요. 새로운 도구를 쓰더라도 첫 확인 순서는 같습니다.

기존 작업 이어가기
이 프로젝트 폴더의 project-note.md를 읽어줘.
내가 만들려는 것과 지금까지 정한 내용을 설명해줘.
파일에 접근할 수 있는지 확인하고 다음 작업 하나를 제안해줘.
기존 사이트를 수정하거나 공개하기 전에는 변경 내용을 먼저 보여줘.

내가 작성한 메모와 같은 내용을 이해했는지 확인하세요. 이후에는 같은 프로젝트에서 작업을 이어가면 됩니다. Orca의 메뉴와 지원하는 연결 방식은 버전에 따라 달라질 수 있어, 이 자료에서는 공통으로 확인할 흐름까지만 다룹니다.

연결은 했습니다. 이제 어디에 써볼까요?

처음에는 홈페이지를 떠올리기 쉽지만, 활용 범위는 더 넓습니다. 아래는 만들 수 있는 유형을 살펴보기 위한 예시입니다. 전부 만들거나 지금 구현 방법까지 외울 필요는 없습니다.

유형어디에 쓰는가서비스로 발전시킨다면
다운로드·파일 도구허용된 자료 다운로드, 변환, 정리작업량 기준 이용료, 팀용 도구
업무 프로그램반복 입력, 문서 작성, 자료 취합맞춤 구축, 구독, 업무 비용 절감
키워드·분석 사이트검색 데이터 정리, 변화 확인, 리포트분석 서비스, 유료 리포트
편집 자동화영상·이미지·자막을 반복 처리제작 서비스, 라이선스, 사용량 과금
게임·참여형 콘텐츠브라우저 게임, 퀴즈, 캠페인유료 콘텐츠, 광고, 제작 의뢰
검색 기반 사이트정보 탐색, 상품·업체 비교, 문의 연결내 서비스 판매, 제휴, 광고
영상·광고·SNS 운영 도구소재 생성, 업로드, 대시보드·모니터링운영 서비스, 맞춤 자동화, 구독

예를 들어 Higgsfield의 이미지·영상 생성 API를 연결해 제작 작업을 시작하고, 편집 도구와 SNS 플랫폼을 이어 붙여 결과물 관리와 업로드까지 확장하는 구성을 생각해볼 수 있습니다. 각 서비스가 제공하는 기능과 계정 권한은 따로 확인해야 합니다. Higgsfield 공식 SDK 안내 ↗

도구를 하나 만드는 데서 끝나지 않고, 일의 여러 단계를 연결할 수 있다는 점을 봐주세요. 그 과정에서 내 업무를 줄일 수도 있고, 다른 사람에게 제공할 서비스가 나올 수도 있습니다. 구독이나 이용료는 사람들이 반복해서 쓸 이유를 찾은 뒤 붙일 수 있는 선택지입니다.

처음부터 판매할 서비스를 정하지 못해도 괜찮습니다

내가 자주 하는 일에 먼저 써보면 무엇이 편해졌고 무엇이 불편한지 바로 알 수 있습니다. 파일을 찾는 일이 줄었는지, 같은 내용을 여러 번 입력하지 않게 됐는지, 결과를 확인하는 시간이 줄었는지처럼요. 내가 쓰면서 확인한 불편은 다음 수정 요청을 만드는 재료가 됩니다.

그다음에는 같은 일을 하는 다른 사람도 필요로 하는지 살펴볼 수 있습니다. 내 방식에만 맞는 도구를 한 회사에 맞춰 제공할 수도 있고, 여러 사람이 공통으로 쓰는 기능을 서비스로 묶을 수도 있습니다. 같은 종류의 프로그램이라도 누구에게 어떤 방식으로 제공하느냐에 따라 사업의 형태가 달라집니다.

자동화는 연결한 뒤에도 다듬을 일이 남습니다

영상이 한 번 생성됐다고 반복 제작과 업로드까지 안정적으로 운영되는 것은 아닙니다. 원하는 결과가 나왔는지 검토하고, 실패한 작업을 다시 처리하고, 어떤 계정에 무엇이 올라갔는지 확인할 수 있어야 합니다. 대시보드와 모니터링이 필요한 이유도 여기에 있습니다.

기능을 하나씩 연결하다 보면 단순한 파일 도구가 업무 프로그램이 되고, 혼자 쓰던 프로그램이 다른 사람에게 제공할 서비스로 발전할 수 있습니다. 이 자료에서는 그런 방향이 열려 있다는 것까지 보시면 됩니다. 실제로 어느 부분부터 만들고 운영할지는 내 목적에 맞춰 정해야 합니다.

만드는 건 시작했습니다.
그다음이 막힌다면

Codex가 파일을 만들고 수정하는 걸 보고 나면 하고 싶은 게 많아집니다. 이것도 붙여보고, 저것도 바꿔보고 싶어지죠. 그런데 기능을 늘리는 것만으로 방향이 정해지지는 않습니다.

누구를 위해 만들 것인가. 어떤 기능부터 다듬을 것인가. 사람들은 어디서 이걸 발견할 것인가. 무엇에 돈을 낼 것인가.

처음 시작한 사람은 기획에서, 이미 만든 사람은 개선과 노출에서 막히기 쉽습니다. 검색으로 고객을 모으려면 어떤 주제와 페이지를 준비할지 알아야 하고, 실제로 쓰는 서비스가 되려면 기능의 정확성뿐 아니라 사용 흐름도 다듬어야 합니다.

SEO와 GEO도 도구를 설치했다고 끝나지 않습니다. 사람들이 찾는 질문에 어떤 페이지로 답할지, 내용을 어떻게 구성하고 연결할지, 들어온 사람이 다음 행동을 하게 만들려면 무엇이 필요한지까지 생각해야 합니다. AI 검색에서도 기본적인 검색 접근성과 유용한 콘텐츠가 중요합니다. Google AI 검색 안내 ↗

만들었는데 방문자가 없는 경우

사이트 주소를 공개하면 사람들이 알아서 찾아올 것 같지만, 공개와 유입은 별도의 일입니다. 검색할 사람이 어떤 표현을 쓰는지, 그 사람이 도착할 페이지가 있는지부터 살펴봐야 합니다. 서비스 이름을 아직 모르는 사람에게도 발견될 경로가 필요합니다.

검색으로 모으는 것이 맞는 서비스도 있고, 고객에게 직접 제안하거나 특정 커뮤니티에서 사용자 반응을 보는 편이 맞는 서비스도 있습니다. 검색 노출을 목표로 한다면 제작할 때부터 콘텐츠와 페이지 구조를 함께 생각하는 편이 좋습니다. 만들어놓고 마지막에 “SEO도 해줘”라고 붙이는 것만으로 해결되기 어려운 부분입니다.

방문자는 있는데 사용하지 않는 경우

노출이 늘었다면 이번에는 방문자가 무엇을 하는지 봐야 합니다. 첫 화면에서 용도를 이해하는지, 시작하는 방법이 복잡하지 않은지, 결과가 기대와 맞는지 살펴보세요. 사용할 사람의 문제와 기능이 어긋나 있다면 디자인을 바꾸거나 글을 더 쓴다고 해결되지 않을 수 있습니다.

이때 필요한 것이 기획과 개선입니다. 새 기능을 계속 추가할지, 핵심 기능을 다듬을지, 설명과 사용 순서를 바꿀지 판단해야 합니다. 무엇을 고칠지 정해지면 Codex에 구체적으로 맡길 수 있지만, 방향을 잡는 과정은 여전히 중요합니다.

사용자는 있는데 수익으로 이어지지 않는 경우

사람이 들어오고 기능을 쓴다고 반드시 결제로 이어지지는 않습니다. 무료로 써보는 용도인지, 반복 업무에 꼭 필요한지, 비용을 지불하는 사람이 실제 사용자와 같은지도 봐야 합니다. 광고, 구독, 제작 의뢰, 운영 대행 가운데 내 서비스에 맞는 방식이 무엇인지 생각할 차례입니다.

그래서 수익화를 배우려면 “어떻게 만들까”와 함께 “누가 왜 선택할까”를 다뤄야 합니다. 도구 사용법을 익히는 것에서 한 걸음 더 들어가, 기획과 기능, 유입과 전환을 연결해보는 공부가 필요합니다.

무료 자료에서는 시작할 수 있도록 기초 세팅을 정리했습니다. 내 아이디어를 구체화하고, 만든 결과물을 발전시키고, 검색 노출과 수익화까지 연결하는 법을 배우고 싶다면 강의에서 이어가세요.

기획부터 검색 노출·수익화까지
배우고 싶다면

무엇을 만들지, 어떻게 개선할지,
사람들을 어디서 모을지 막막한 분들을 위한 다음 단계입니다.
2기 과정의 커리큘럼과 실습 방식을 확인해보세요.

2기 과정 자세히 보기 →

내 사업이나 프로젝트를 기준으로 진행하고 싶다면
만들고 싶은 것, 현재까지 만든 것,
막힌 부분을 보내주세요. 1:1 진행 범위를 상담할 수 있습니다.

내 프로젝트 1:1 문의 →

실습 내용·일정·비용은 과정 안내에서,
개별 프로그램·API 연동 범위는 상담에서 확인하세요.

지금 시작해서 쌓을 수 있는 건 직접 만들어보고 수정하는 경험입니다. 연결을 미뤄왔다면 이번에는 여기까지 따라 해보세요. 그다음 필요한 공부가 무엇인지도 훨씬 구체적으로 보일 겁니다.

막혔을 때 확인하세요

오류가 나면 처음부터 다시 설치하기 전에 어느 단계에서 멈췄는지 확인하세요. 아래 표에서 해당하는 항목을 찾아보고, 오류 메시지와 실행한 명령을 함께 전달하면 원인을 찾기 쉽습니다.

먼저 마지막으로 잘 됐던 단계부터 떠올려보세요. 설치 명령이 끝났는지, Codex가 열렸는지, 답변은 오는지, 파일만 못 읽는지에 따라 확인할 곳이 다릅니다. 앞 단계까지 정상인데 뒤에서 막혔다면 그 부분부터 살펴보면 됩니다.

Codex 자체가 실행되지 않을 때는 사용 가능한 다른 채팅창에서 설치 오류를 물어볼 수 있습니다. 단, 그 채팅창에서는 내 컴퓨터를 직접 확인하지 못할 수 있으니 운영체제, 입력한 명령, 오류 메시지를 함께 전달하세요. 답변대로 한 가지를 바꾼 뒤 결과를 다시 확인합니다.

이런 문제가 생겼다면먼저 확인할 것
node·npm을 찾지 못함Node.js 설치 후 터미널을 닫고 다시 열기
PowerShell 실행 정책 오류npm.cmd를 사용하거나 명령 프롬프트에서 실행
codex를 찾지 못함설치 명령의 오류와 설치 경로 확인, 새 터미널에서 재시도
로그인이 진행되지 않음브라우저 인증 완료 여부, 사용 계정, 네트워크 상태
Astra가 목록에 없음Codex 업데이트, 계정 접근 권한, 사용하는 환경의 지원 모델
내 파일을 읽지 못함프로젝트 폴더 경로와 파일 접근 권한
워드프레스 401·403 오류사용자명·애플리케이션 비밀번호, 계정 권한, 보안 설정
워드프레스 404 오류사이트 주소·하위 폴더·/wp-json/ 경로
HTTPS 인증서 오류도메인과 SSL 설정. 인증서 검증을 끄지 말고 연결 상태부터 확인
막힌 부분 질문하기
처음 설정하는 중이라 아래 단계에서 막혔어.
내 컴퓨터: [Windows 또는 Mac]
하려던 일: [설치 / 로그인 / 프로젝트 열기 / 사이트 연결]
실행한 명령이나 작업: [내용]
화면에 나온 오류: [비밀번호와 개인 정보를 지운 오류 내용]

가능한 원인을 설명하고, 먼저 확인할 것 하나부터 알려줘.
내가 결과를 확인하면 다음 단계로 진행해줘.
코딩을 전혀 몰라도 시작할 수 있나요?

이 자료의 설치와 연결은 순서대로 따라 해볼 수 있습니다. 낯선 말이 나오면 Codex에 쉽게 설명해달라고 요청하세요. 작업할 때는 무엇을 바꿨는지, 내가 기대한 대로 동작하는지 직접 확인하는 습관을 들이면 됩니다.

워드프레스와 Orca도 꼭 설치해야 하나요?

둘 다 필수는 아닙니다. Codex와 프로젝트 폴더만으로 시작할 수 있습니다. 워드프레스는 해당 사이트를 운영할 때, Orca는 그 환경에서 작업을 이어가고 싶을 때 선택하면 됩니다.

창을 닫으면 만든 파일도 없어지나요?

디스크에 저장된 작업 파일은 대화창을 닫는 것만으로 지워지지 않습니다. 다만 실행 중이던 미리보기나 프로그램은 종료될 수 있습니다. 작업을 마치기 전에 저장 위치와 다시 실행하는 방법을 확인하고 메모에 남겨두세요.

브라우저에 뜬 주소를 다른 사람에게 보내도 되나요?

주소에 localhost나 127.0.0.1이 들어 있다면 보통 내 컴퓨터에서 확인하는 주소입니다. 다른 사람도 접속하게 하려면 배포 과정이 필요합니다. 프로젝트가 준비됐다면 사이트 연결 장에서 공개하는 순서를 확인하세요.

요청할 때마다 결과가 달라져요.

유지할 부분과 바꿀 부분을 함께 적어보세요. 마음에 들었던 상태의 파일이나 화면이 있다면 기준으로 제시하고, 한 번에 확인할 수 있는 범위로 수정합니다. 중요한 결정은 작업 메모에 반영해 다음 대화에서도 읽게 하세요.

이미 만들고 있는데 검색 노출이나 수익화가 막혔어요.

기초 설치를 다시 할 필요는 없습니다. 현재 사이트나 프로그램이 누구의 어떤 문제를 해결하는지, 어디서 사용자가 들어오는지부터 살펴봐야 합니다. 이 부분을 체계적으로 배우고 싶다면 2기 과정으로, 내 프로젝트에 맞춘 진행이 필요하다면 1:1로 이어갈 수 있습니다.

가이드 업데이트: 2026년 9월 9일. 제품 화면과 지원 모델은 달라질 수 있어 공식 안내를 함께 연결했습니다.