Skip to main content
Codex CLI는 OpenAI의 로컬 명령줄 코딩 에이전트입니다. 터미널에서 실행되고 선택한 워크스페이스를 읽으며 파일을 편집하고 명령을 실행합니다. 개발 작업 중에는 설정된 샌드박스와 승인 규칙을 따릅니다.

짧은 답변

로컬 저장소의 코드 변경, 코드 리뷰, 테스트 수정, 스크립트 및 여러 단계의 엔지니어링 작업을 에이전트에게 맡길 때 유용합니다. Codex CLI는 일반 ChatGPT 대화와 다릅니다. 코드를 제안하는 데 그치지 않고 현재 디렉터리, 프로젝트 지침, 도구 결과 및 로컬 실행 권한을 사용해 작업합니다.

Codex CLI, App, Web 비교

자세한 차이는 Codex CLI, Codex App 및 Codex Web 비교를 확인하세요.

이 내용이 필요한 경우

  • @openai/codex를 처음 설치함
  • Codex CLI, Codex App, Codex Web을 비교 중임
  • agent가 local project의 files를 편집하게 하려 함
  • custom API provider, Base URL 또는 model을 구성해야 함
  • sandbox, approval 및 AGENTS.md를 이해하려 함

핵심 개념

권장 workflow

  1. 변경할 project directory 안에서 Codex CLI를 시작하세요.
  2. broad edits 전에 relevant files 또는 instructions를 inspect하게 하세요.
  3. complex work에는 files를 변경하게 하기 전에 plan을 요청하세요.
  4. task의 risk에 따라 sandbox와 approval settings를 선택하세요.
  5. durable project rules는 AGENTS.md에 두고 one-time requirements는 current conversation에 두세요.
third-party API provider를 사용한다면 model_provider, base_url, wire_api, config.toml의 model fields에 집중하세요. Codex와 다른 OpenAI-compatible tools는 보통 OpenAI-compatible endpoint를 사용하며 이 문서에서는 https://bettertoken.ai/v1입니다.

일반적인 실수

  • Codex CLI를 chat-only assistant로 취급함
  • Codex CLI, Codex App, Codex Web이 같은 environment에서 실행된다고 가정함
  • matching provider와 Base URL을 구성하지 않고 model만 변경함
  • tests, review 또는 command boundaries 없이 sandbox와 approval settings를 완화함
  • OpenAI-compatible과 Anthropic-compatible Base URLs를 섞음

BetterToken 정보

custom OpenAI-compatible provider를 사용하면 BetterToken이 Codex CLI의 model API layer 역할을 할 수 있습니다. API Key, Base URL, model routing, balance 및 usage records를 처리합니다. BetterToken은 Codex CLI의 local sandbox, approvals, AGENTS.md 또는 command execution policy를 대체하지 않습니다. 일반적인 Codex API 액세스는 BetterToken Codex API 페이지를 확인하세요. 이 FAQ는 Codex CLI의 작동 방식과 로컬 설정을 다룹니다.

관련 문서

참고 자료