Claude Code 完整教程
什麼是 Claude Code?
Claude Code 是 Anthropic 官方推出的終端原生 AI 編碼助手,可直接在命令行中完成複雜的軟件工程任務。
效率對比
| 場景 | 傳統方式 | 使用 Claude Code |
|---|---|---|
| 重構函數 | 手動逐行修改,30+ 分鐘 | 自然語言描述,2 分鐘完成 |
| 添加單元測試 | 手寫模板,反覆調試 | 一句話生成完整測試套件 |
| 代碼審查 | 人工逐行閱讀 | 秒級發現潛在問題和改進點 |
支持環境與系統要求
- Node.js 18 或更高版本
- npm 或 yarn 包管理器
- 有效的 AIOneGate API Key
- 穩定的網絡連接
安裝步驟
推薦使用 cc-switch 一鍵完成所有配置
cc-switch →手動安裝步驟:
npm install -g @anthropic-ai/claude-code
API 配置
1. 獲取 API Token
訪問 AIOneGate 控制台,在令牌管理頁面創建新令牌。
2. 配置 settings.json
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
"ANTHROPIC_BASE_URL": "你的AIOneGate地址",
"CLAUDE_CODE_MAX_OUTPUT_TOKENS": "64000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
},
"permissions": { "allow": [], "deny": [] },
"alwaysThinkingEnabled": false
}
3. 配置 .claude.json
{ "hasCompletedOnboarding": true }
基本使用方法
在項目目錄中執行 claude 即可啟動,然後用自然語言描述你要做的事情。
cd your-project claude # 然後輸入指令,例如: # "幫我重構 utils.ts,把所有工具函數拆分到獨立文件"
常用命令參考
| 命令 | 說明 |
|---|---|
/help | 顯示所有可用命令 |
/clear | 清除當前對話上下文 |
/compact | 壓縮上下文以節省 token |
/config | 查看或修改配置 |
/cost | 查看本次會話的 token 用量 |
/exit | 退出 Claude Code |
MCP 協議
Claude Code 支持 MCP,可在項目根目錄創建 .mcp.json 擴展工具能力:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/project"]
}
}
}
高級技巧
在項目根目錄創建 CLAUDE.md,為 Claude Code 提供項目上下文和指令:
# CLAUDE.md ## 項目說明 這是一個 React + TypeScript 項目。 ## 編碼規範 - 使用 ESLint + Prettier - 組件使用函數式寫法 - 狀態管理使用 Zustand ## 禁止事項 - 不要修改 config/ 目錄下的文件 - 不要直接操作數據庫
VS Code 插件
在 VS Code 擴展市場搜索 Claude Code 安裝,可在 IDE 內直接使用,無需切換終端。
使用心得 & 常見問題
Bash(write) 即可。參考連結
Roo Code 完整教程
什麼是 Roo Code?
Roo Code 是一款強大的 VS Code AI 編碼插件,支持多種 AI 模型,深度整合在編輯器側邊欄中。
安裝插件
在 VS Code 擴展市場搜索 Roo Code 並點擊安裝,安裝完成後在側邊欄會出現 Roo Code 圖標。
API 配置
點擊 Roo Code 側邊欄,進入設置,按以下步驟配置:
- API Provider 選擇 Anthropic
- 填入 AIOneGate API Key(sk- 開頭)
- 分組選 cc5 或 cc7
- 勾選 Use custom base URL,填入 AIOneGate 地址
API Provider: Anthropic API Key: sk-your-api-key Use custom base URL: ✅ 勾選 Base URL: 你的AIOneGate地址 Model: claude-opus-4-6 Send as Anthropic header: ❌ 不勾選 Enable 1M context: ❌ 不勾選
基本使用方法
打開側邊欄 Roo Code 面板,用自然語言描述需求。選中代碼後右鍵可使用 Roo Code 操作。
使用技巧 & 常見問題
OpenCode 完整教程
什麼是 OpenCode?
OpenCode 是完全開源的終端 AI 編碼助手,支持多模型切換,提供交互式終端界面並整合 LSP。
安裝方式
方式一:安裝腳本
curl -fsSL https://opencode.ai/install | bash
方式二:npm
npm i -g opencode-ai@latest
方式三:Homebrew(macOS)
brew install opencode
API 配置
Step 1:註冊服務商
opencode auth login # → 選擇 other # → 輸入 Provider ID: aionegate # → 輸入 AIOneGate 的 API Key
Step 2:編輯配置文件
編輯 ~/.config/opencode/opencode.json,添加 AIOneGate 提供商配置。
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"aionegate": {
"npm": "@ai-sdk/anthropic",
"name": "AIOneGate",
"options": { "baseURL": "你的AIOneGate地址/v1" },
"models": {
"claude-opus-4-6": { "name": "claude opus 4.6" },
"claude-sonnet-4-5": { "name": "claude-sonnet-4-5" }
}
}
}
}
Step 3:獲取 API Token
訪問 AIOneGate 控制台,在令牌管理頁面創建新令牌。
基本使用方法
在項目目錄執行 opencode,/models 切換模型,自然語言描述任務。
cd your-project opencode # 輸入 /models 選擇模型 # 然後描述任務: # "分析這個項目的代碼結構並生成文檔"
使用技巧 & 常見問題
~/.config/opencode/opencode.json;Windows: %APPDATA%\opencode\opencode.jsonCodeX 完整教程
什麼是 CodeX?
CodeX 是 OpenAI 推出的 AI 編碼助手,由 GPT-5.3 驅動,支持終端和 IDE 插件兩種形態。
安裝方式
CLI 版(終端)
npm install -g @openai/codex
VS Code / Cursor 插件版
在 VS Code 或 Cursor 擴展市場搜索 CodeX 並安裝。
一鍵配置(cc-switch)
推薦使用 cc-switch 工具完成所有配置。
- 訪問 cc-switch
- 在 AIOneGate 控制台獲取 API Key(/console/token)
- 在 cc-switch 中填入 API Key 和 AIOneGate 地址
基本使用方法
重啟終端後執行 codex,在對話中描述需求。
codex # 示例: # "用 TypeScript 寫一個 REST API 服務器" # "幫我優化這段排序算法"
常用命令
| 命令 | 說明 |
|---|---|
codex | 啟動交互式對話 |
codex "描述任務" | 直接執行單次任務 |
codex --help | 查看幫助信息 |
codex --model gpt-5.3-codex | 指定使用的模型 |
OpenClaw 完整教程
什麼是 OpenClaw?
OpenClaw 是一款終端 AI 編碼工具,提供 Web UI 界面,支持多模型和插件系統,高度可配置。
安裝步驟
node --versionnpm install -g openclaw@latest
配置說明
Step 1:初始化
openclaw onboard --install-daemon
Step 2:配置向導選項
- Onboarding mode:選第一個選項
- Model/auth provider:選 Custom Provider
- API Base URL:你的AIOneGate地址/v1
- Endpoint compatibility:Anthropic-compatible
- Model ID:claude-opus-4-6-thinking
Step 3:獲取 API Key
訪問 AIOneGate 控制台,使用 cc7 或 cc5 分組創建令牌。
Step 4:優化配置文件
編輯 ~/.openclaw/openclaw.json:
{
"models": {
"providers": {
"custom-aionegate": {
"baseUrl": "你的AIOneGate地址",
"apiKey": "sk-your-api-key",
"api": "anthropic-messages",
"models": [{
"id": "claude-opus-4-6-thinking",
"contextWindow": 200000,
"maxTokens": 8192
}]
}
}
}
}
基本使用
配置完成後執行 openclaw 啟動,瀏覽器自動打開 Web UI,描述任務即可。
openclaw # 瀏覽器將自動打開 Web UI # 在對話框中描述你的任務
Cherry Studio 完整教程
什麼是 Cherry Studio?
Cherry Studio 是一款跨平台桌面 AI 對話應用,支持多模型切換,圖形化配置,適合非開發者使用。
下載安裝
訪問官網下載:https://www.cherry-ai.com/download
API 配置
Step 1:獲取 API Key
訪問 AIOneGate 控制台,在令牌管理頁面創建令牌。
Step 2:配置 Claude 模型
使用 cc7 分組令牌,填入 API 地址和 Key。
Step 3:配置 GPT 模型
使用 gpt 分組令牌,填入對應 API 地址和 Key。
Step 4:設置端點類型
端點類型選擇 OpenAI-Response。
API 地址: 你的AIOneGate地址 API Key: sk-your-api-key 端點類型: OpenAI-Response
基本使用方法
打開 Cherry Studio,選擇服務商,新建對話,描述需求。支持 Markdown 渲染和代碼高亮。