在DSW中使用Claude Code - Platform For AI

快速開始

步驟一：安裝 Claude Code

開啟 DSW Terminal，運行以下命令：

curl -fsSL https://pai-dsw-ai-machine.oss-cn-beijing.aliyuncs.com/agent/claude/setup-cc-dsw.sh -o setup-cc-dsw.sh && bash setup-cc-dsw.sh

指令碼會引導您完成安裝和配置：

安裝 Node.js 和 Claude Code。
選擇模型服務並配置串連。推薦PAI-Token 服務，詳見步驟二。
持久化配置到 /mnt/workspace或使用者指定的其他掛載路徑，執行個體重啟後免重裝。

步驟二：配置模型服務

Claude Code 是用戶端工具，需要串連大模型才能工作。推薦使用 PAI-Token 服務，具有以下優勢：

零部署：開通即用，不需要自行部署 vLLM 服務。
模型豐富：覆蓋 Qwen最新大模型、DeepSeek、GLM 等主流模型，可一鍵切換。
網路友好：從 DSW 內網調用穩定低延遲。
統一計費：與 PAI 資源同賬單管理，對企業客戶更友好。

如需使用百鍊或EAS的模型服務請參見附錄：使用其他模型服務。

開通 PAI-Token 服務

訪問 PAI-Token 服務控制台。
如果未開通，單擊一鍵開通。
回到安裝指令碼，在菜單中選擇PAI-Token 服務。指令碼會自動擷取 Token 並完成配置。

PAI-Token服務按Token計費，詳細說明請參見PAI Token服務計費說明。

說明

如果 DSW 執行個體已配置 PAI 預設角色（ALIBABA_CLOUD_CREDENTIALS_URI 可用），指令碼會自動擷取 Token，無需手動複製粘貼。

選擇模型

指令碼會自動拉取可用模型列表供您選擇：

情境	推薦模型	說明
通用編程 / 重構	`qwen3.7-max`	旗艦大模型，綜合能力最強（預設推薦）
代碼專項	`qwen3-coder-plus`	代碼產生專項調優，長上下文友好
複雜推理 / 大型重構	`deepseek-v4-pro`	推理與規劃能力突出，適合架構級任務
上一代旗艦	`qwen3-max`	Qwen3 系列旗艦，穩定可靠
多模態分析	`qwen3-vl-plus`	支援圖片理解（截圖、圖表、UI 設計稿）
極致響應速度	`deepseek-v4-flash`	輕量快速，適合簡單 QA / 改名 / 注釋產生
性價比日常	`qwen3.6-plus` / `qwen3.5-plus`	日常對話和小改動足夠
GLM 系列	`glm-5.2` / `glm-5.1` / `glm-5`	智譜 GLM 系列模型，可按偏好選用

可用模型列表會不斷更新，請以指令碼運行時顯示的列表為準。

想更換模型時，編輯 ~/.claude/settings.json 中的 ANTHROPIC_MODEL 欄位，或重跑 bash setup-cc-dsw.sh --reconfigure。

步驟三：開始使用

進入專案目錄，輸入 claude 啟動，用自然語言描述您想做的事。

樣本：將 Notebook 重構為訓練指令碼

cd /mnt/workspace/my-project
claude

啟動後輸入任務描述，例如：

我有一個 Notebook：notebooks/train_lora.ipynb，需要重構為 src/train.py，支援 --config 參數、多卡訓練（相容 DLC torchrun）、定期儲存 checkpoint。先讀取 Notebook 理解現有邏輯，再開始重構。

Claude Code 會讀取 Notebook、理解邏輯、產生指令碼，您可以直接在 Terminal 中驗證結果。

更多情境

GPU 調試：把 CUDA OOM 報錯貼給 Claude Code，它會給出 batch_size、gradient_accumulation_steps 等調整建議。
資料處理：描述輸入格式、輸出格式和過濾規則，Claude Code 產生指令碼並測試。
DLC 分布式訓練：單卡調通後，讓 Claude Code 產生 DLC 任務配置和提交指令碼。
EAS 推理服務：在 DSW 裡開發和調試 EAS 推理服務，無需反覆部署到線上。

用 CLAUDE.md 告訴 Claude Code 專案上下文

Claude Code 能自動讀取代碼，但有些資訊它無法從代碼中擷取，比如 GPU 型號、資料目錄、訓練命令。把這些寫進 CLAUDE.md 檔案，Claude Code 啟動時會自動讀取。

setup-cc-dsw.sh 會一鍵產生全域和專案級兩份 CLAUDE.md，您也可以在 Claude Code 內用 /init 命令補充專案結構。

CLAUDE.md 放在哪裡

路徑	範圍	寫什麼
`~/.claude/CLAUDE.md`	全域	DSW 共性規則：路徑約定、禁止寫系統硬碟、敏感操作必須確認等
`<專案根>/CLAUDE.md`	專案	專案結構、GPU/Python 版本、訓練/推理命令、依賴版本
`<子目錄>/CLAUDE.md`	局部	僅在該子模組下生效的規則

