ការណែនាំដំឡើង

ដំឡើង និងភ្ជាប់ Claude Code

កំណត់ Claude Code ឱ្យភ្ជាប់ទៅ Gateway តែម្តងតាមរយៈ Claude settings file ដើម្បីឱ្យគ្រប់ Session ភ្ជាប់ដោយស្វ័យប្រវត្តិ ឬប្រើ Scoped launcher នៅពេលអ្នកចង់គ្រប់គ្រងតាមការដំណើរការនីមួយៗ។

មុនពេលចាប់ផ្តើម

ដំឡើង Node.js 22 ឬថ្មីជាងនេះ ហើយត្រៀម hashn0de API Key របស់អ្នក។ ជំហានបន្ទាប់នឹងដំឡើង Claude Code។

ANTHROPIC_BASE_URL
https://api.hashn0de.com

ប្រើ Gateway origin នេះ។ Client ទាំងនេះនឹងបន្ថែម /v1/messages និង Path ពាក់ព័ន្ធផ្សេងៗដោយខ្លួនឯង។

ANTHROPIC_AUTH_TOKEN
$HASHN0DE_API_KEY

ប្រើ hashn0de API Key ដែលបានផ្តល់ជូនអ្នក។

ម៉ូដែលចាប់ផ្តើម
claude-opus-5

ការកំណត់លំនាំដើម Opus សម្រាប់ការសរសេរកូដ ការស្រាវជ្រាវ និងការងារ Agent។

Claude Code ក៏ដំណើរការនៅក្នុង VS Code និង Cursor ផងដែរ — ដំឡើង Claude Code extension រួចអនុវត្តការកំណត់ Gateway ដូចខាងក្រោម។

១. ដំឡើង Claude Code

ដំឡើង Claude Code package ផ្លូវការតែម្តងគត់៖

bash
npm install -g @anthropic-ai/claude-code@latest

២. ភ្ជាប់តាមរយៈ settings.json

បន្ថែម Gateway env block ទៅក្នុង Claude settings file កម្រិត User របស់អ្នកតែម្តង។ Claude Code អានវានៅពេលចាប់ផ្តើមសម្រាប់គ្រប់ Session ដូច្នេះ claude ធម្មតាភ្ជាប់តាម Gateway។ Root Gateway URL គឺមិនមាន /v1 នៅពីក្រោយទេ។

  1. 1
    បង្កើត និងបើក Claude settings file របស់អ្នក៖ ដំណើរការ
  2. 2
    Paste Block ខាងក្រោម រួចជំនួស ដោយ hashn0de Key ពិតរបស់អ្នក និង ដោយម៉ូដែលដែលអ្នកចង់ចាប់ផ្តើមជាមួយ។
  3. 3
    រក្សាទុក File ចាប់ផ្តើម Terminal ឡើងវិញ រួចដំណើរការ ពី Project folder ណាមួយ។
json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.hashn0de.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxx",
    "ANTHROPIC_MODEL": "claude-opus-5"
  }
}
env block នេះដំណើរការសម្រាប់គ្រប់ Claude Code session នៅលើម៉ាស៊ីននេះ ហើយ Override អថេរដែល Export ពី Shell។ សូមលុបវាចេញពី settings.json នៅពេលអ្នកចង់ឱ្យការកំណត់តាម Shell ដំណើរការជំនួសវិញ។
ការកំណត់នេះចាប់ផ្តើមជាមួយម៉ូដែលជាក់លាក់តែមួយ ហើយមិនបើក gateway model discovery ដើម្បីឱ្យ /model picker ស្អាត និងខ្លី។ ប្រើ GET /v1/models ដាច់ដោយឡែក ប្រសិនបើអ្នកត្រូវការបញ្ជីម៉ូដែលពេញលេញ។

រំលងការសួរសិទ្ធិ

claude ធម្មតានៅតែសួរមុនពេលដំណើរការ file និង shell actions។ បន្ថែម permissions block នេះទៅក្នុង settings.json File ដូចគ្នា — វាអាចនៅជាមួយ env block បាន — ឬប្រើ Scoped launcher ខាងក្រោម ដែលប្រើ --dangerously-skip-permissions រួចហើយ។

json
{
  "permissions": {
    "defaultMode": "bypassPermissions",
    "skipDangerousModePermissionPrompt": true
  }
}
Bypass mode អនុញ្ញាតឱ្យ Claude Code ដំណើរការ file និង shell actions ដោយមិនសួរជាមុន។ ប្រើតែជាមួយ project និងម៉ាស៊ីនដែលអ្នកទុកចិត្តប៉ុណ្ណោះ។

ជម្រើសផ្សេង៖ Scoped launcher

