# CLI CodeRouter i rozwiązywanie problemów CodeRouter ma dwa zestawy poleceń. cr, instalowane też jako coderouter, loguje Cię, zarządza subskrypcjami i uruchamia agentów. cmux coderouter zarządza kontami Claude zespołu i zużyciem maszyn Cloud przez zalogowaną aplikację cmux, a każde inne polecenie przekazuje do cr. ## Instalacja i logowanie Instalator pobiera plik binarny zweryfikowany sumą kontrolną do ~/.coderouter/bin, tworzy do niego dowiązanie cr i dodaje ten katalog do PATH powłoki. Uruchom go ponownie, aby zaktualizować. Obsługuje macOS i Linux na arm64 i x64. To samo CLI jest opublikowane w npm i PyPI. ``` curl -fsSL https://cmux.com/coderouter/install.sh | sh npm install -g coderouter uv tool install coderouter ``` cr login otwiera przeglądarkę i wypisuje link zapasowy. Bez lokalnej przeglądarki użyj --device-auth i otwórz link na innym urządzeniu albo cr login --code, aby wkleić kod lub magiczny link. ``` cr login cr login --device-auth cr login --code [code-or-url] cr logout ``` ## cr Bez polecenia cr pokazuje Twoje konta i ich zużycie. Kierowanie agentów przez CodeRouter jest zawsze jawne: zwykłe codex, opencode i pi działają dalej bez CodeRouter. ``` cr # account and usage summary cr codex [arguments...] cr opencode [arguments...] cr pi [arguments...] # experimental cr naked [arguments...] # plain Codex, CodeRouter bypassed (alias: direct) cr add # choose a provider cr add codex cr add claude [--label ] [--stdin] cr add opencode cr remove [account] [--yes] cr transfer [account] [--to ] [--yes] cr accounts [--watch] [--json] # aliases: list, ls, usage cr org current | list | switch cr login [--api-key ] [--device-auth] [--code [code-or-url]] cr logout cr doctor cr upgrade ``` Osobisty i zespołowy obszar roboczy ChatGPT mogą mieć ten sam adres e-mail. Uruchom cr add codex raz dla każdego obszaru roboczego i wybierz obszar w przeglądarce; CodeRouter traktuje je jako osobne konta. ## cmux coderouter Te polecenia działają przez aplikację cmux, która musi być uruchomiona i zalogowana (cmux auth login). Dodaj --json, aby uzyskać wynik czytelny dla maszyn, i --team , aby wskazać zespół inny niż wybrany. ``` cmux coderouter status cmux coderouter machines cmux coderouter claude list cmux coderouter claude add oauth-token [--label ] [--stdin] cmux coderouter claude add api-key [--label ] [--stdin] cmux coderouter claude add bedrock [--label ] [--region ] [--model =]... cmux coderouter claude disable cmux coderouter claude enable cmux coderouter claude remove cmux coderouter claude clear cmux coderouter agent [vm-agent-options] -- ``` claude add oauth-token odczytuje CLAUDE\_CODE\_OAUTH\_TOKEN lub --stdin. W terminalu bez żadnego z nich uruchamia claude setup-token i odczytuje token wypisany przez to polecenie. claude add api-key odczytuje ANTHROPIC\_API\_KEY, --stdin lub ukryty monit. claude add bedrock odczytuje AWS\_ACCESS\_KEY\_ID, AWS\_SECRET\_ACCESS\_KEY i opcjonalny AWS\_SESSION\_TOKEN, a region bierze z --region, AWS\_REGION lub AWS\_DEFAULT\_REGION. może być identyfikatorem konta, jego etykietą lub zamaskowanym identyfikatorem. disable wyłącza konto z rotacji, dopóki nie włączysz go ponownie. Każde inne polecenie cmux coderouter i każde polecenie cmux cr uruchamia cr bez zmian. Gdy brakuje cr, cmux proponuje uruchomienie instalatora. cmux nie przekazuje do cr własnych zmiennych środowiskowych ani logowania. ``` cmux cr accounts cmux coderouter login ``` ## Na maszynie Cloud Każda maszyna Cloud ma własny cmux z poleceniami CodeRouter, które nie wymagają logowania. Zarządzanie kontami odbywa się na Twoim Macu, więc claude, login i logout są odrzucane na maszynie. ``` cmux auth status [--json] cmux coderouter status [--json] cmux coderouter usage [--json|--tsv] [--days ] cmux coderouter models cmux coderouter accounts [--json] cmux coderouter org current [--json] cmux coderouter agent [--timeout ] [args...] cr use [own|team|auto] [claude|codex|opencode] [--json] # your own sign-in or the team's accounts ``` ## Rozwiązywanie problemów Komunikaty w pierwszej kolumnie to tekst wypisywany przez agenta, cr lub cmux. | Komunikat lub objaw | Rozwiązanie | | --- | --- | | Sign in with \`cr login\` and retry. (Również: Missing coderouter route token.) | Uruchom cr login. W przypadku klienta API sprawdź, czy klucz jest ustawiony i zaczyna się od crk\_. | | Your coderouter session expired or was revoked. | Uruchom ponownie cr login. Unieważniony klucz API przestaje działać natychmiast; utwórz nowy. | | No healthy Codex subscription is currently available. | Uruchom cr, aby zobaczyć stan każdego konta. Dodaj konto przez cr add lub poczekaj na koniec okresu wstrzymania. Dla maszyn Cloud organizacji udostępnij konto zespołowi. | | No Claude upstream account is configured for this team. | Dodaj konto przez cr add claude lub cmux coderouter claude add. Dla maszyn Cloud organizacji udostępnij je zespołowi. | | Every Claude upstream account of this team is cooling down or disabled. | Spróbuj ponownie po okresie wstrzymania, włącz wyłączone konto przez cmux coderouter claude enable lub dodaj inne konto. | | not\_found\_error z konta Bedrock | Model nie ma mapowania Bedrock. Usuń konto i dodaj je ponownie z --model =. | | The team's Bedrock account is missing a region. | Usuń konto i dodaj je ponownie z --region lub z ustawionym AWS\_REGION. | | CodeRouter CLI is not installed. | Uruchom instalator lub odpowiedz y, gdy cmux cr zaproponuje instalację. | | Codex is not installed or is not on PATH (lub OpenCode, lub Pi). | Zainstaluj agenta. cr uruchamia kopię, którą znajdzie w PATH. | | \`codex\` resolves back to coderouter. | Twoje polecenie codex wskazuje na cr. Umieść prawdziwy plik wykonywalny Codex na początku PATH. | | \`\` is not a coderouter OpenCode model. | Wybierz model z kont OpenCode Go lub uruchom zwykłe opencode dla innego dostawcy. | | cmux: OpenCode provider configuration is unavailable; retry in one minute. | Maszyna nie mogła pobrać listy dostawców OpenCode. Poczekaj minutę i uruchom OpenCode ponownie. | | CodeRouter: TLS edge unreachable, lub route rejected, w cmux auth status na maszynie. | Maszyna nie może połączyć się z CodeRouter lub CodeRouter odrzucił dane uwierzytelniające maszyny. Spróbuj ponownie za chwilę. Jeśli problem nie ustępuje, skontaktuj się z pomocą techniczną, podając nazwę maszyny i wynik cmux auth status --json. | | coderouter is temporarily unavailable. Retry shortly. | CodeRouter lub magazyn kont jest chwilowo niedostępny. Spróbuj ponownie; jeśli błąd się powtarza, zgłoś go z identyfikatorem żądania. | ## Diagnostyka cr doctor pokazuje, czy cr jest zalogowane i których punktów końcowych CodeRouter używa. cmux coderouter status pokazuje logowanie cmux, wybrany zespół i konta Claude tego zespołu. ``` cr doctor cmux coderouter status ``` ## Pomoc Zgłaszając nieudane żądanie, podaj wartość nagłówka odpowiedzi x-coderouter-request-id. Identyfikuje ona to jedno żądanie w zapisach CodeRouter. Canonical: https://cmux.com/pl/docs/coderouter/cli Documentation index: https://cmux.com/llms.txt