# CLI และการแก้ปัญหาของ CodeRouter

CodeRouter มีคำสั่งสองชุด cr ซึ่งติดตั้งเป็น coderouter ด้วย ใช้ลงชื่อเข้าใช้ จัดการการสมัครใช้งาน และเปิดเอเจนต์ cmux coderouter จัดการบัญชี Claude ของทีมและการใช้งานเครื่อง Cloud ผ่านแอป cmux ที่ลงชื่อเข้าใช้แล้ว และส่ง verb อื่นทั้งหมดต่อให้ cr

## ติดตั้งและลงชื่อเข้าใช้

ตัวติดตั้งดาวน์โหลดไบนารีที่ตรวจสอบ checksum แล้วไปที่ ~/.coderouter/bin ลิงก์ cr ไปยังไบนารีนั้น และเพิ่มไดเรกทอรีนั้นใน PATH ของ shell รันอีกครั้งเพื่ออัปเดต รองรับ macOS และ Linux บน arm64 และ x64 CLI ตัวเดียวกันเผยแพร่บน npm และ PyPI

```
curl -fsSL https://cmux.com/coderouter/install.sh | sh
npm install -g coderouter
uv tool install coderouter
```

cr login เปิดเบราว์เซอร์และพิมพ์ลิงก์สำรอง หากไม่มีเบราว์เซอร์ในเครื่อง ให้ใช้ --device-auth แล้วเปิดลิงก์บนอุปกรณ์อื่น หรือใช้ cr login --code เพื่อวางรหัสหรือ magic link

```
cr login
cr login --device-auth
cr login --code [code-or-url]
cr logout
```

## cr

