> ## Documentation Index
> Fetch the complete documentation index at: https://docs.triw.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex CLI

> Instal Codex CLI dan daftarkan Triw sebagai provider di config.toml.

Codex adalah agent terminal dari OpenAI. Provider kustom dideklarasikan di `~/.codex/config.toml`, jadi Triw cukup satu blok provider berisi base URL dan env key.

## Kebutuhan sistem

| Item | Minimum |
| - | - |
| OS | macOS 13+, Linux, Windows (native atau WSL) |
| Node | 20+ untuk instalasi via npm |
| Jaringan | HTTPS keluar ke `router.triw.io` |

## Instalasi

```bash npm theme={null}
npm install -g @openai/codex
```

```bash Homebrew (macOS) theme={null}
brew install --cask codex
```

```bash theme={null}
codex --version
```

## Konfigurasi Triw

```toml ~/.codex/config.toml theme={null}
model = "claude-sonnet-4-5"
model_provider = "triw"

[model_providers.triw]
name = "Triw"
base_url = "https://router.triw.io/v1"
env_key = "TRIW_API_KEY"
```

```bash theme={null}
export TRIW_API_KEY="sk-..."
```

Dua hal yang menentukan:

* `base_url` berakhiran `/v1`. Codex menambahkan `/chat/completions` atau `/responses`.
* `env_key` hanya menyebut nama variabel; key tidak disimpan di file.

Bila hanya ingin mengalihkan provider OpenAI bawaan, Codex juga menerima `openai_base_url = "https://router.triw.io/v1"` di level atas. Blok provider eksplisit lebih jelas bila Anda menyimpan dua provider.

## Memilih model

```bash theme={null}
curl https://router.triw.io/v1/models -H "Authorization: Bearer $TRIW_API_KEY"
```

Gunakan id persis pada `model =`. Id untuk coding umumnya dari keluarga `gpt-5*`, `codex`, atau `claude-*`, tergantung channel yang dipasang operator.

## Verifikasi

```bash theme={null}
codex exec "balas dengan satu kata: ready"
```

Mode interaktif: jalankan `codex`, lalu `/status` untuk memastikan provider dan model. Cocokkan dengan **Logs** di console Triw.

## Troubleshooting

| Gejala | Penyebab | Perbaikan |
| - | - | - |
| `401` di semua panggilan | `TRIW_API_KEY` tidak ada di shell tempat Codex jalan | Export variabelnya, atau arahkan `env_key` ke variabel yang benar |
| `404` di semua panggilan | `base_url` tanpa `/v1` atau menyertakan path | Pakai `https://router.triw.io/v1` |
| Provider salah dipakai | `model_provider` masih `openai` | Set ke `triw` |
| Tool call ditolak | Model tidak mendukung function calling | Ganti ke model coding |
| Error `wire_api` | Sebagian build meminta protokol eksplisit | Tambahkan `wire_api = "chat"` di blok provider |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.