使用文檔

Claude Code 安裝與全能指南

跟隨這份文檔，你可以從零搭建 Claude Code 工作環境，配置 Codex、掌握核心命令，並快速上手高效的 AI 輔助開發流程。

Claude Code 安裝指南

一步步在本地環境部署 Claude Code。

Codex 配置指南

聯動 Codex 與中轉服務，統一配置密鑰和上下文。

Claude Code 功能

瞭解 Claude Code 支持的核心能力與智能特性。

常見命令與快捷鍵

高頻終端命令與編輯器快捷操作一覽。

推薦提示詞大全

精選高效提示詞模板，快速喚起 Claude 最佳表現。

最佳實踐與使用技巧

沉澱實戰經驗，打造穩定高效的 AI 開發流程。

Claude Code 安裝指南

覆蓋 Windows、macOS 與 Linux 的完整安裝流程，確保環境變量、依賴與常見問題全部處理到位。

Windows

適用於 Windows 10 / 11，推薦使用 PowerShell 執行命令。

步步跟進

步驟 1：安裝 Node.js 環境

Claude Code 需要 Node.js 才能運行，優先選擇 LTS 版本。

方法一：官網下載（推薦）
  1. 打開Node.js 官方下載頁面，選擇 LTS 版本。
  2. 下載完成後雙擊 .msi 安裝包，按照嚮導保持默認設置即可。
  3. 安裝結束後重新打開 PowerShell 以加載最新環境變量。
方法二：使用包管理器

已安裝 Chocolatey 或 Scoop 的用戶可以直接執行：

# Chocolatey
choco install nodejs

# Scoop
scoop install nodejs
Windows 注意事項
  • 優先使用 PowerShell（管理員）執行命令，權限更穩定。
  • 安全軟件可能攔截安裝過程，如遇提示請添加白名單。
  • 使用 node --version 和 npm --version 驗證安裝是否成功。

步驟 2：安裝 Claude Code

在 PowerShell 或 CMD 中執行全局安裝命令：

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

常見報錯：PowerShell 執行策略限制

若出現 無法加載文件 npm.ps1 的提醒，請：

  1. 以管理員身份打開 PowerShell。
  2. 執行 Set-ExecutionPolicy RemoteSigned 並確認。
  3. 關閉管理員窗口，重新在普通 PowerShell 中執行安裝命令。

安裝完成後使用 claude --version 驗證版本號。

步驟 3：配置環境變量

請將 Claude 中轉服務的地址與密鑰寫入環境變量，以便 CLI 自動連接。

PowerShell（永久生效）
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.ccode.hk", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密鑰", "User")

重新打開終端即可生效。

CMD（永久生效）
setx ANTHROPIC_BASE_URL "https://api.ccode.hk"
setx ANTHROPIC_AUTH_TOKEN "你的API密鑰"

關閉並重新打開 CMD 後即可使用。

臨時設置可使用 $env:變量名，但關閉窗口後會失效。

步驟 4：啓動與常見問題

執行下列命令確認安裝狀態並啓動：

claude --version
claude
常見報錯：缺少 Git Bash

如出現 “Claude Code on Windows requires git-bash...” 提示，請安裝 Git：

  • 訪問Git 官方網站完成安裝。
  • 或在 PowerShell 中執行 winget install Git.Git。
  • 安裝後重新打開終端即可解決問題。

macOS

適用於 macOS Ventura 及以上版本，默認 shell 爲 zsh。

極速部署

步驟 1：準備 Node.js

可通過 Homebrew 或官方安裝包完成：

# 使用 Homebrew
brew update
brew install node

# 或訪問 https://nodejs.org/ 下載 macOS 安裝包

執行 node --version 與 npm --version 驗證安裝。

步驟 2：安裝 Claude Code

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

若使用 Apple Silicon，請確認已安裝 Rosetta（執行 softwareupdate --install-rosetta）。

步驟 3：寫入環境變量

將中轉地址與密鑰寫入 ~/.zshrc：

echo 'export ANTHROPIC_BASE_URL="https://api.ccode.hk"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密鑰"' >> ~/.zshrc
source ~/.zshrc

使用 bash 的用戶可改爲寫入 ~/.bash_profile。

步驟 4：驗證並啓動

執行以下命令確認配置：

claude --version
claude

若需要圖形界面，可在 Finder 中將項目目錄拖入終端，再執行命令。

Linux

適用於 Debian、Ubuntu、Fedora、Arch 等主流發行版。

專業開發者

步驟 1：安裝 Node.js

依據發行版選擇合適方案：

# Debian / Ubuntu
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs

# Fedora / CentOS
sudo dnf install -y nodejs

# Arch Linux
sudo pacman -S nodejs npm

步驟 2：安裝 Claude Code

sudo npm install -g @anthropic-ai/claude-code

部分發行版需設置 NODE_OPTIONS=--openssl-legacy-provider 以兼容舊版 OpenSSL。

步驟 3：配置環境變量