寫什麼內容

唯寫 Claude Code 無法從代碼中推斷的資訊：

運行環境：GPU 型號和數量、Python/CUDA 版本、conda 環境名。
關鍵路徑：代碼、資料、模型輸出的絕對路徑。
常用命令：單卡調試、多卡訓練、推理啟動的命令。
禁忌：不能做的事，如"不要寫到 /home"、"不要直接 commit 到 main"。

說明

如果 Claude Code 反覆犯同一個錯誤，在對話中用 # 開頭輸入一條規則，Claude Code 會自動寫入 CLAUDE.md。

提示

在專案目錄啟動：Claude Code 以啟動目錄為專案根目錄，在 /mnt/workspace/your-project 下啟動才能正確感知專案檔。
用 /compact 釋放上下文：長對話後 Claude Code 可能變慢。切換任務時輸入 /compact，清理歷史對話釋放空間。
先 git init：建議在使用 Claude Code 前初始化 Git 倉庫，方便隨時復原修改。

資料持久化說明

DSW 執行個體的預設工作目錄是 /mnt/workspace。資料是否在執行個體停止後保留，取決於儲存配置：

雲端硬碟：公用資源群組停機超 15 天資料清空；專有資源群組刪除執行個體後資料清空。
NAS / CPFS 掛載（推薦）：資料獨立於執行個體生命週期，刪除執行個體後仍保留。

說明

建議建立執行個體時將 NAS 或 CPFS 掛載到 /mnt/workspace，這樣工作目錄天然持久化，多個執行個體也能共用代碼和資料。

安裝指令碼會將 Claude Code 的設定檔軟連結到 /mnt/workspace/.claude-persist/，並將臨時檔案重新導向到 /mnt/workspace/.claude-tmp，避免佔滿系統硬碟 /tmp 空間。

常見問題

Q：安裝指令碼網路逾時怎麼辦？

確認 VPC 已開通公網 NAT Gateway。指令碼會自動切換 npm 鏡像重試；仍失敗則檢查執行個體的出網白名單。

Q：claude 命令報 401 或 403？

Token 無效或與 Base URL 不匹配。重跑 bash setup-cc-dsw.sh --reconfigure。也可用 curl 驗證：

curl -H "Authorization: Bearer YOUR_TOKEN" https://aiservice.cn-beijing.aliyuncs.com/anthropic

Q：執行個體重啟後 claude 命令找不到？

使用專有資源建立的DSW執行個體若未掛載NAS / CPFS，執行個體停止後系統硬碟將被清空，重啟後需重新安裝claude。

Q：PAI-Token 服務的 Base URL 為什麼是 cn-beijing？

PAI-Token 服務的 Anthropic 相容入口統一部署在 cn-beijing，與 DSW 執行個體所在地區無關。其他地區的 DSW 通過公網調用，延遲略高但不影響使用。

附錄：使用其他模型服務

除 PAI-Token 服務外，也可以接入百鍊或 EAS 自行部署的服務。編輯 ~/.claude/settings.json，或重跑 bash setup-cc-dsw.sh --reconfigure 變更配置。

百鍊隨用隨付

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-YOUR_KEY",
    "ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic",
    "ANTHROPIC_MODEL": "qwen3-coder-plus",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3-coder-plus",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3-coder-plus",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3-coder-plus"
  }
}

百鍊支援多個地區端點：

地區	Base URL
華北2（北京）	`https://dashscope.aliyuncs.com/apps/anthropic`
新加坡	`https://dashscope-intl.aliyuncs.com/apps/anthropic`
美國（維吉尼亞）	`https://dashscope-us.aliyuncs.com/apps/anthropic`

重要

API Key 必須與地區對應，不可跨地區使用。

百鍊 Coding Plan

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-YOUR_CODING_PLAN_KEY",
    "ANTHROPIC_BASE_URL": "https://coding.dashscope.aliyuncs.com/apps/anthropic",
    "ANTHROPIC_MODEL": "qwen3.6-plus",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.6-plus",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.6-plus",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-plus"
  }
}

百鍊 Token Plan 團隊版

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-YOUR_TOKEN_PLAN_KEY",
    "ANTHROPIC_BASE_URL": "https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic",
    "ANTHROPIC_MODEL": "qwen3.6-plus",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.6-plus",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.6-plus",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-plus"
  }
}

EAS 自部署模型

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_EAS_TOKEN",
    "ANTHROPIC_BASE_URL": "https://YOUR_ENDPOINT.pai-eas.aliyuncs.com",
    "ANTHROPIC_MODEL": "qwen3-coder",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3-coder",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3-coder",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3-coder"
  }
}

重要

EAS 服務需使用 Anthropic 相容入口啟動：python3 -m vllm.entrypoints.anthropic.api_server --enable-auto-tool-choice --tool-call-parser hermes。詳見在Claude Code中使用PAI模型。

Platform For AI：在DSW中使用Claude Code