ចង់បានការកំណត់ Gateway ដែលដំណើរការតែក្នុងការបើកម្តងប៉ុណ្ណោះមែនទេ? Export Key របស់អ្នក Paste function claude-hashn0de រួចបើកតាមរយៈវា។ Root Gateway URL គឺមិនមាន /v1 នៅពីក្រោយទេ។

  1. 1
    Export Key របស់អ្នកទៅក្នុងអថេរ HASHN0DE_API_KEY។
  2. 2
    បិទភ្ជាប់ (Paste) Scoped function claude-hashn0de ទៅក្នុង Terminal របស់អ្នក។
  3. 3
    ដំណើរការ claude-hashn0de ពី Project folder ដែលអ្នកចង់ឱ្យ Claude Code ប្រើប្រាស់។
bash
export HASHN0DE_API_KEY="sk-xxxxxxxxxxxx"

claude-hashn0de() {
  ANTHROPIC_BASE_URL="https://api.hashn0de.com" \
  ANTHROPIC_AUTH_TOKEN="${HASHN0DE_API_KEY:?Set HASHN0DE_API_KEY first}" \
  ANTHROPIC_MODEL="claude-opus-5" \
  claude --dangerously-skip-permissions "$@"
}

claude-hashn0de
Launcher កំណត់អថេរទាំងបីនេះតែក្នុងអំឡុងពេលដំណើរការប៉ុណ្ណោះ — នៅពេល claude បញ្ចប់ Terminal session របស់អ្នកនៅតែរក្សា Configuration ដើមរបស់វា។
តម្លៃ env ក្នុង settings.json Override អថេររបស់ Launcher។ សូមលុប env block ចេញពី settings.json មុនពេលប្រើ Launcher ជាមួយ Gateway ឬម៉ូដែលផ្សេង។

កំណត់ជាអចិន្ត្រៃយ៍

រក្សាទុក Launcher ទៅក្នុង shell profile របស់អ្នកម្តង ដើម្បីឱ្យ Terminal ថ្មីៗគ្រប់ពេលអាចដំណើរការ claude-hashn0de ដោយមិនចាំបាច់រៀបចំអ្វីទៀត។ សូមធ្វើតាមជំហានទាំងនេះតាមឧបករណ៍របស់អ្នក រួច Copy Block ខាងក្រោម។

  1. 1
    រក Shell របស់អ្នក៖ ដំណើរការ ។ សម្រាប់ ប្រើ ។ សម្រាប់ ដាក់ Block ក្នុង មិនថាអ្នកប្រើ Operating System ណាក៏ដោយ។
  2. 2
    បើកវាក្នុង Editor៖ ដំណើរការ ។ បើ Bash ចាប់ផ្តើមជា Login shell សូមឱ្យ Source ដោយបន្ថែម នៅក្នុងនោះ។
  3. 3
    Paste Block ខាងក្រោមនៅផ្នែកខាងក្រោមបំផុតនៃ File រួចជំនួស ដោយ hashn0de Key ពិតរបស់អ្នក។
  4. 4
    រក្សាទុក រួចបិទ៖ ចុច រួច ដើម្បីរក្សាទុក បន្ទាប់មក ដើម្បីចេញពី nano។
  5. 5
    ផ្ទុកវាចូល Terminal បច្ចុប្បន្ន៖ ដំណើរការ សម្រាប់ File ដែលអ្នកបានកែ។ Interactive shell ថ្មីៗនឹងផ្ទុកវាដោយស្វ័យប្រវត្តិ ហើយ Bash Login shell នឹងប្រើការភ្ជាប់ពីជំហានមុន។
  6. 6
    ជោគជ័យ — ចាប់ពីពេលនេះ គ្រាន់តែវាយ ក្នុង Terminal ណាមួយ ដើម្បីចាប់ផ្តើម Claude Code តាម Gateway។
bash
# Paste at the bottom of your profile, then change the key to your real one
export HASHN0DE_API_KEY="sk-xxxxxxxxxxxx"

claude-hashn0de() {
  ANTHROPIC_BASE_URL="https://api.hashn0de.com" \
  ANTHROPIC_AUTH_TOKEN="${HASHN0DE_API_KEY:?Set HASHN0DE_API_KEY first}" \
  ANTHROPIC_MODEL="claude-opus-5" \
  claude --dangerously-skip-permissions "$@"
}
នៅលើ Windows សូម Paste Block ដូចគ្នានេះទៅក្នុង PowerShell profile ($PROFILE) ជំនួសឱ្យ ~/.zshrc ឬ ~/.bashrc — ជំហានខាងលើបង្ហាញពាក្យបញ្ជា PowerShell រួចហើយ នៅពេលអ្នកជ្រើស Windows។
Block នេះរក្សាទុក Key របស់អ្នកក្នុង Profile ដូច្នេះអ្នកមិនចាំបាច់វាយវាម្តងទៀតឡើយ — ងាយស្រួលនៅលើម៉ាស៊ីនផ្ទាល់ខ្លួន។ នៅលើកុំព្យូទ័ររួម ឬកុំព្យូទ័រការងារ សូម Paste តែអនុគមន៍ ហើយដំណើរការ export HASHN0DE_API_KEY="sk-..." ក្នុង Terminal នៅពេលត្រូវការវិញ។ ទោះជាយ៉ាងណា សូមចាត់ទុក File ណាដែលផ្ទុក Key ជាទិន្នន័យសម្ងាត់។