เมื่อไม่ระบุคำสั่ง cr จะแสดงบัญชีของคุณและการใช้งาน การกำหนดเส้นทางเอเจนต์ต้องระบุชัดเจนเสมอ codex, opencode และ pi แบบปกติยังทำงานได้โดยไม่ต้องใช้ 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 <name>] [--stdin]
cr add opencode
cr remove [account] [--yes]
cr transfer [account] [--to <team>] [--yes]
cr accounts [--watch] [--json] # aliases: list, ls, usage
cr org current | list | switch <name-or-id>
cr login [--api-key <key>] [--device-auth] [--code [code-or-url]]
cr logout
cr doctor
cr upgrade
```

workspace ของ ChatGPT แบบส่วนตัวและแบบทีมใช้อีเมลเดียวกันได้ รัน cr add codex หนึ่งครั้งต่อหนึ่ง workspace แล้วเลือก workspace ในเบราว์เซอร์ CodeRouter จะเก็บไว้เป็นบัญชีแยกกัน

## cmux coderouter

verb เหล่านี้ทำงานผ่านแอป cmux ซึ่งต้องเปิดอยู่และลงชื่อเข้าใช้แล้ว (cmux auth login) เพิ่ม --json เพื่อรับผลลัพธ์ที่เครื่องอ่านได้ และ --team <id> เพื่อระบุทีมอื่นที่ไม่ใช่ทีมที่เลือกอยู่

```
cmux coderouter status
cmux coderouter machines
cmux coderouter claude list
cmux coderouter claude add oauth-token [--label <name>] [--stdin]
cmux coderouter claude add api-key [--label <name>] [--stdin]
cmux coderouter claude add bedrock [--label <name>] [--region <region>] [--model <claude-id>=<bedrock-id>]...
cmux coderouter claude disable <account>
cmux coderouter claude enable <account>
cmux coderouter claude remove <account>
cmux coderouter claude clear
cmux coderouter agent <claude|codex|opencode|pi> [vm-agent-options] -- <prompt>
```

claude add oauth-token อ่าน CLAUDE\_CODE\_OAUTH\_TOKEN หรือ --stdin ในเทอร์มินัลที่ไม่มีทั้งสองอย่าง จะรัน claude setup-token แล้วอ่านโทเค็นที่คำสั่งนั้นพิมพ์ออกมา claude add api-key อ่าน ANTHROPIC\_API\_KEY, --stdin หรือพรอมต์ที่ซ่อนข้อความ claude add bedrock อ่าน AWS\_ACCESS\_KEY\_ID, AWS\_SECRET\_ACCESS\_KEY และ AWS\_SESSION\_TOKEN (ไม่บังคับ) และใช้ภูมิภาคจาก --region, AWS\_REGION หรือ AWS\_DEFAULT\_REGION

<account> เป็น ID ป้ายชื่อ หรือตัวระบุที่ปิดบังไว้ของบัญชีก็ได้ disable นำบัญชีออกจากการหมุนเวียนจนกว่าคุณจะเปิดใช้งานอีกครั้ง

verb อื่นทั้งหมดของ cmux coderouter และทุกคำสั่ง cmux cr จะรัน cr โดยไม่เปลี่ยนแปลง เมื่อไม่มี cr ติดตั้งอยู่ cmux จะเสนอให้รันตัวติดตั้ง cmux ไม่ส่งตัวแปรสภาพแวดล้อมหรือการลงชื่อเข้าใช้ของตัวเองให้ cr

```
cmux cr accounts
cmux coderouter login
```

## ภายในเครื่อง Cloud

เครื่อง Cloud แต่ละเครื่องมี cmux ของตัวเองพร้อม verb ของ CodeRouter ที่ไม่ต้องลงชื่อเข้าใช้ การจัดการบัญชียังอยู่บน Mac ของคุณ จึงปฏิเสธ claude, login และ logout ภายในเครื่อง

```
cmux auth status [--json]
cmux coderouter status [--json]
cmux coderouter usage [--json|--tsv] [--days <n>]
cmux coderouter models
cmux coderouter accounts [--json]
cmux coderouter org current [--json]
cmux coderouter agent <claude|codex|opencode|pi> [--timeout <seconds>] [args...]
cr use [own|team|auto] [claude|codex|opencode] [--json]   # your own sign-in or the team's accounts
```

## การแก้ปัญหา

ข้อความในคอลัมน์แรกคือสิ่งที่เอเจนต์ cr หรือ cmux พิมพ์ออกมา

| ข้อความหรือปัญหา | วิธีแก้ |
| --- | --- |
| Sign in with \`cr login\` and retry. (นอกจากนี้: Missing coderouter route token.) | รัน cr login สำหรับไคลเอนต์ API ให้ตรวจสอบว่าตั้งค่าคีย์แล้วและขึ้นต้นด้วย crk\_ |
| Your coderouter session expired or was revoked. | รัน cr login อีกครั้ง API key ที่ถูกเพิกถอนจะหยุดทำงานทันที ให้สร้างคีย์ใหม่ |
| No healthy Codex subscription is currently available. | รัน cr เพื่อดูสถานะของแต่ละบัญชี เพิ่มบัญชีด้วย cr add หรือรอให้ช่วงพักการใช้งานสิ้นสุด สำหรับเครื่อง Cloud ขององค์กร ให้แชร์บัญชีกับทีม |
| No Claude upstream account is configured for this team. | เพิ่มบัญชีด้วย cr add claude หรือ cmux coderouter claude add สำหรับเครื่อง Cloud ขององค์กร ให้แชร์บัญชีนั้นกับทีม |
| Every Claude upstream account of this team is cooling down or disabled. | ลองอีกครั้งหลังช่วงพักการใช้งาน เปิดใช้งานบัญชีที่ปิดอยู่ด้วย cmux coderouter claude enable หรือเพิ่มบัญชีอื่น |
| not\_found\_error จากบัญชี Bedrock | โมเดลไม่มีการแมปของ Bedrock ให้ลบบัญชีแล้วเพิ่มใหม่ด้วย --model <claude-id>=<bedrock-id> |
| The team's Bedrock account is missing a region. | ลบบัญชีแล้วเพิ่มใหม่ด้วย --region หรือโดยตั้งค่า AWS\_REGION ไว้ |
| CodeRouter CLI is not installed. | รันตัวติดตั้ง หรือตอบ y เมื่อ cmux cr เสนอให้ติดตั้ง |
| Codex is not installed or is not on PATH (หรือ OpenCode หรือ Pi). | ติดตั้งเอเจนต์ cr จะเปิดสำเนาที่พบใน PATH ของคุณ |
| \`codex\` resolves back to coderouter. | คำสั่ง codex ของคุณชี้ไปที่ cr ให้วางไฟล์ปฏิบัติการ Codex จริงไว้ลำดับแรกใน PATH |
| \`<model>\` is not a coderouter OpenCode model. | เลือกโมเดลจากบัญชี OpenCode Go ของคุณ หรือรัน opencode แบบปกติสำหรับผู้ให้บริการอื่น |
| cmux: OpenCode provider configuration is unavailable; retry in one minute. | เครื่องดาวน์โหลดรายการผู้ให้บริการของ OpenCode ไม่ได้ รอหนึ่งนาทีแล้วเริ่ม OpenCode อีกครั้ง |
| CodeRouter: TLS edge unreachable หรือ route rejected ใน cmux auth status ภายในเครื่อง | เครื่องเข้าถึง CodeRouter ไม่ได้ หรือ CodeRouter ปฏิเสธข้อมูลรับรองของเครื่อง ลองอีกครั้งในอีกสักครู่ หากยังเกิดขึ้นอยู่ ให้ติดต่อฝ่ายสนับสนุนพร้อมชื่อเครื่องและเอาต์พุตของ cmux auth status --json |
| coderouter is temporarily unavailable. Retry shortly. | CodeRouter หรือที่เก็บบัญชีใช้งานไม่ได้ชั่วครู่ ลองอีกครั้ง หากข้อผิดพลาดยังอยู่ ให้รายงานพร้อม ID ของคำขอ |

## วินิจฉัย

cr doctor พิมพ์ว่า cr ลงชื่อเข้าใช้แล้วหรือไม่ และใช้ endpoint ใดของ CodeRouter cmux coderouter status แสดงการลงชื่อเข้าใช้ cmux ทีมที่เลือก และบัญชี Claude ของทีมนั้น

```
cr doctor
cmux coderouter status
```

## ขอความช่วยเหลือ

เมื่อรายงานคำขอที่ล้มเหลว ให้แนบค่าของเฮดเดอร์การตอบกลับ x-coderouter-request-id ค่านี้ระบุคำขอนั้นในบันทึกของ CodeRouter

Canonical: https://cmux.com/th/docs/coderouter/cli

Documentation index: https://cmux.com/llms.txt