gemini CLI каталогын қалай өзгертуге болады?

Google-дің ашық бастапқы кодты Gemini CLI — Gemini-ді қабықшаңызға (shell) әкелетін терминалға негізделген AI агент — іске қосылғаннан бері жылдам жетілді және қазір бай конфигурацияны, жоба контекст файлдарын (GEMINI.md / .gemini), пайдаланушыға арналған slash-командаларды және жұмыс кеңістігі каталогтарын басқаруды қолдайды. Жоба GitHub-та (ресми репозиторий) белсенді дамуда, кең квоталармен қоғамдық алдын ала қарауға кірді және басқа әзірлеуші құралдармен (редактор интеграциялары және CI/Actions) біріктірілуде. Бірақ командалар ауқымданған сайын немесе сіз дисктер арасында не шектеулі ортада (контейнерлер, компания басқаратын ноутбуктар, Cloud Shell, Windows жүйелері) жұмыс істегенде, тез арада практикалық сұраққа кезігесіз: Gemini файлдарын қайда сақтайды және Gemini қай каталогтардан оқып-жазатынын қалай өзгертуге болады?

Gemini CLI деген не?

Gemini CLI — Google-дің ашық бастапқы кодты командалық жолдағы AI агенті, Gemini модельдерінің мүмкіндіктерін тікелей терминалыңызға алып келеді. Ол кодқа көмек көрсету, файлдар мен жобаларды тексеру, shell командаларын орындау (қорғаныс шараларымен), сондай-ақ Google Search, Model Context Protocol (MCP) кеңейтімдері және Gemini-мен бірге жеткізілетін медиа генерация құралдары сияқты құралдармен интеграциялау үшін интерактивті агент мүмкіндіктерін ұсынады. CLI жеңіл, скрипттелетін және кеңейтілетін болуы мақсатталған; ол ресми репозиторийден қолжетімді және оңай орнатуға арналған пакеттермен жеткізіледі. 

Неліктен каталог маңызды

Gemini CLI конфигурацияны (мысалы, settings.json), жүйелік промпттарды немесе контексті (GEMINI.md), кэштелген тіркелгі деректерін, телеметрия идентификаторларын және басқа тұрақты күйді .gemini каталогында сақтайды. Бұл каталогтың орналасуы мыналарды анықтайды:

• CLI қандай баптауларды жүктейтіні (жаһандық vs. жобаға тән),
• агент қандай «жады» файлдарын оқитынын,
• тіркелгі деректері қайда кэштелетінін (кіру мінез-құлқына әсер етеді),
• бірнеше машина немесе CI орталарында қайталанғыштықты, егер сіз арнайы конфигурация репозиторийін қолданғыңыз келсе.

Каталогты түсіну және (қажет болса) өзгерту көпжобалы жұмыс ағындарында, CI-де, контейнерленген орналастыруларда және конфигурациялары орталықтандырылған командаларда көмектеседі. 

Әдепкі бойынша Gemini CLI конфигурацияны қайда сақтайды?

Әдепкіде CLI .gemini каталогын қолданады. Көпшілік орнатулар үшін ол ~/.gemini (үй каталогындағы .gemini қалтасы) болып шешіледі. CLI жобалық деңгейдегі .gemini файлдарын да қолдайды (мысалы, жоба түбіріндегі .gemini/settings.json), олар сол жоба қалтасында жұмыс істеп жатқан кезде пайдаланушы баптауларын басып жазады. Жүйелік деңгейдегі баптаулар қолданылатын кезде ОС-қа тән орындардан оқылады (мысалы, Linux-та /etc/ немесе Windows-та %PROGRAMDATA%). Типтік жолдар:

• Linux / macOS: ~/.gemini/ (мысалы, /home/alice/.gemini немесе /Users/alice/.gemini).
• Windows: %USERPROFILE%\.gemini (мысалы, C:\Users\Alice\.gemini).
  .gemini ішінде әдетте settings.json, GEMINI.md, commands/ және жергілікті кэштер болады. CLI сондай-ақ жоба түбіріндегі жобаға тән баптаулар үшін жобалық .gemini/ қалталарын оқиды. 

Бұл әдепкі мән маңызды: тарихи тұрғыдан конфигурация каталогы үй каталогындағы .gemini ретінде қатты кодталған.

---

Gemini CLI конфигурация каталогын қалай өзгертуге немесе бағыттауға болады?

