--- title: CLI description: opencode CLI seçenekleri ve komutları. --- import { Tabs, TabItem } from "@astrojs/starlight/components" opencode CLI herhangi bir argüman olmadan çalıştırıldığında varsayılan olarak [TUI](/docs/tui)'yi başlatır. ```bash opencode ``` Ancak bu sayfada belgelendiği gibi komutları da kabul eder. Bu, opencode ile programlı olarak etkileşim kurmanıza olanak tanır. ```bash opencode run "Explain how closures work in JavaScript" ``` --- ### tui opencode terminal kullanıcı arayüzünü başlatır. ```bash opencode [project] ``` #### Bayraklar | Bayrak | Kısa | Açıklama | | ---------------------------------------- | ---- | --------------------------------------------------------------------------- | | {"--continue"} | `-c` | Son oturuma devam et | | {"--session"} | `-s` | Devam edecek oturum kimliği | | {"--fork"} | | Devam ederken oturumu fork'lar (`--continue` veya `--session` ile kullanın) | | {"--prompt"} | | Kullanılacak prompt | | {"--model"} | `-m` | provider/model biçiminde kullanılacak model | | {"--agent"} | | Kullanılacak agent | | {"--port"} | | Dinlenecek port | | {"--hostname"} | | Dinlenecek host adı | --- ## Komutlar opencode CLI ayrıca aşağıdaki komutlara da sahiptir. --- ### agent opencode için agent'ları yönetin. ```bash opencode agent [command] ``` --- ### attach `serve` veya `web` komutlarıyla başlatılan, halihazırda çalışan bir opencode arka uç sunucusuna bir terminal ekleyin. ```bash opencode attach [url] ``` Bu, TUI öğesinin uzak bir opencode arka ucuyla kullanılmasına olanak tanır. Örneğin: ```bash # Start the backend server for web/mobile access opencode web --port 4096 --hostname 0.0.0.0 # In another terminal, attach the TUI to the running backend opencode attach http://10.20.30.40:4096 ``` #### Bayraklar | Bayrak | Kısa | Tanım | | ---------------------------------------- | ---- | --------------------------------------------------------------------------------------------- | | {"--dir"} | | TUI'yi başlatmak için çalışma dizini | | {"--continue"} | `-c` | Son oturuma devam et | | {"--session"} | `-s` | Devam edecek oturum açma bilgileri | | {"--fork"} | | Devam ederken oturumu çatalla (`--continue` veya `--session` ile kullanın) | | {"--password"} | `-p` | Temel kimlik doğrulama parolası (varsayılan: `OPENCODE_SERVER_PASSWORD`) | | {"--username"} | `-u` | Temel kimlik doğrulama kullanıcı adı (varsayılan: `OPENCODE_SERVER_USERNAME` veya `opencode`) | --- #### create Özel yapılandırmaya sahip yeni bir agent oluşturun. ```bash opencode agent create ``` Bu komut, özel sistem istemi ve araç yapılandırmasıyla yeni bir agent oluşturma konusunda size yol gösterecektir. --- #### list Mevcut tüm agent'ları listeleyin. ```bash opencode agent list ``` --- ### auth Sağlayıcılar için kimlik bilgilerini ve oturum açmayı yönetme komutu. ```bash opencode auth [command] ``` --- #### login opencode, [Models.dev](https://models.dev) adresindeki sağlayıcı listesi tarafından desteklenmektedir, dolayısıyla kullanmak istediğiniz herhangi bir sağlayıcı için API anahtarlarını ayarlamak üzere `opencode auth login` kullanabilirsiniz. Bu `~/.local/share/opencode/auth.json`'de saklanıyor. ```bash opencode auth login ``` opencode başlatıldığında sağlayıcıları kimlik bilgileri dosyasından yükler. Ayrıca ortam değişkenlerindeki veya projenizdeki `.env` dosyasındaki anahtarları da kullanır. --- #### list Kimlik bilgileri dosyasında depolanan tüm kimliği doğrulanmış sağlayıcıları listeler. ```bash opencode auth list ``` Veya kısa versiyonu. ```bash opencode auth ls ``` --- #### logout Bir sağlayıcıyı kimlik bilgileri dosyasından temizleyerek oturumunuzu kapatır. ```bash opencode auth logout ``` --- ### github Depo otomasyonu için GitHub aracısını yönetin. ```bash opencode github [command] ``` --- #### install GitHub aracısını deponuza yükleyin. ```bash opencode github install ``` Bu komut gerekli GitHub Actions workflow'unu kurar ve yapılandırma adımlarında size rehberlik eder. [Daha fazla bilgi](/docs/github). --- #### run GitHub aracısını çalıştırın. Bu genellikle GitHub Eylemlerinde kullanılır. ```bash opencode github run ``` ##### Bayraklar | Bayrak | Açıklama | | ------------------------------------- | ------------------------------------------- | | {"--event"} | Aracıyı çalıştırmak için GitHub sahte olayı | | {"--token"} | GitHub personal access token | --- ### mcp Model Bağlam Protokolü sunucularını yönetin. ```bash opencode mcp [command] ``` --- #### add Yapılandırmanıza bir MCP sunucusu ekleyin. ```bash opencode mcp add ``` Bu komut, yerel veya uzak bir MCP sunucusu ekleme konusunda size yol gösterecektir. --- #### list Yapılandırılmış tüm MCP sunucularını ve bağlantı durumlarını listeleyin. ```bash opencode mcp list ``` Veya kısa versiyonunu kullanın. ```bash opencode mcp ls ``` --- #### auth OAuth'un etkin olduğu bir MCP sunucusuyla kimlik doğrulaması yapın. ```bash opencode mcp auth [name] ``` Sunucu adı belirtmezseniz mevcut OAuth özellikli sunucular arasından seçim yapmanız istenir. Ayrıca OAuth özellikli sunucuları ve bunların kimlik doğrulama durumlarını da listeleyebilirsiniz. ```bash opencode mcp auth list ``` Veya kısa versiyonunu kullanın. ```bash opencode mcp auth ls ``` --- #### logout MCP sunucusu için OAuth kimlik bilgilerini kaldırın. ```bash opencode mcp logout [name] ``` --- #### debug MCP sunucusu için OAuth bağlantı sorunlarının hatalarını ayıklayın. ```bash opencode mcp debug ``` --- ### models Yapılandırılmış sağlayıcıların tüm mevcut modellerini listeleyin. ```bash opencode models [provider] ``` Bu komut, yapılandırdığınız sağlayıcılardaki modelleri `provider/model` formatında listeler. Bu, [config dosyanızda](/docs/config/) kullanmanız gereken tam model adını bulmak için kullanışlıdır. Modelleri bu sağlayıcıya göre filtrelemek için isteğe bağlı olarak bir sağlayıcı kimliğini iletebilirsiniz. ```bash opencode models anthropic ``` #### Bayraklar | Bayrak | Tanım | | --------------------------------------- | --------------------------------------------------------------------------- | | {"--refresh"} | Modeller.dev'den model önbelleğini yenileyin | | {"--verbose"} | Daha ayrıntılı model çıktısı kullanın (maliyetler gibi meta veriler içerir) | Önbelleğe alınan model listesini güncellemek için `--refresh` bayrağını kullanın. Bu, bir sağlayıcıya yeni modeller eklendiğinde ve bunları opencode'da görmek istediğinizde kullanışlıdır. ```bash opencode models --refresh ``` --- ### run Doğrudan bir istem ileterek opencode'u etkileşimli olmayan modda çalıştırın. ```bash opencode run [message..] ``` Bu, komut dosyası oluşturma, otomasyon veya TUI'un tamamını başlatmadan hızlı bir yanıt istediğinizde kullanışlıdır. Örneğin. ```bash "opencode run" opencode run Explain the use of context in Go ``` Ayrıca, her çalıştırmada MCP sunucusunun soğuk önyükleme sürelerini önlemek için çalışan bir `opencode serve` örneğine de ekleyebilirsiniz: ```bash # Start a headless server in one terminal opencode serve # In another terminal, run commands that attach to it opencode run --attach http://localhost:4096 "Explain async/await in JavaScript" ``` #### Bayraklar | Bayrak | Kısa | Açıklama | | ---------------------------------------- | ---- | --------------------------------------------------------------------------------------------- | | {"--command"} | | Çalıştırılacak komut, args için mesajı kullanın | | {"--continue"} | `-c` | Son oturuma devam et | | {"--session"} | `-s` | Devam edecek oturum kimliği | | {"--fork"} | | Devam ederken oturumu fork'lar (`--continue` veya `--session` ile kullanın) | | {"--share"} | | Oturumu paylaşın | | {"--model"} | `-m` | provider/model biçiminde kullanılacak model | | {"--agent"} | | Kullanılacak temsilci | | {"--file"} | `-f` | Mesaja eklenecek dosya(lar) | | {"--format"} | | Biçim: varsayılan (biçimlendirilmiş) veya json (ham JSON olayları) | | {"--title"} | | Oturumun başlığı (değer sağlanmazsa kısaltılmış bilgi istemi kullanılır) | | {"--attach"} | | Çalışan bir opencode sunucusuna ekleyin (ör. http://localhost:4096) | | {"--password"} | `-p` | Temel kimlik doğrulama parolası (varsayılan: `OPENCODE_SERVER_PASSWORD`) | | {"--username"} | `-u` | Temel kimlik doğrulama kullanıcı adı (varsayılan: `OPENCODE_SERVER_USERNAME` veya `opencode`) | | {"--dir"} | | Çalıştırılacak dizin veya bağlanırken uzak sunucudaki yol | | {"--variant"} | | Model varyantı (sağlayıcıya özgü muhakeme düzeyi) | | {"--thinking"} | | Düşünme bloklarını göster | | {"--port"} | | Yerel sunucunun bağlantı noktası (varsayılan olarak rastgele bağlantı noktasıdır) | --- ### serve API erişimi için headless bir opencode sunucusu başlatır. Tam HTTP arayüzü için [server docs](/docs/server) sayfasına bakın. ```bash opencode serve ``` Bu, TUI arayüzü olmadan opencode işlevselliğine API erişimi sağlayan bir HTTP sunucusunu başlatır. HTTP temel kimlik doğrulamasını etkinleştirmek için `OPENCODE_SERVER_PASSWORD` öğesini ayarlayın (kullanıcı adı varsayılan olarak `opencode` şeklindedir). #### Bayraklar | Bayrak | Tanım | | ---------------------------------------- | ------------------------------------------ | | {"--port"} | Dinlenecek bağlantı noktası | | {"--hostname"} | Dinlenecek ana bilgisayar adı | | {"--mdns"} | mDNS bulmayı etkinleştir | | {"--cors"} | CORS'a izin verecek ek tarayıcı kaynakları | --- ### session opencode oturumlarını yönetin. ```bash opencode session [command] ``` --- #### list Tüm opencode oturumlarını listeleyin. ```bash opencode session list ``` ##### Bayraklar | Bayrak | Kısa | Tanım | | ----------------------------------------- | ---- | -------------------------------------- | | {"--max-count"} | `-n` | En son N oturumla sınırla | | {"--format"} | | Çıkış formatı: tablo veya json (tablo) | --- ### stats opencode oturumlarınız için belirteç kullanımı ve maliyet istatistiklerini gösterin. ```bash opencode stats ``` #### Bayraklar | Bayrak | Açıklama | | --------------------------------------- | ----------------------------------------------------------------------------------------------------------- | | {"--days"} | Son N güne ait istatistikleri göster (tüm zamanlar) | | {"--tools"} | Gösterilecek araç sayısı (tümü) | | {"--models"} | Model kullanım dökümünü göster (varsayılan olarak gizlidir). En üstteki N'yi göstermek için bir sayı iletin | | {"--project"} | Projeye göre filtrele (tüm projeler, boş değer: mevcut proje) | --- ### export Oturum verilerini JSON olarak dışa aktarın. ```bash opencode export [sessionID] ``` Bir oturum kimliği sağlamazsanız mevcut oturumlar arasından seçim yapmanız istenir. --- ### import Bir JSON dosyasından veya opencode paylaşımından URL oturum verilerini içe aktarın. ```bash opencode import ``` Yerel bir dosyadan veya opencode paylaşımından (URL) içe aktarabilirsiniz. ```bash opencode import session.json opencode import https://opncd.ai/s/abc123 ``` --- ### web Web arayüzüyle başsız bir opencode sunucusu başlatın. ```bash opencode web ``` Bu, bir HTTP sunucusunu başlatır ve bir web arayüzü aracılığıyla opencode'a erişmek için bir web tarayıcısı açar. HTTP temel kimlik doğrulamasını etkinleştirmek için `OPENCODE_SERVER_PASSWORD` öğesini ayarlayın (kullanıcı adı varsayılan olarak `opencode` şeklindedir). #### Bayraklar | Bayrak | Tanım | | ---------------------------------------- | ------------------------------------------ | | {"--port"} | Dinlenecek bağlantı noktası | | {"--hostname"} | Dinlenecek ana bilgisayar adı | | {"--mdns"} | mDNS bulmayı etkinleştir | | {"--cors"} | CORS'a izin verecek ek tarayıcı kaynakları | --- ### acp Bir ACP (Ajan İstemci Protokolü) sunucusu başlatın. ```bash opencode acp ``` Bu komut, nd-JSON kullanarak stdin/stdout aracılığıyla iletişim kuran bir ACP sunucusunu başlatır. #### Bayraklar | Bayrak | Açıklama | | ---------------------------------------- | ------------------- | | {"--cwd"} | Çalışma dizini | | {"--port"} | Dinlenecek port | | {"--hostname"} | Dinlenecek host adı | --- ### uninstall opencode'u kaldırın ve ilgili tüm dosyaları kaldırın. ```bash opencode uninstall ``` #### Bayraklar | Bayrak | Kısa | Tanım | | ------------------------------------------- | ---- | ----------------------------------------------- | | {"--keep-config"} | `-c` | Yapılandırma dosyalarını sakla | | {"--keep-data"} | `-d` | Oturum verilerini ve anlık görüntüleri saklayın | | {"--dry-run"} | | Nelerin kaldırılmadan kaldırılacağı göster | | {"--force"} | `-f` | Onay istemlerini atla | --- ### upgrade opencode'u en son sürüme veya belirli bir sürüme günceller. ```bash opencode upgrade [target] ``` En son sürüme yükseltmek için. ```bash opencode upgrade ``` Belirli bir sürüme yükseltmek için: ```bash opencode upgrade v0.1.48 ``` #### Bayraklar | Bayrak | Kısa | Açıklama | | -------------------------------------- | ---- | ------------------------------------------------------ | | {"--method"} | `-m` | Kullanılan kurulum yöntemi: curl, npm, pnpm, bun, brew | --- ## Global bayraklar opencode CLI aşağıdaki global bayrakları destekler. | Bayrak | Kısa | Tanım | | ------------------------------------------ | ---- | ---------------------------------------- | | {"--help"} | `-h` | Yardımı görüntüle | | {"--version"} | `-v` | Sürüm numarasını yazdır | | {"--print-logs"} | | Günlükleri stderr'e yazdır | | {"--log-level"} | | Günlük düzeyi (DEBUG, INFO, WARN, ERROR) | --- ## Ortam değişkenleri opencode ortam değişkenleri kullanılarak yapılandırılabilir. | Değişken | Tip | Açıklama | | ------------------------------------- | ------- | --------------------------------------------------------------------------- | | `OPENCODE_AUTO_SHARE` | boolean | Oturumları otomatik olarak paylaş | | `OPENCODE_GIT_BASH_PATH` | string | Windows'ta yürütülebilir Git Bash'in Yolu | | `OPENCODE_CONFIG` | string | Yapılandırma dosyasının yolu | | `OPENCODE_TUI_CONFIG` | string | TUI yapılandırma dosyasının yolu | | `OPENCODE_CONFIG_DIR` | string | Yapılandırma dizinine giden yol | | `OPENCODE_CONFIG_CONTENT` | string | Satır içi JSON config içeriği | | `OPENCODE_DISABLE_AUTOUPDATE` | boolean | Otomatik güncelleme kontrollerini devre dışı bırak | | `OPENCODE_DISABLE_PRUNE` | boolean | Eski verilerin temizlenmesini devre dışı bırak | | `OPENCODE_DISABLE_TERMINAL_TITLE` | boolean | Otomatik terminal başlığı güncellemelerini devre dışı bırakın | | `OPENCODE_PERMISSION` | string | Satır içi JSON izin config'i | | `OPENCODE_DISABLE_DEFAULT_PLUGINS` | boolean | Varsayılan eklentileri devre dışı bırakın | | `OPENCODE_DISABLE_LSP_DOWNLOAD` | boolean | Otomatik LSP sunucu indirmelerini devre dışı bırakın | | `OPENCODE_ENABLE_EXPERIMENTAL_MODELS` | boolean | Deneysel modelleri etkinleştir | | `OPENCODE_DISABLE_AUTOCOMPACT` | boolean | Otomatik context sıkıştırmayı devre dışı bırak | | `OPENCODE_DISABLE_CLAUDE_CODE` | boolean | `.claude`'den okumayı devre dışı bırak (istem + beceriler) | | `OPENCODE_DISABLE_CLAUDE_CODE_PROMPT` | boolean | `~/.claude/CLAUDE.md` dosyasını okumayı devre dışı bırak | | `OPENCODE_DISABLE_CLAUDE_CODE_SKILLS` | boolean | `.claude/skills` yüklemesini devre dışı bırak | | `OPENCODE_DISABLE_MODELS_FETCH` | boolean | Uzak kaynaklardan model getirmeyi devre dışı bırakın | | `OPENCODE_FAKE_VCS` | string | Test amaçlı sahte VCS sağlayıcısı | | `OPENCODE_CLIENT` | string | Client kimliği (varsayılan: `cli`) | | `OPENCODE_ENABLE_EXA` | boolean | Exa web arama araçlarını etkinleştir | | `OPENCODE_SERVER_PASSWORD` | string | `serve`/`web` için temel kimlik doğrulamayı etkinleştirin | | `OPENCODE_SERVER_USERNAME` | string | Temel kimlik doğrulama kullanıcı adını geçersiz kıl (varsayılan `opencode`) | | `OPENCODE_MODELS_URL` | string | Model yapılandırmasını almak için özel URL | --- ### Deneysel Bu ortam değişkenleri değişebilecek veya kaldırılabilecek deneysel özellikleri etkinleştirir. | Değişken | Tip | Tanım | | ----------------------------------------------- | ------- | ------------------------------------------------------- | | `OPENCODE_EXPERIMENTAL` | boolean | Tüm deneysel özellikleri etkinleştir | | `OPENCODE_EXPERIMENTAL_ICON_DISCOVERY` | boolean | Simge bulmayı etkinleştir | | `OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT` | boolean | TUI'da seçim yapıldığında kopyalamayı devre dışı bırak | | `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | number | MS cinsinden bash komutları için varsayılan zaman aşımı | | `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` | number | LLM yanıtları için maksimum çıktı belirteçleri | | `OPENCODE_EXPERIMENTAL_FILEWATCHER` | boolean | Tüm dizin için dosya izleyiciyi etkinleştir | | `OPENCODE_EXPERIMENTAL_OXFMT` | boolean | Oxfmt biçimlendiriciyi etkinleştir | | `OPENCODE_EXPERIMENTAL_LSP_TOOL` | boolean | Deneysel LSP aracını etkinleştir | | `OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER` | boolean | Dosya izleyiciyi devre dışı bırak | | `OPENCODE_EXPERIMENTAL_EXA` | boolean | Deneysel Exa özelliklerini etkinleştirin | | `OPENCODE_EXPERIMENTAL_LSP_TY` | boolean | python dosyaları için TY LSP'yi etkinleştir | | `OPENCODE_EXPERIMENTAL_PLAN_MODE` | boolean | Plan modunu etkinleştir |