Claude Code 是 Anthropic 推出的一款以終端機為優先的程式碼代理。它能夠讀取你的程式碼庫、編輯檔案、執行指令，並且可以連接到與 Anthropic 相容的後端，而不僅限於使用 Anthropic 的預設 API。本指南涵蓋 Claude Code CLI 的設定、斜線指令、自訂技能，以及如何透過 Novita AI 路由請求。
如果你需要資料庫、瀏覽器或其他外部工具，可搭配使用 Claude MCP 配置指南。
重點摘要
- Claude Code 是一個命令列代理，而不僅僅是一個提示框。
/compact、/resume、/permissions和/model是工作階段指令，而-p和--resume是 CLI 旗標。- 自訂斜線指令現在以技能的形式存在，因此
.claude/skills/和.claude/commands/兩者都很重要。 - Novita AI 可以透過
ANTHROPIC_BASE_URL作為與 Anthropic 相容的後端。 - Claude Code 適用於 IDE 風格的工作流程以及自動化代理執行。
什麼是 Claude Code？
Claude Code 是 Anthropic 的代理式程式碼工具。CLI 在你的終端機中執行，但同一個代理也會出現在桌面應用程式、瀏覽器介面和編輯器整合中。
CLI 是最靈活的介面。它遵循 Unix 慣例，因此你可以將檔案透過管道傳入其中，使用 -p 以非互動模式執行，並將其整合到腳本或 CI 中。配置存放在 CLAUDE.md、.claude/settings.json 和環境變數中，這使其非常適合可重複的程式碼工作流程。
在底層，Claude Code 會將請求傳送至與 Anthropic 相容的 API 端點。預設情況下，該端點是 Anthropic 自己的服務，但你可以透過單一環境變數將其重新導向至 Novita AI 的 LLM API。
Claude Code 設定
安裝
使用 Node.js 18 或更高版本安裝 CLI：
npm install -g @anthropic-ai/claude-code
首次執行
在專案目錄中啟動 Claude Code：
cd your-project
claude
首次使用時，Claude Code 會提示你登入。驗證後，它會讀取你的專案並等待指令。
專案設定
在任何新的儲存庫中執行 /init 以產生初始的 CLAUDE.md 檔案。Claude Code 會在每次工作階段開始時讀取 CLAUDE.md，因此它是放置編碼標準、偏好的函式庫、架構筆記和審查檢查清單的正確位置。
/init
在 /init 之後，使用 /memory 來編輯檔案或啟用自動記憶功能，該功能會儲存 Claude 在不同工作階段中對你的專案所做的觀察。
CLI 指令參考
| 指令 | 說明 |
|---|---|
claude |
在目前目錄中啟動互動式工作階段 |
claude "query" |
使用初始提示啟動工作階段 |
claude -p "query" |
執行查詢並結束 |
cat file | claude -p "query" |
將內容透過管道傳入查詢 |
claude -c |
繼續目前目錄中的最新工作階段 |
claude -r "name" "query" |
依名稱或 ID 恢復工作階段 |
claude update |
更新至最新版本 |
claude install stable |
安裝或重新安裝穩定版本二進位檔 |
claude auth login |
登入你的 Anthropic 帳戶 |
claude auth login --console |
使用 API 金鑰計費方式登入（而非訂閱） |
claude auth status |
顯示驗證狀態 |
claude mcp |
配置 MCP 伺服器 |
claude doctor |
顯示安裝和設定診斷資訊 |
CLI 旗標參考
| 旗標 | 作用 |
|---|---|
-p, --print |
非互動模式；列印回應並結束 |
-c, --continue |
載入最近的對話 |
-r, --resume |
依 ID 或名稱恢復工作階段 |
--model |
設定此工作階段的模型 |
--permission-mode |
以權限模式啟動 |
--add-dir |
授予額外目錄的檔案存取權限 |
--system-prompt |
完全取代系統提示 |
--append-system-prompt |
附加到預設系統提示 |
--max-turns |
限制 -p 模式中的代理回合數 |
--max-budget-usd |
設定 -p 模式中的 API 花費上限 |
--output-format |
-p 模式的輸出格式：text、json、stream-json |
--bg |
以背景代理啟動，立即返回 |
--worktree, -w |
在隔離的 git worktree 中啟動 |
--bare |
跳過鉤子、技能、外掛和 MCP 的自動發現，以加快腳本呼叫速度 |
--verbose |
顯示完整的逐回合輸出 |
--mcp-config |
從 JSON 檔案載入 MCP 伺服器 |
--effort |
設定推理努力程度 |
--print + --output-format json 組合是腳本化處理的標準模式。對於有預算限制的 CI 管道，請將其與 --max-budget-usd 和 --max-turns 結合使用。
斜線指令文件
斜線指令在活動工作階段中執行。輸入 / 可查看所有可用指令，或輸入 / 後接字母來篩選。指令僅在訊息開頭處有效。
工作階段與上下文管理
| 指令 | 用途 |
|---|---|
/clear |
開始新對話；先前的對話保留在 /resume 中 |
/compact |
摘要對話以釋放上下文視窗空間 |
/context |
視覺化上下文使用情況並查看最佳化建議 |
/resume |
依名稱或從選取器重新開啟先前的對話 |
/branch |
分岔對話以嘗試不同方向 |
/rewind |
將程式碼和對話回滾到檢查點 |
專案設定
| 指令 | 用途 |
|---|---|
/init |
為專案產生初始的 CLAUDE.md |
/memory |
編輯 CLAUDE.md 檔案並管理自動記憶 |
/mcp |
互動式管理 MCP 伺服器連線 |
/agents |
配置子代理設定 |
/permissions |
設定工具的允許、詢問和拒絕規則 |
/hooks |
檢視鉤子配置 |
開發工作流程
| 指令 | 用途 |
|---|---|
/plan |
在進行大型變更前進入計劃模式 |
/model |
切換活動模型 |
/effort |
調整推理努力程度 |
/diff |
開啟互動式 diff 檢視器 |
/code-review [--fix] |
審查目前 diff；--fix 套用審查結果 |
/security-review |
對待定變更進行深度安全檢查 |
/batch <instruction> |
將大型變更分解並在平行 worktree 中執行 |
/background |
分離工作階段以作為背景代理執行 |
工具
| 指令 | 用途 |
|---|---|
/help |
顯示可用指令 |
/doctor |
診斷安裝和設定問題 |
/usage |
顯示工作階段成本和方案使用量 |
/export |
將對話匯出為純文字 |
/config |
開啟設定或直接設定值 |
/skills |
列出可用技能 |
自訂斜線指令
自訂斜線指令現在以技能的形式存在。現有的 .claude/commands/ 檔案仍可使用，但 .claude/skills/ 是較推薦的格式。
如何建立自訂指令
在 .claude/skills/（專案層級）或 ~/.claude/skills/（個人層級）下建立目錄：
mkdir -p .claude/skills/review-pr
在該目錄中建立 SKILL.md 檔案：
---
description: Review an open GitHub PR for security issues and test coverage gaps.
---
## Instructions
Review the pull request with these priorities:
1. Identify security vulnerabilities.
2. Check test coverage for new code paths.
3. Flag missing error handling at system boundaries.
這會建立一個 /review-pr 指令，你可以直接呼叫：
/review-pr
當你提出與描述相符的要求時，Claude 也會自動載入該技能。
技能位置與優先順序
~/.claude/skills/ → personal, all projects
.claude/skills/ → this project only
在 .claude/commands/ 中的自訂指令仍可使用。位於 .claude/commands/deploy.md 的檔案和位於 .claude/skills/deploy/SKILL.md 的技能都會建立 /deploy 指令。
使用 Novita AI 作為 LLM 後端
Claude Code 透過 ANTHROPIC_BASE_URL 路由 API 流量。將其設定為 Novita AI 的 Anthropic 相容端點，即可在不改變 Claude Code 工作流程的情況下使用 Novita 模型。
取得你的 Novita AI API 金鑰
註冊 Novita AI 帳戶 以獲得免費試用額度。然後開啟 金鑰管理頁面，按一下 建立新金鑰，並立即複製金鑰。
設定環境變數
在 Mac 和 Linux 上：
export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<Your Novita API Key>"
export ANTHROPIC_MODEL="moonshotai/kimi-k2-instruct"
export ANTHROPIC_SMALL_FAST_MODEL="moonshotai/kimi-k2-instruct"
在 Windows（命令提示字元）上：
set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<Your Novita API Key>
set ANTHROPIC_MODEL=moonshotai/kimi-k2-instruct
set ANTHROPIC_SMALL_FAST_MODEL=moonshotai/kimi-k2-instruct
ANTHROPIC_SMALL_FAST_MODEL 控制 Claude Code 用於快速內部任務（如檔案查詢和快速摘要）的輕量級模型。
啟動 Claude Code
cd your-project
claude
對於腳本和 CI，同樣的方法適用：
cat logs.txt | claude -p "find any error patterns" --output-format json
Novita AI 的 LLM API 支援 Anthropic 訊息格式，包括工具使用、結構化輸出和串流，因此 Claude Code 無需修改即可運作。
用於隔離執行的代理沙盒
如果你正在 Claude Code 之上建立自動化管道，Novita AI 的 Agent Sandbox 可為代理執行提供隔離環境，這對於 CI 工作流程和多步驟程式碼作業非常有用。
Claude Code 作為 IDE 工具
Claude Code 常被形容為「一個 IDE」，因為它融入你現有的工作流程，而非取代它。更精確地說，它是一個與你的終端機、編輯器和專案上下文協同工作的代理層。
VS Code 和 Cursor
從 VS Code Marketplace 或 Cursor marketplace 安裝 Claude Code 擴充功能。安裝後，開啟命令面板，輸入「Claude Code」，然後選擇 在新分頁中開啟。
VS Code 整合新增了內嵌 diff 審查、檔案提及、編輯前的計劃審查，以及直接在編輯器面板中的對話歷史記錄。你也可以在整合終端機中與擴充功能一起使用 Claude Code。
JetBrains
從 JetBrains Marketplace 安裝 Claude Code 外掛並重新啟動你的 IDE。它在 IntelliJ IDEA、PyCharm、WebStorm 和其他 JetBrains IDE 中提供互動式 diff 檢視和選取上下文共用。
桌面應用程式和網頁
Claude Code 桌面應用程式可讓你以視覺化方式檢視 diff 並排執行多個工作階段。位於 claude.ai/code 的網頁介面可在瀏覽器中執行工作階段，無需本機設定。
常見問題
ANTHROPIC_BASE_URL 是什麼？為什麼它很重要？
ANTHROPIC_BASE_URL 告訴 Claude Code 要將請求傳送至哪個 API 端點。預設是 Anthropic 的 API。將其設定為 https://api.novita.ai/anthropic 會將流量路由至 Novita AI 的 Anthropic 相容端點。
CLI 旗標和斜線指令之間有什麼差別？
CLI 旗標是在你從 shell 啟動 claude 時設定的。斜線指令則在活動工作階段中執行，並在對話中途改變行為。
我可以在沒有 Claude 訂閱的情況下使用 Claude Code 嗎？
可以。claude auth login --console 使用 Anthropic Console API 金鑰計費方式登入。如果你透過 ANTHROPIC_BASE_URL 路由至 Novita AI，則只需要一個 Novita AI 帳戶。
自訂斜線指令與 CLAUDE.md 有什麼不同？
CLAUDE.md 在每個工作階段開始時載入並保持在上下文中。技能僅在呼叫時載入，因此請使用 CLAUDE.md 來存放常駐的專案事實，並使用技能來存放可重複的程序。
Claude Code 可以在 CI 中運作嗎？
可以。使用 claude -p "query" --output-format json 以非互動模式執行。加入 --max-budget-usd 來限制花費，以及 --max-turns 來限制執行時間。
Novita AI 是一個 AI 雲端平台，為開發者提供使用我們簡單 API 部署 AI 模型的簡便方式，同時也提供價格合理且可靠的 GPU 雲端服務，用於建置和擴展。