Бірнеше практикалық тәсілдер бар — ең қарапайымынан (қажетті қалтада жұмыс істеу) бастап неғұрлым берік әдістерге дейін (орта айнымалылары немесе файлдық жүйе қайта бағыттаулары). Таңдауыңызды іске қосу ортасын қаншалықты бақылайтыныңызға (жергілікті машина vs. CI), қай ОС қолданатыныңызға және уақытша ма әлде тұрақты өзгеріс керек пе — соған қарай жасаңыз.

1) Жобалық деңгейдегі .gemini пайдалану (жобаға тән баптаулар үшін ұсынылады)

Егер сізге жобаға тән баптаулар қажет болса, жоба түбірінде .gemini ішкі каталогын жасап, settings.json, GEMINI.md және басқа жоба файлдарын сонда орналастырыңыз. Gemini CLI сіз оны сол жоба каталогынан іске қосқанда жобалық баптауларды артық көреді:

your-project/├─ .gemini/│  ├─ settings.json│  └─ GEMINI.md└─ src/

gemini-ді қабықшаңыз your-project/ қалтасында тұрғанда іске қосыңыз, сонда CLI сол ағаштан .gemini файлдарын табады (жоба контекстін табу үшін жоғарыға қарай іздейді). Бұл жобаға тән конфигурация үшін ең қауіпсіз әрі айқын әдіс. 

2) Құжатталған орта айнымалыларын пайдалану (қолдау болғанда)

Gemini CLI код базасы мен құжаттар мінез-құлықты өзгерту үшін қолданылатын бірнеше орта айнымалыларын атайды. Олардың кейбірі жүйелік баптауларға немесе арнайы файлдарды басып жазуға арналған:

• GEMINI_API_KEY, GEMINI_MODEL және т.б. аутентификация мен модель таңдау үшін жиі қолданылады.
• Кодта және құжаттарда GEMINI_CLI_SYSTEM_SETTINGS_PATH (жүйелік баптаулар жолын басып жазу үшін) сияқты айнымалыларға және GEMINI_CONFIG_DIR сияқты константтарға (кодта қолданылатын .gemini әдепкі аты) сілтемелер бар. Қауымдастықтың кейбір сұраулары мен PR-лары бүкіл конфигурация каталогын жылжытуға мүмкіндік беру үшін GEMINI_CONFIG_DIR орта айнымалысын қосуды немесе құрметтеуді ұсынады. 

Мысал (bash / macOS / Linux):

# Temporary for this shell sessionexport GEMINI_CONFIG_DIR="$HOME/custom_gemini_dir"​# Or override system settings path if your install supports it:export GEMINI_CLI_SYSTEM_SETTINGS_PATH="/etc/my-gemini/system.settings.json"​# Then rungemini

PowerShell (Windows):

$env:GEMINI_CONFIG_DIR = 'C:\Users\you\CustomGemini'gemini

Маңызды ескерту: соңғы қауымдастық талқылаулары мен мәселелерге сәйкес, GEMINI_CONFIG_DIR кей жерлерде сұралған және кодта аталған — бірақ платформаға тән қателер мен үйлесімсіз мінез-құлық (әсіресе Windows-та) хабарланған. Бұл орта айнымалысына негізделген қайта бағыттау барлық платформада немесе релизде бірдей сенімді болмауы мүмкін дегенді білдіреді. Бұған тәуелді болсаңыз, орнатылған нұсқаңыз үшін Gemini CLI релиз жазбаларын және репозиторий мәселелерін тексеріңіз. 

3) Сессия ішінде Gemini жұмыс кеңістігіне каталогтар қосу

Егер сіз Gemini-дің қосымша каталогтардан хабардар болғанын қаласаңыз (ол контекст ретінде файлдарды оқи алсын), интерактивті /directory командалар жиынтығы бар. Мысалы:

/directory add path/to/another/project/directory list

Бұл конфигурация каталогын жылжытпайды, бірақ агентке жұмыс кеңістігі контекстіне басқа каталогтардағы файлдарды қосуға мүмкіндік береді. Бұл жаһандық конфигурацияңызды өзгертпей-ақ агенттің басқа репозиторийлерге сілтеме жасауы керек болған кезде пайдалы. 

4) Символдық сілтеме немесе файлдық жүйе bind жасау (практикалық айналып өту)

Егер CLI орта айнымалыларын қабылдамаса немесе сізге барлық процестер үшін сенімді шешім керек болса, файлдық жүйелік қайта бағыттауды қолданыңыз:

Unix/macOS жүйелерінде:

# move the original config foldermv ~/.gemini ~/gemini_backup​# create a symlink to your desired locationln -s /path/to/central/gemini-config ~/.gemini

Windows жүйесінде (PowerShell әкімшілік консоль):

# Move the original directoryMove-Item -Path $env:USERPROFILE\.gemini -Destination C:\GeminiConfigBackup​# Create a junction (administrator)New-Item -ItemType Junction -Path $env:USERPROFILE\.gemini -Target C:\CentralGeminiConfig

Бұл тәсіл CLI-ді өзіңіз қалаған орыннан оқуға мәжбүрлейді және CLI-дің жергілікті қолдауын талап етпейді. Ескерту: symlink/junction жасау үшін тиісті файлдық жүйе рұқсаттары қажет және олар контейнер немесе Windows орталарында басқаша әрекет етуі мүмкін. Абайлап қолданыңыз. (Төмендегі “Windows-specific notes” бөлімін қараңыз.)

5) Процесс үшін тиімді үй каталогын өзгерту (контейнер/CI әдісі)

CI-де, контейнерлерде немесе эфемерлік орталарда іске қосқанда, gemini процесі үшін $HOME (Unix) немесе %USERPROFILE% (Windows) орта айнымалысын өзгертуге болады, сонда оның әдепкі ~/.gemini жолы сіз бақылайтын басқа жолға шешіледі:

# Run gemini with a custom HOME (bash)HOME=/ci/workspace/you gemini --some-command​# Or in a container DockerfileENV HOME=/app/userRUN mkdir -p /app/user/.geminiCOPY config /app/user/.gemini

Бұл CI-де қайталанғыштық үшін пайдалы, бірақ сақ болыңыз: HOME-ты өзгерту басқа құралдарға және аутентификация ағындарына (мысалы, Google OAuth кэштері) әсер етуі мүмкін, сондықтан бұл тәсілді оқшауланған контейнерлерде немесе процесс деңгейіндегі орамдарда ғана қолданыңыз.

Gemini CLI-ді CometAPI арқылы қалай орнатуға және пайдалануға болады?

Қысқа жауап: сізде екі практикалық жол бар — (A) Gemini модельдерін CometAPI арқылы тікелей шақыру (ұсынылады және ең қарапайымы), немесе (B) ресми Gemini CLI-ді CometAPI-мен сөйлету: базалық URL-ді баптауды қолдайтын gemini-cli релизін пайдалану (кейбір релиздер/PR-лар мұны қосады) немесе Gemini-CLI сұрауларын CometAPI/OpenAI-стиліндегі шақыруларға аударатын шағын жергілікті прокси іске қосу. 

CometAPI деген не?

CometAPI — жүздеген үшінші тарап модельдерін (Google-дің Gemini отбасы қоса) OpenAI-стиліндегі HTTP API артында ұсынатын API агрегаторы/шлюзі. Тіркелесіз, bearer API кілтін аласыз, содан соң https://api.cometapi.com/v1/chat/completions сияқты endpoint-терді шақырасыз. CometAPI Authorization тақырыбында стандартты bearer токендерді қолданады.

Неліктен CometAPI? Интеграцияға көмектесу үшін ресми API бағасынан төмен баға ұсынады. Gemini CLI орнату және пайдалану жөніндегі нұсқаулық:

Gemini модельдерін CometAPI арқылы тікелей қалай шақыруға болады? (Ұсынылады)

Егер мақсатыңыз жай ғана Gemini модельдерін пайдалану болса және сізге міндетті түрде Gemini CLI мүмкіндіктері қажет емес болса, CometAPI-ді тікелей шақыру қарапайым әрі сенімді.

export COMET_KEY="sk-xxxx"​curl -s -X POST "https://api.cometapi.com/v1/chat/completions" \  -H "Authorization: Bearer $COMET_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "gemini-2.5-pro",    "messages": [      {"role": "system", "content": "You are a helpful assistant."},      {"role": "user", "content": "Summarize the 3 key benefits of unit tests."}    ],    "max_tokens": 300  }' | jq .

Бұл тікелей шақырулар CometAPI-ді скрипттерге, қосымшаларға немесе CI-ге Gemini CLI-ге тәуелді болмай-ақ біріктіруге мүмкіндік береді.

Gemini CLI-ді CometAPI-ді қолдануға мәжбүрлей аламын ба?

