오픈 소스, MIT 라이선스

터미널에 대한 무료 AI 코딩 에이전트인 free-code를 설치하십시오.

free-code는 프로젝트를 읽고, 승인한 diff 파일을 편집하고, 테스트를 실행하고, 실패한 부분을 수정합니다. 한 줄만으로 macOS, Linux 또는 Windows에 설치할 수 있습니다.

macOS / Linux / WSL
curl -fsSL https://free.ai/install.sh | sh
Windows (PowerShell)
irm https://free.ai/install.ps1 | iex

파이썬, pip 또는 관리자 권한이 필요하지 않습니다. 업그레이드를 위해 동일한 라인을 다시 실행합니다.

무료로 시작: 6,000 토큰 계정이없는 하루, 30,000 확인 무료 계정과 하루.

다른 설치 방법

The one-line installer uses uv, then pipx, then a private Python environment, whichever works first. If you already use one of these tools, install the freeai-code package directly:

uv tool install freeai-code
pipx install freeai-code
pip install freeai-code
npm install -g freeai-code

npm 패키지는 파이썬 3.9 이상이 필요합니다.

특정 버전 설치

# macOS / Linux
curl -fsSL https://free.ai/install.sh | FREE_CODE_VERSION=<version> sh

# Windows (PowerShell)
$env:FREE_CODE_VERSION = "<version>"; irm https://free.ai/install.ps1 | iex

하나의 설치 방법을 강제로 사용하려면 FREE_CODE_INSTALLER 를 uv, pipx 또는 venv 로 설정합니다.

작동했는지 확인하세요

free-code --version

첫 번째 실행

프로젝트 폴더에서 터미널을 열고 세션을 시작합니다. 계정 없이 바로 작동합니다.

cd your-project
free-code

# Or one task at a time
free-code ask "How does the auth system work?"
free-code run "Add unit tests for the User model"

안전 모드는 기본적으로 켜져 있습니다. diff를 보고 실행하기 전에 각 파일 편집과 명령을 승인합니다. 처음에 free-code는 익명으로 충돌 보고서를 보낼지 여부를 한 번 물어봅니다. 기본 대답은 아니다입니다.

로그인 및 API 키

로그인하면 하루 무료 허용량이 증가하고 토큰 잔액에서 유료 모델을 사용할 수 있습니다. 브라우저가 Free.ai에서 열리고, 승인을 누르면 CLI가 자동으로 키를 받습니다.

free-code login               # opens your browser
free-code login --no-browser  # over SSH: approve from any device with a short code
free-code login --manual      # paste a key or choose your own provider
free-code logout              # forget the key on this machine

또한 계정에서 키를 직접 만들어서 설정할 수도 있습니다. 서버 및 CI에 유용합니다.

free-code config set token sk-free-...
# or, for one shell or a CI job
export FREE_CODE_TOKEN=sk-free-...

무료 계정 만들기

자신의 공급자 키 사용

free-code는 OpenAI, Anthropic, Google 또는 OpenRouter 키를 사용하여 작동합니다. 요청은 키를 사용하여 해당 제공자로 이동합니다.

free-code config set provider anthropic
free-code config set api_key sk-ant-...

모델 선택

free-code는 Free.ai가 제공하는 모든 모델을 나열합니다. 무료 계층 모델이 먼저 나열됩니다. 무료 계층 모델은 하루 허용량 내에서 토큰을 지불하지 않습니다. 유료 모델은 토큰으로 청구됩니다.

free-code models               # chat models, free tier first
free-code models --free        # only models that cost no tokens
free-code models --type image  # image, video, tts, stt, ocr, music ...
free-code config set model <id>  # default model for new sessions

세션 내에서 /model 을 입력하여 전환합니다. 모든 모델 찾기

일반적인 명령

명령그것이 하는 일
free-code이 폴더에서 대화식 세션 시작하기
free-code -c이 프로젝트의 마지막 세션을 다시 시작합니다
free-code ask "..."코드베이스에 대해 한 가지 질문
free-code run "..."하나의 코딩 작업 수행
free-code -p "..."스크립트 및 CI를 위해 답변을 인쇄하고 종료
free-code sessions재개할 수 있는 저장된 세션 목록
free-code tools에이전트가 사용할 수 있는 도구와 승인이 필요한 도구 보기
free-code cloud "..." --repo URLFree.ai 클라우드에서 작업을 실행하고 보고서를 얻을
free-code tasks최근 클라우드 작업 목록
free-code rcFree.ai 앱에서 세션을 보고 운전
free-code mcp addMCP 서버 연결
free-code update최신 릴리스로 업그레이드
free-code config설정 보기

파일 편집 및 명령 실행 외에도 에이전트는 프로젝트에 이미지, 음성, 음악 및 비디오를 생성하고 오디오를 녹음하고 스크린샷 및 PDF에서 텍스트를 읽고 인용으로 웹을 검색하고 로케일 파일을 번역할 수 있습니다.

모든 명령과 옵션은 GitHub의 README에 있습니다.

업데이트 및 제거

무료 코드 업데이트 설치한 무엇을 통해 업그레이드. 그것을 제거하려면, 같은 도구를 사용:

free-code update

uv tool uninstall freeai-code
pipx uninstall freeai-code
pip uninstall freeai-code
npm uninstall -g freeai-code

설치 프로그램이 자체 환경을 만들었다면, 홈 디렉토리의.free-code 폴더와.local/bin의 free-code 파일을 삭제하세요. 설정과 저장된 세션도.free-code에 있습니다.

문제 해결

페이지를 찾을 수 없습니다.

설치 폴더가 PATH에 아직 없습니다. Windows에서 새 터미널을 엽니다. macOS 또는 Linux에서 셸 프로필에 추가하고 새 터미널을 엽니다.

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc   # or ~/.zshrc

오늘의 무료 익명 제한이 사용되었습니다

무료 코드 로그인을 실행하여 로그인하고 무료 계정의 큰 일일 허용량을 얻거나 유료 모델을 사용하는 토큰을 추가하십시오. 가격 정보 보기

설치 프로그램에서 uv를 다운로드할 수 없습니다

어떤 네트워크는 astral.sh를 차단합니다. 대신 pipx 또는 pip로 설치하거나 FREE_CODE_INSTALLER=venv 를 설정하여 파이썬 3.9 이상을 사용합니다.

데비안 또는 우분투에서 python3 -m venv 실패

apt로 python3-venv 패키지를 설치한 후 install 라인을 다시 실행합니다.

free-code 안에 /feedback 를 입력하거나 GitHub에서 문제를 열어보세요. GitHub issues

자주 묻는 질문

free-code는 터미널용 Free.ai 코딩 에이전트입니다. 프로젝트를 읽고, diff 미리보기와 함께 파일을 편집하고, 명령과 테스트를 실행하고, Free.ai 모델을 사용합니다. MIT 라이선스 하에 오픈 소스입니다.

네, 계정 없이도 무료 일일 허용량을 사용할 수 있습니다. 더 큰 일일 허용량을 위해 무료 코드 로그인으로 로그인하십시오. 유료 모델은 토큰으로 청구되며 계정에 잔액이 필요합니다.

macOS, Linux, Windows. macOS, Linux, WSL에서 curl 라인을 사용하고 Windows에서 PowerShell 라인을 사용합니다. 설치 프로그램은 uv를 사용하여 적절한 파이썬을 가져옵니다. 먼저 설정할 필요가 없습니다.

설치 프로그램은 홈 디렉토리의.local/bin 폴더에 free-code를 넣고 관리자 권한을 요청하지 않습니다.

브라우저가 Free.ai 에서 열리면 로그인하고 Approve 를 누르면 CLI가 자동으로 키를 받게 됩니다. SSH를 통해 서버에 연결하면 free-code login --no-browser 를 사용하여 짧은 코드를 출력하여 어떤 장치에서든 승인합니다.

네. 자유 코드 login --manual 을 실행하여 Free.ai 키를 붙여넣거나 자신의 제공자(OpenAI, Anthropic, Google 또는 OpenRouter)를 선택합니다. 요청은 키와 함께 해당 제공자로 이동합니다.

Free.ai가 제공하는 모든 모델을 목록화하기 위해 free-code models 를 실행합니다. 무료 모델을 먼저 실행합니다. --free 또는 --paid 를 필터링에 추가합니다. /model 으로 세션 내에서 전환하거나 free-code config set model 으로 기본값을 설정합니다.

파일 편집과 명령은 컴퓨터에서 실행되며, 모델은 답변해야 할 프로젝트의 부분을 받습니다. 익명 크래시 보고는 켜지지 않는 한 꺼져 있으며, 코드, 프롬프트 또는 파일 경로를 포함하지 않습니다.

uv, pipx, pip 또는 npm 을 통해 업그레이드합니다. 설치 라인을 다시 실행하면 업그레이드됩니다. 하루에 한 번 free-code 는 새로운 릴리스가 있을 때 알려줍니다. 자동으로 설치되지 않습니다.

Use the tool that installed it: uv tool uninstall freeai-code, pipx uninstall freeai-code, pip uninstall freeai-code or npm uninstall -g freeai-code. If the installer used its own private environment, delete the .free-code folder in your home directory and the free-code file in .local/bin.

free-code -p 는 답을 출력하고 종료합니다. --json 을 하나의 JSON 결과에 추가하고 --yes 를 파일 편집을 허용하도록 추가합니다. --yes 를 사용해도 위험한 명령은 차단되고 종료 코드는 작업이 성공했는지 알려줍니다.

이것은 동일한 Free.ai 계정을 사용합니다. free-code rc 는 Free.ai 앱 또는 sessions 페이지에서 터미널 세션을 보고 실행할 수 있게 해주며, free-code cloud 는 Free.ai 클라우드에서 작업을 실행하고 보고합니다.

터미널에서 AI로 코딩 시작

curl -fsSL https://free.ai/install.sh | sh

Windows 및 기타 설치 옵션 · About Free.ai Coder

Free.ai를 좋아하세요? 친구들에게 알려주세요!

더 먹고 싶어? 무료 가입: 일 30,000 토큰 무료로 가입하세요

이 페이지 평가