echo 'export ANTHROPIC_BASE_URL="https://api.ccode.hk"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密鑰"' >> ~/.bashrc
source ~/.bashrc

使用 zsh 等其他 shell，請相應寫入其配置文件。

步驟 4：驗證環境

claude --version
claude

若提示權限問題，請確保當前用戶已加入 sudoers 或使用 sudo 執行。

Codex 配置指南

Codex 是一款支持 OpenAI 接口的 AI 編程助手，通過配置中轉服務即可與 Claude Code 協同工作。

1. 全局安裝 Codex CLI

使用 npm 安裝最新版本：

npm install -g codex-cli

驗證安裝：codex --version

2. 配置環境變量

沿用 Claude Code 的環境變量即可共享密鑰：

export ANTHROPIC_BASE_URL="https://api.ccode.hk"
export ANTHROPIC_AUTH_TOKEN="你的API密鑰"

Windows 用戶可在 PowerShell 中執行對應的 SetEnvironmentVariable 命令。

3. 編輯 Codex 配置文件

打開 ~/.config/codex/config.json 或系統默認配置路徑，設置：

{
  "provider": "anthropic",
  "apiKey": null,
  "baseURL": "https://api.ccode.hk"
}

將 apiKey 設爲 null，實際密鑰通過環境變量注入。

4. 重啓 Codex 並驗證

重啓終端或 Codex 插件，執行

codex whoami

若返回 Anthropics 服務信息，即表示配置成功。

提醒：Codex 與 Claude Code 共用額度，建議結合用量查詢頁面定期檢查每日配額。

Claude Code 功能速覽

Claude Code 面向真實生產環境設計，兼顧重構、調試、文檔與協作場景。

多模態交互

支持文字、代碼、截圖與繪圖草稿等多種輸入形式。拖拽圖片即可讓 Claude 分析 UI、識別錯誤提示或理解架構圖。

項目級上下文

通過 claude add 與 claude edit 管理上下文，可一次性加載整個倉庫或指定模塊。

智能調試與審查

自動定位異常堆棧、生成修復建議，並對 PR 改動執行語義審查，補充邊界測試用例。

MCP 擴展生態

通過 MCP（Model Context Protocol）接入 GitHub、Jira、Notion 等工具，自動同步任務、提交 PR 或更新文檔。

常見命令與快捷鍵

熟練掌握以下命令組合，即可大幅提升日常使用效率。

終端命令

claude

啓動 Claude Code 交互式終端，進入對話主界面。

claude chat

切換到純聊天模式，適合快速問答與思路討論。

claude edit <file>

根據提示對指定文件執行智能修改。

claude add .

將當前目錄納入上下文，支持多文件分析。

claude ask "問題"

無需進入聊天界面，直接在終端提問 Claude。

claude mcp install <provider>

安裝並啓用 MCP 擴展，連接 GitHub、Jira 等外部服務。

快捷鍵速查

通用Ctrl / ⌘ + Enter

發送當前提示或執行命令。

通用Ctrl / ⌘ + K

打開命令面板，快速切換模式或運行腳本。

Windows / LinuxCtrl + L

清理終端輸出，保持會話整潔。

macOS⌘ + Shift + V

以純文本模式粘貼代碼，避免多餘格式。

通用Esc

取消當前輸入或清空尚未發送的提示內容。

推薦提示詞大全

複製即可使用，也可根據項目實際情況靈活調整上下文和目標。

重構遺留模塊

請審查 src/services/order.ts 中的 calculateDiscount 函數，將其重構爲可讀性更強的版本，保留現有邏輯並補充必要的單元測試。

多文件聯調

我準備引入 Redis 作爲緩存層，請列出需要修改的配置文件、依賴安裝命令以及關鍵代碼，並給出回滾方案。

代碼評審

以下是一個新提交的 PR，請從性能、安全性、邊界條件三個維度點評，並羅列需要追加的自動化測試。

生成技術文檔

請基於 utils/image-processor.ts 的導出函數生成中文 API 文檔，並補充示例代碼與注意事項。

最佳實踐與使用技巧

來自大量團隊落地經驗，幫助你在真實項目中穩健地使用 Claude Code。

規劃上下文窗口

一次加載必要文件即可，定期使用 claude clear 釋放歷史上下文，避免幻覺與性能下降。

先對齊目標後執行

複雜任務先讓 Claude 生成 PLAN，再逐步確認、執行與驗收，降低大範圍修改的風險。

善用命令組合

將 claude 命令與 git、npm、pytest 等工具組合，打造自動化工作流。

分階段提交變更

重要修改分批提交併描述上下文，Claude 的代碼解讀與跟進會更精確。

保護密鑰安全

統一通過環境變量或 .env 文件注入密鑰，避免直接寫死在項目與終端歷史中。

遇到企業部署、私有化接入或大規模團隊協作問題？隨時通過 WhatsApp 聯繫我們獲取一對一協助。

需要更多幫助？

我們提供遠程部署、團隊培訓與定製集成服務，確保每位成員都能充分利用 Claude Code 的能力。

WhatsApp 諮詢購買方案