Кейбір Gemini CLI нұсқалары/PR-лары Gemini API базалық URL-ін басып жазуға мүмкіндік беретін орта айнымалыларын қосады. Егер орнатылған gemini арнайы базалық URL-ді баптауды және CometAPI кілтін қолдануды қолдаса, оны CometAPI-ге бағыттай аласыз және CometAPI кілтін GEMINI_API_KEY ретінде орнатыңыз (CLI Gemini API кілтінің айнымалысы ретінде GEMINI_API_KEY-ті күтеді).

Мысал:

# example env — *check your gemini-cli docs for exact var names*export GEMINI_API_KEY="sk-xxxxx"                    # CometAPI keyexport GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com/v1"  # if supportedgemini   # run the CLI; it will use the configured base URL

Ақауларды жою: жиі кездесетін мәселелер және шешімдер

Мәселе: Gemini басқа реподан файлдарды көрмейді

1. Іске қосқанда gemini --include-directories /path/to/repo қолдануға тырысыңыз. Немесе сессия ішінде: /directory add /path/to/repo. 
2. Егер репо желілік монтажда болса, рұқсаттарды және CLI процесі пайдаланушысының файлдарды оқи алатынын тексеріңіз.
3. Егер .gemini-ді жылжыту үшін symlink қолданған болсаңыз, GEMINI.md және settings.json үшін CLI-дің symlink-ті бақылайтынын растаңыз (кейбір нұсқалар қауіпсіздік үшін белгілі symlink-терді бақылай бермейді). 

Мәселе: gemini Windows-та ~/.gemini құра алмайды (EPERM)

Бұл әдетте процестің %USERPROFILE% жазуға рұқсаттары жоқ екенін білдіреді. Шешімдер:

• Терминалды әкімші ретінде іске қосыңыз немесе қалта рұқсаттарын реттеңіз.
• symlink арқылы немесе қолдау болғанда орта айнымалысы арқылы арнайы конфигурация орнын орнатыңыз (болашақтағы GEMINI_CONFIG_DIR қолдауын бақылаңыз). 

Мәселе: cd shell режимінде жұмыс каталогын өзгертпейді

Бұл кей платформаларда мойындалған мәселе. Ұсыныс: shell командаларын Gemini CLI процесінің сыртынан іске қосуға ауысыңыз немесе /directory add арқылы каталогтар қосыңыз.

Мәселе: CometAPI модель атаулары күтіміңізге сәйкес келмейді

/v1/models endpoint-ін шақырып, JSON-ды тексеріңіз. Модель идентификаторлары жиі нақты вариант жолдарын қамтиды (мысалы, gemini-2.5-flash-preview-04-17). Сұрауыңызда дәл сол жолды қолданыңыз.

Қорытынды

Gemini CLI-дің әдепкі дизайны түсінікті мінез-құлықты қалайды: пайдаланушы деңгейіндегі әдепкілер үшін жаһандық ~/.gemini және жобаға тән басып жазулар үшін жобалық .gemini. Қауымдастық бұл құралды көппайдаланушы, контейнерленген және корпоративтік орталарға ыңғайлырақ ету үшін көбірек туған конфигурацияланғыштықты (айқын орта айнымалылары немесе жалаушалар) итермелеп келеді.

Gemini CLI каталогын қалай өзгертуге болады: 

Шолу: Gemini CLI пайдаланушы ауқымындағы конфигурация мен контекст файлдарын .gemini каталогында (көбіне ~/.gemini) сақтайды. CLI қолданатын каталогқа әсер ету үшін (1) ағымдағы жұмыс каталогындағы жобалық .gemini-ге сүйеніңіз, (2) қолдау болғанда орта айнымалыларын немесе CLI опцияларын пайдаланыңыз, (3) интерактивті сессияда жұмыс кеңістігіне каталогтар қосыңыз, немесе (4) туған опциялар жоқ кезде файлдық жүйе әдістерін (symlink, bind mount, үй/профиль айнымалыларын өзгерту) қолданыңыз.

Бастау үшін Playground ішінде Gemini 3 Pro сияқты Gemini модельдерінің мүмкіндіктерін зерттеңіз және толық нұсқаулар үшін API нұсқаулығын қараңыз. Қол жеткізбестен бұрын, CometAPI-ге кіргеніңізге және API кілтін алғаныңызға көз жеткізіңіз. CometAPI интеграцияға көмектесу үшін ресми бағадан әлдеқайда төмен баға ұсынады.

Дайынсыз ба?→ Gemini модельдерін тегін сынау !