Claude Code 國內(nèi)合規(guī)使用教程(2026年最新分享)
適用 Windows / macOS / Linux,并包含 國內(nèi)網(wǎng)絡(luò)環(huán)境可用方案與常見問題排查。
Claude Code 是 Anthropic 官方的終端 AI 編程助手,可用于:寫代碼、解釋代碼、重構(gòu)、生成腳本、審查 PR、運(yùn)行測試、維護(hù)項(xiàng)目記憶(CLAUDE.md)等。

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - sudo apt-get install -y nodejs node -v npm -v
macOS(Homebrew)
brew install node node -v npm -v
Windows(推薦)
- 到 Node.js 官網(wǎng)下載安裝 LTS
- 安裝后在 PowerShell / CMD 執(zhí)行:
node -v npm -v
2)安裝 Claude Code(全局安裝)
npm install -g @anthropic-ai/claude-code claude --version
如果看到類似 v0.3.2 的版本號,說明安裝成功。
如果你用的是 macOS/Linux 且權(quán)限報錯,可嘗試:
sudo npm install -g @anthropic-ai/claude-code
或使用 nvm 管理 Node 避免 sudo(更推薦)。
? 二、獲取 API 令牌(國內(nèi)網(wǎng)絡(luò)環(huán)境可用方案)
方案 A(官方方式):Anthropic API Key
如果你可以正常訪問 Anthropic 官方并能付款,這是最穩(wěn)妥的方式。
方案 B(國內(nèi)常用):第三方中轉(zhuǎn)服務(wù)(示例:DKAPI)
提示:第三方中轉(zhuǎn)服務(wù)并非官方,優(yōu)點(diǎn)是國內(nèi)更容易直連、可能有試用額度;缺點(diǎn)是安全、穩(wěn)定性、隱私都取決于服務(wù)商。
例如
| 平臺 | Anthropic 兼容接口地址 | 推薦模型 |
|---|---|---|
| 硅基流動 | https://api.siliconflow.cn | Qwen/Qwen3-235B-A22B-Instruct-2507 |
| 智譜 AI | https://open.bigmodel.cn/api/anthropic | glm-4.5-air |
| DeepSeek | https://api.deepseek.com/anthropic | deepseek-chat |
| MiniMax | https://api.minimaxi.com/anthropic | MiniMax-M2.5 |
基本步驟(通用,不強(qiáng)綁定某一家)
- 注冊并登錄中轉(zhuǎn)平臺
- 在控制臺創(chuàng)建 API Token(一般以
sk-開頭) - 記錄 Token 與 Base URL(通常平臺會提供類似
https://xxx.xxx的地址)
? 三、配置環(huán)境變量(強(qiáng)烈推薦寫入配置文件)
Claude Code 通過環(huán)境變量讀取 Token 與 API 地址:
ANTHROPIC_AUTH_TOKEN:你的 API Key / TokenANTHROPIC_BASE_URL:第三方中轉(zhuǎn)地址(如果用官方則通常不需要設(shè)置)
1)Linux / macOS:臨時設(shè)置(僅當(dāng)前終端有效)
export ANTHROPIC_AUTH_TOKEN="sk-你的令牌" export ANTHROPIC_BASE_URL="https://api.dakeai.cc"
2)Linux / macOS:永久設(shè)置(推薦)
bash 用戶
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"' >> ~/.bashrc echo 'export ANTHROPIC_BASE_URL="https://api.dakeai.cc"' >> ~/.bashrc source ~/.bashrc
zsh 用戶(macOS 默認(rèn))
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"' >> ~/.zshrc echo 'export ANTHROPIC_BASE_URL="https://api.dakeai.cc"' >> ~/.zshrc source ~/.zshrc
3)Windows:永久設(shè)置(推薦)
PowerShell(當(dāng)前用戶)
setx ANTHROPIC_AUTH_TOKEN "sk-你的令牌" setx ANTHROPIC_BASE_URL "https://api.dakeai.cc"
設(shè)置后請重新打開一個新的 PowerShell / 終端窗口再運(yùn)行 Claude Code。
驗(yàn)證是否生效:
echo $env:ANTHROPIC_AUTH_TOKEN echo $env:ANTHROPIC_BASE_URL
? 四、啟動 Claude Code(首次啟動說明)
進(jìn)入你的項(xiàng)目目錄:
cd your-project-folder claude
首次啟動通常會出現(xiàn)交互式引導(dǎo),包括:
- 選擇主題(Theme)
- 確認(rèn)安全提示
- 使用默認(rèn) Terminal 設(shè)置
- 信任當(dāng)前工作目錄(Trust current directory)
建議:只在可信項(xiàng)目里選擇 Trust,避免在陌生目錄中授權(quán)過多訪問。
? 五、常用命令速查表
| 命令 | 作用 |
|---|---|
| claude | 啟動交互式會話 |
| claude -p "生成一個登錄頁面" | 一次性執(zhí)行 prompt(適合腳本/自動化) |
| claude --continue | 恢復(fù)上一次會話 |
| /clear | 清空當(dāng)前會話上下文 |
| /cost | 查看 token / 費(fèi)用消耗 |
| /memory | 編輯項(xiàng)目記憶文件(通常是 CLAUDE.md) |
| /review | 請求代碼審查(review) |
| /config | 查看或修改配置 |
| claude update | 更新 Claude Code 到最新版 |
? 六、進(jìn)階功能
1)接入外部工具(MCP:模型上下文協(xié)議)
MCP 可以讓 Claude Code 調(diào)用外部服務(wù)或工具,例如數(shù)據(jù)庫、瀏覽器自動化等。
添加 MySQL(示例)
claude mcp add mysql npx @benborla29/mcp-server-mysql \ -e MYSQL_HOST=localhost \ -e MYSQL_USER=root \ -e MYSQL_PASS=你的密碼 \ -e MYSQL_DB=test
添加 Playwright(網(wǎng)頁自動化)
claude mcp add playwright npx '@playwright/mcp@latest'
提醒:MCP 工具可以訪問你的系統(tǒng)/網(wǎng)絡(luò)資源,務(wù)必只安裝可信來源。
2)自定義團(tuán)隊(duì)快捷命令(項(xiàng)目共享)
在項(xiàng)目根目錄創(chuàng)建:
./.claude/commands.json
示例:
{
"run-tests": "npm run test",
"deploy": "npm run build && rsync -av dist/ server:/var/www/"
}之后你可以在 Claude Code 中快速調(diào)用這些命令(團(tuán)隊(duì)共享同一套流程非常方便)。
? 七、國內(nèi)使用常見問題與排查建議
| 問題 | 可能原因 | 解決方法 |
|---|---|---|
| API 報錯 / 連接超時 | 網(wǎng)絡(luò)不穩(wěn)定 / 中轉(zhuǎn)擁堵 | 重試、切換網(wǎng)絡(luò)、換中轉(zhuǎn)節(jié)點(diǎn) |
| 顯示 offline | 僅狀態(tài)提示異常 | 通常不影響使用,可繼續(xù) |
| fetch failed | DNS/網(wǎng)絡(luò)/代理問題 | 開啟全局代理、切換網(wǎng)絡(luò)、檢查 BASE_URL 是否可訪問 |
| Token 無效 | Token 未設(shè)置或復(fù)制錯誤 | 檢查環(huán)境變量是否生效(重新打開終端) |
| 權(quán)限/目錄信任問題 | 未 trust 項(xiàng)目目錄 | 在可信項(xiàng)目下重新啟動并信任 |
額外安全建議(強(qiáng)烈推薦加入教程里):
- 不要把 Token 寫進(jìn)代碼倉庫(Git)
- 不要在 Claude 中粘貼生產(chǎn)密鑰、數(shù)據(jù)庫密碼、客戶數(shù)據(jù)
- 使用第三方中轉(zhuǎn)時,只用于學(xué)習(xí)/非敏感項(xiàng)目
? 八、實(shí)戰(zhàn)案例:1 分鐘生成掃雷小游戲(HTML + JS)
一條命令生成:
claude -p "用 HTML+JS 寫一個掃雷小游戲,支持點(diǎn)擊格子、右鍵標(biāo)記地雷,帶計(jì)時和重新開始按鈕"
保存生成文件后運(yùn)行(Python 示例):
python -m http.server 8000
瀏覽器訪問:
http://localhost:8000
通常生成 + 運(yùn)行速度非???,成本視模型和輸出長度而定。
? 總結(jié)(一句話版本)
Claude Code = 終端里的 Claude AI:寫代碼、重構(gòu)、查文檔、審查、測試一條龍;國內(nèi)網(wǎng)絡(luò)環(huán)境可通過官方或第三方中轉(zhuǎn)接入使用。
到此這篇關(guān)于Claude Code 國內(nèi)合規(guī)使用教程(2026年最新分享)的文章就介紹到這了,更多相關(guān)Claude Code 國內(nèi)使用內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章,希望大家以后多多支持腳本之家!
相關(guān)文章
文章介紹了AI編程助手ClaudeCode的安裝、使用和配置方法,包括安裝步驟、簡單使用案例及注意事項(xiàng)等內(nèi)容,需要的朋友可以參考下2026-06-09
在國內(nèi)穩(wěn)定用Claude Code的三種姿勢小結(jié)
本文介紹了三種在國內(nèi)穩(wěn)定使用ClaudeCode的方法:包括使用API中轉(zhuǎn)、替換國產(chǎn)大模型和本地部署三種方案,,分析了每種方案的優(yōu)缺點(diǎn),并提供了詳細(xì)配置指南,幫助開發(fā)者根據(jù)需2026-04-10



