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 coderoutercr login เปิดเบราว์เซอร์และพิมพ์ลิงก์สำรอง หากไม่มีเบราว์เซอร์ในเครื่อง ให้ใช้ --device-auth แล้วเปิดลิงก์บนอุปกรณ์อื่น หรือใช้ cr login --code เพื่อวางรหัสหรือ magic link
cr login
cr login --device-auth
cr login --code [code-or-url]
cr logoutcr
เมื่อไม่ระบุคำสั่ง 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 upgradeworkspace ของ 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