៣. ផ្ទៀងផ្ទាត់ការតភ្ជាប់

ពិនិត្យបញ្ជី Model ជាមុនសិន នៅពេល Key របស់អ្នកគាំទ្រវា បន្ទាប់មកពិនិត្យការរាប់ Token ដែលគាំទ្រទម្រង់ Anthropic មុននឹងបើក Claude Code។ ពាក្យបញ្ជាពិនិត្យទាំងនេះអាន Key ពីអថេរ Shell HASHN0DE_API_KEY — សូម Export វាជាមុនសិន ដូចជំហានទីមួយរបស់ Launcher ឬរំលងទៅបើក claude ផ្ទាល់ រួចផ្ញើ Prompt ខ្លីមួយ។

bash
: "${HASHN0DE_API_KEY:?Set HASHN0DE_API_KEY first}" && curl https://api.hashn0de.com/v1/models \
  -H "Authorization: Bearer $HASHN0DE_API_KEY"
លទ្ធផលដែលរំពឹងទុក: GET /v1/models ផ្ទៀងផ្ទាត់ Key ដែលគាំទ្របញ្ជី Model។ Key ដែលគាំទ្រតែ Messages អាចទទួលបានការឆ្លើយតបថា Path មិនគាំទ្រ; សម្រាប់ Key ទាំងនោះ សូមបើក Claude Code ហើយផ្ញើ Prompt ខ្លីមួយដើម្បីផ្ទៀងផ្ទាត់។ សំណើរាប់ Tokens ផ្ទៀងផ្ទាត់ទម្រង់សំណើ ប៉ុន្តែ Key ខ្លះទទួលបានការប៉ាន់ស្មាន Input Tokens ក្នុងម៉ាស៊ីន ដូច្នេះវាមិនមែនជាលទ្ធផលផ្ទៀងផ្ទាត់ Key ទេ។ Claude Code គួរបើកដោយមិនស្នើឱ្យ Sign in ទៅ Anthropic។

វិធីដោះស្រាយបញ្ហាទូទៅ

កំហុស 401 ឬ Key មិនត្រឹមត្រូវ៖ សូមបញ្ចូល Key ឡើងវិញដោយគ្មានការដកឃ្លា ក្នុង settings.json (ឬក្នុង Export របស់អ្នក) រួចផ្ទៀងផ្ទាត់វានៅលើទំព័រពិនិត្យ Key (Key checker)។
បើមានជួរម៉ូដែលស្ទួន ឬមិនរំពឹងទុក៖ សូមលុប gateway discovery និង ANTHROPIC_DEFAULT_*_MODEL exports ចាស់ៗ ចាប់ផ្តើម Session ឡើងវិញ រួចដំណើរការ /model ម្តងទៀត។
សំណើចេញទៅ Anthropic ដោយផ្ទាល់៖ សូមផ្ទៀងផ្ទាត់ថា env block ត្រូវបានរក្សាទុកក្នុង Claude settings.json ឬបើកតាមរយៈ claude-hashn0de ជំនួសឱ្យ claude ធម្មតា។
នៅតែរំលង Gateway ទោះបីប្រើ claude-hashn0de ក៏ដោយ៖ សូម Unset ANTHROPIC_API_KEY ដែលនៅសេសសល់ ឬអថេរណាមួយក្នុងចំណោម CLAUDE_CODE_USE_ANTHROPIC_AWS, CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_FOUNDRY, CLAUDE_CODE_USE_GATEWAY, CLAUDE_CODE_USE_MANTLE, CLAUDE_CODE_USE_VERTEX រួចដំណើរការឡើងវិញ។

សម្អាតការកំណត់ Global ចាស់ៗ

វិធីទាំងពីរខាងលើមិនទុក Export សល់ក្នុង Shell របស់អ្នកឡើយ។ ដើម្បីឈប់ភ្ជាប់តាម Gateway សូមលុប env block ចេញពី settings.json ហើយប្រសិនបើអ្នកធ្លាប់ Export អថេរ Gateway ជា Global ពីមុនមក សូម Unset ពួកវាចេញទាំងអស់ផងដែរ មុននឹងបន្តប្រើប្រាស់ Anthropic ដោយផ្ទាល់៖

bash
unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_MODEL ANTHROPIC_DEFAULT_FABLE_MODEL ANTHROPIC_DEFAULT_OPUS_MODEL ANTHROPIC_DEFAULT_SONNET_MODEL ANTHROPIC_DEFAULT_HAIKU_MODEL CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY

បន្តការដំឡើង