터미널에 대한 무료 AI 코딩 에이전트인 free-code를 설치하십시오.
free-code는 프로젝트를 읽고, 승인한 diff 파일을 편집하고, 테스트를 실행하고, 실패한 부분을 수정합니다. 한 줄만으로 macOS, Linux 또는 Windows에 설치할 수 있습니다.
curl -fsSL https://free.ai/install.sh | sh
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 URL | Free.ai 클라우드에서 작업을 실행하고 보고서를 얻을 |
free-code tasks | 최근 클라우드 작업 목록 |
free-code rc | Free.ai 앱에서 세션을 보고 운전 |
free-code mcp add | MCP 서버 연결 |
free-code update | 최신 릴리스로 업그레이드 |
free-code config | 설정 보기 |
파일 편집 및 명령 실행 외에도 에이전트는 프로젝트에 이미지, 음성, 음악 및 비디오를 생성하고 오디오를 녹음하고 스크린샷 및 PDF에서 텍스트를 읽고 인용으로 웹을 검색하고 로케일 파일을 번역할 수 있습니다.
업데이트 및 제거
무료 코드 업데이트 설치한 무엇을 통해 업그레이드. 그것을 제거하려면, 같은 도구를 사용:
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
자주 묻는 질문
터미널에서 AI로 코딩 시작
curl -fsSL https://free.ai/install.sh | sh