wip(docs): i18n (#12681)

This commit is contained in:
Adam
2026-02-09 11:34:35 -06:00
committed by GitHub
parent f74c0339cc
commit dc53086c1e
642 changed files with 192745 additions and 509 deletions

View File

@@ -0,0 +1,601 @@
---
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 terminali kullanıcı arayüzünü başlatın.
```bash
opencode [project]
```
#### Flags
| Bayrak | Kısa | Açıklama |
| ------------ | ---- | ------------------------------------------- |
| `--continue` | `-c` | Son oturuma devam et |
| `--session` | `-s` | Devam edecek oturum kimliği |
| `--prompt` | | Kullanma istemi |
| `--model` | `-m` | provider/model biçiminde kullanılacak model |
| `--agent` | | Kullanılacak temsilci |
| `--port` | | Port to listen on |
| `--hostname` | | Hostname to listen on |
---
## Komutlar
OpenCode CLI ayrıca aşağıdaki komutlara da sahiptir.
---
### agent
OpenCode için aracı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 |
| `--session` | `-s` | Devam edecek oturum açma bilgileri |
---
#### yaratmak
Özel yapılandırmaya sahip yeni bir aracı oluşturun.
```bash
opencode agent create
```
Bu komut, özel sistem istemi ve araç yapılandırmasıyla yeni bir aracı oluşturma konusunda size yol gösterecektir.
---
#### liste
Mevcut tüm acenteleri 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. Ortamlarınızda tanımlanmış herhangi bir anahtar veya projenizde bir `.env` dosyası varsa.
---
#### liste
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]
```
---
#### düzenlemek
GitHub aracısını deponuza yükleyin.
```bash
opencode github install
```
Bu, gerekli GitHub Eylemlerinin iş ayrıntılandırma ayarlarını ve süreç sürecini boyut boyunca gösterir. [Learn more](/docs/github).
---
#### koşmak
GitHub aracısını çalıştırın. Bu genellikle GitHub Eylemlerinde kullanılır.
```bash
opencode github run
```
##### Flags
| 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.
---
#### liste
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]
```
---
#### hata ayıklama
MCP sunucusu için OAuth bağlantı sorunlarının hatalarını ayıklayın.
```bash
opencode mcp debug <name>
```
---
### models
Yapılandırılmış sağlayıcıların tüm mevcut modellerini listeleyin.
```bash
opencode models [provider]
```
Bu komut, sağlayıcılarınızda bulunan tüm modeller `provider/model` oluşturulan görüntüler.
Bu, [your config](/docs/config/)'da kullanılacak tam modelin 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
```
---
### koşmak
Doğrudan bir istem ileterek açık kodu 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"
```
#### Flags
| 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 |
| `--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 açık kod sunucusuna ekleyin (ör. http://localhost:4096) |
| `--port` | | Yerel sunucunun bağlantı noktası (varsayılan olarak rastgele bağlantı noktasıdır) |
---
### serve
API erişimi için başsız bir OpenCode tarayıcısı başlatılır. Tam HTTP arayüzü için [server docs](/docs/server)'e göz atın.
```bash
opencode serve
```
Bu, TUI arayüzü olmadan açık kod 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ı |
---
### oturum
Manage OpenCode sessions.
```bash
opencode session [command]
```
---
#### liste
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
```
#### Flags
| Bayrak | Açıklama |
| ----------- | ----------------------------------------------------------------------------------------------------------- |
| `--days` | Son N güne ait istatistikleri göster (tüm zamanlar) |
| `--tools` | Number of tools to show (all) |
| `--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` | Filter by project (all projects, empty string: current project) |
---
### 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 <file>
```
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.
#### Flags
| Bayrak | Açıklama |
| ------------ | --------------------- |
| `--cwd` | Çalışma dizini |
| `--port` | Port to listen on |
| `--hostname` | Hostname to listen on |
---
### 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
ık kodu 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
```
To upgrade to a specific version.
```bash
opencode upgrade v0.1.48
```
#### Flags
| Bayrak | Kısa | Açıklama |
| ---------- | ---- | ----------------------------------------------------------- |
| `--method` | `-m` | Kullanılan kurulum yöntemi; bukle, npm, npm, topuz, demleme |
---
## Küresel Bayraklar
CLI açık kodu aşağıdaki genel bayrakları alır.
| 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) |
---
## Environment variables
OpenCode ortam değişkenleri kullanılarak yapılandırılabilir.
| Değişken | Tür | Açıklama |
| ------------------------------------- | ------- | --------------------------------------------------------------------------- |
| `OPENCODE_AUTO_SHARE` | boole | Oturumları otomatik olarak paylaş |
| `OPENCODE_GIT_BASH_PATH` | dize | Windows'ta yürütülebilir Git Bash'in Yolu |
| `OPENCODE_CONFIG` | dize | Yapılandırma dosyasının yolu |
| `OPENCODE_CONFIG_DIR` | dize | Yapılandırma dizinine giden yol |
| `OPENCODE_CONFIG_CONTENT` | string | Inline json config content |
| `OPENCODE_DISABLE_AUTOUPDATE` | boolean | Disable automatic update checks |
| `OPENCODE_DISABLE_PRUNE` | boolean | Disable pruning of old data |
| `OPENCODE_DISABLE_TERMINAL_TITLE` | boole | Otomatik terminal başlığı güncellemelerini devre dışı bırakın |
| `OPENCODE_PERMISSION` | string | Inlined json permissions config |
| `OPENCODE_DISABLE_DEFAULT_PLUGINS` | boole | Varsayılan eklentileri devre dışı bırakın |
| `OPENCODE_DISABLE_LSP_DOWNLOAD` | boole | Otomatik LSP sunucu indirmelerini devre dışı bırakın |
| `OPENCODE_ENABLE_EXPERIMENTAL_MODELS` | boolean | Enable experimental models |
| `OPENCODE_DISABLE_AUTOCOMPACT` | boolean | Disable automatic context compaction |
| `OPENCODE_DISABLE_CLAUDE_CODE` | boole | `.claude`'den okumayı devre dışı bırak (istem + beceriler) |
| `OPENCODE_DISABLE_CLAUDE_CODE_PROMPT` | boolean | Disable reading `~/.claude/CLAUDE.md` |
| `OPENCODE_DISABLE_CLAUDE_CODE_SKILLS` | boolean | Disable loading `.claude/skills` |
| `OPENCODE_DISABLE_MODELS_FETCH` | boole | Uzak kaynaklardan model getirmeyi devre dışı bırakın |
| `OPENCODE_FAKE_VCS` | dize | Test amaçlı sahte VCS sağlayıcısı |
| `OPENCODE_DISABLE_FILETIME_CHECK` | boole | Optimizasyon için dosya süresi kontrolünü devre dışı bırakın |
| `OPENCODE_CLIENT` | string | Client identifier (defaults to `cli`) |
| `OPENCODE_ENABLE_EXA` | boolean | Enable Exa web search tools |
| `OPENCODE_SERVER_PASSWORD` | dize | `serve`/`web` için temel kimlik doğrulamayı etkinleştirin |
| `OPENCODE_SERVER_USERNAME` | dize | Temel kimlik doğrulama kullanıcı adını geçersiz kıl (varsayılan `opencode`) |
| `OPENCODE_MODELS_URL` | dize | 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` | sayı | MS cinsinden bash komutları için varsayılan zaman aşımı |
| `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` | sayı | 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 | Deneysel LSP tür denetimini etkinleştir |
| `OPENCODE_EXPERIMENTAL_MARKDOWN` | boolean | Deneysel işaretleme özelliklerini etkinleştir |
| `OPENCODE_EXPERIMENTAL_PLAN_MODE` | boolean | Plan modunu etkinleştir |