Codex 구성

공통 구성 (Windows / macOS / Linux 적용 가능)

1. 구성 디렉토리 생성

사용자 홈 디렉토리에 .codex 폴더를 생성하세요:

• macOS / Linux: ~/.codex
• Windows: C:\Users\사용자이름\.codex

디렉토리가 이미 존재한다면 다시 생성할 필요가 없습니다.

2. config.toml 생성

.codex 디렉토리에 config.toml 파일을 새로 만들고 다음 내용을 붙여넣으세요:

Copy
1
model_provider = "codebyai"
2
model = "gpt-5.1"
3
model_reasoning_effort = "high"
4
disable_response_storage = true
5
 
6
[model_providers.codebyai]
7
name = "codebyai"
8
base_url = "https://www.codebyai.net/api/agent"
9
wire_api = "responses"
10
requires_openai_auth = true
11
 
12
[features]
13
web_search_request = true

모델을 변경해야 하는 경우 model 필드만 수정하면 됩니다.

3. auth.json 생성

마찬가지로 .codex 디렉토리에 auth.json 파일을 생성하세요:

Copy
1
{
2
  "OPENAI_API_KEY": "sk-proj-xxxx"
3
}

4. Codex CLI 시작

프로젝트 디렉토리로 이동하여 codex를 실행하세요:

Copy
1
cd your-project
2
codex

다음과 유사한 결과를 확인할 수 있습니다:

5. VS Code에서 사용하기

VS Code Marketplace에서 공식 Codex 확장 프로그램을 설치하세요 (공식 배지가 있는 버전을 선택하세요):

VS Code는 config.toml과 auth.json을 자동으로 읽으므로 별도의 구성이 필요하지 않습니다. 확장 프로그램에서 구성 누락 메시지가 표시되면 위의 단계가 완료되었는지 확인하세요.