Claude Code 使用指南：从官方配置到接入第三方模型

通过 NPM 或脚本快速安装 Claude Code，配置 DeepSeek、智谱 GLM 等第三方模型降低使用成本，以及使用 Claude Code Router (CCR) 构建智能路由系统。文章详细讲解了多 Provider 管理、动态路由策略、请求转换、成本优化等关键技术点，并提供完整的配置示例和架构设计。

创建时间

2025-10-10

更新时间

2026-01-06

字数

3837

阅读时间

19 分钟

一、Claude Code 是什么?

Claude Code 是 Anthropic 推出的终端 AI 编码助手,核心理念是"住在终端里"。它能理解项目结构、编辑代码、执行命令、管理 Git,虽然支持 IDE 集成,但本质是命令行驱动的工具。

开源版本的替代品(OpenCode)您可以参考这篇文章: https://www.kevnu.com/zh/posts/opencode-in-depth-technical-analysis-of-open-source-ai-programming-agents

关于 Claude Agent Skills 您可以参考这篇文章: https://www.kevnu.com/zh/posts/claude-agent-skills-deep-dive-a-new-paradigm-for-expanding-ai-agent-capabilities

二、安装与配置

2.1 安装方式

NPM 安装(推荐 Node.js 用户)

bash

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

原生安装脚本

macOS / Linux / WSL:

bash

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

powershell

irm https://claude.ai/install.ps1 | iex

Windows CMD:

cmd

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

验证安装

bash

claude --version
# 或直接运行
claude

看到版本信息或进入交互提示符,说明安装成功。

2.2 登录与授权

首次运行 claude 会提示登录,支持两种方式:

个人用户:使用 Claude.ai 账户交互式登录
企业/API 用户:使用 Anthropic API Key 授权

凭据保存在 ~/.config/claude,后续可通过 /login 命令重新登录或切换账户。

2.3 基础使用

进入项目目录并启动:

bash

cd /path/to/your/project
claude

{ "APIKEY": "your-secret-key", "PROXY_URL": "http://127.0.0.1:7890", "LOG": true, "API_TIMEOUT_MS": 600000, "NON_INTERACTIVE_MODE": false, "Providers": [ { "name": "openrouter", "api_base_url": "https://openrouter.ai/api/v1/chat/completions", "api_key": "sk-xxx", "models": [ "google/gemini-2.5-pro-preview", "anthropic/claude-sonnet-4", "anthropic/claude-3.5-sonnet", "anthropic/claude-3.7-sonnet:thinking" ], "transformer": { "use": ["openrouter"] } }, { "name": "deepseek", "api_base_url": "https://api.deepseek.com/chat/completions", "api_key": "sk-xxx", "models": ["deepseek-chat", "deepseek-reasoner"], "transformer": { "use": ["deepseek"], "deepseek-chat": { "use": ["tooluse"] } } }, { "name": "ollama", "api_base_url": "http://localhost:11434/v1/chat/completions", "api_key": "ollama", "models": ["qwen2.5-coder:latest"] }, { "name": "gemini", "api_base_url": "https://generativelanguage.googleapis.com/v1beta/models/", "api_key": "sk-xxx", "models": ["gemini-2.5-flash", "gemini-2.5-pro"], "transformer": { "use": ["gemini"] } }, { "name": "volcengine", "api_base_url": "https://ark.cn-beijing.volces.com/api/v3/chat/completions", "api_key": "sk-xxx", "models": ["deepseek-v3-250324", "deepseek-r1-250528"], "transformer": { "use": ["deepseek"] } }, { "name": "modelscope", "api_base_url": "https://api-inference.modelscope.cn/v1/chat/completions", "api_key": "", "models": [ "Qwen/Qwen3-Coder-480B-A35B-Instruct", "Qwen/Qwen3-235B-A22B-Thinking-2507" ], "transformer": { "use": [["maxtoken", { "max_tokens": 65536 }], "enhancetool"], "Qwen/Qwen3-235B-A22B-Thinking-2507": { "use": ["reasoning"] } } }, { "name": "dashscope", "api_base_url": "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions", "api_key": "", "models": ["qwen3-coder-plus"], "transformer": { "use": [["maxtoken", { "max_tokens": 65536 }], "enhancetool"] } }, { "name": "aihubmix", "api_base_url": "https://aihubmix.com/v1/chat/completions", "api_key": "sk-", "models": ["Z/glm-4.5", "claude-opus-4-20250514", "gemini-2.5-pro"] } ], "Router": { "default": "deepseek,deepseek-chat", "background": "ollama,qwen2.5-coder:latest", "think": "deepseek,deepseek-reasoner", "longContext": "openrouter,google/gemini-2.5-pro-preview", "longContextThreshold": 60000, "webSearch": "gemini,gemini-2.5-flash" } }

特性	Claude Code Router (CCR)	CC-Switch
类型	命令行工具	桌面应用
界面	CLI + Web UI	基于 Tauri 的 GUI
适用场景	服务器、自动化、CI/CD	本地开发、可视化管理
模型路由	✅ 高级路由策略	❌ 简单切换
配置管理	JSON 配置文件	可视化界面 + SQLite
MCP 管理	❌	✅ 跨应用统一管理
Skills 管理	❌	✅ GitHub 仓库扫描
Prompts 管理	❌	✅ 多预设 + Markdown 编辑器
速度测试	❌	✅ API 延迟测试
系统托盘	❌	✅ 快速切换
云同步	❌	✅ (v3.8.0 架构支持)
学习曲线	中等(需要配置 JSON)	低(可视化操作)

Claude Code 使用指南：从官方配置到接入第三方模型

一、Claude Code 是什么?

二、安装与配置

2.1 安装方式

2.2 登录与授权

2.3 基础使用

三、Slash 命令

内置命令(常用)

自定义命令(要点)

SlashCommand 工具行为与权限

工程实践建议

Skills vs Slash commands

四、为什么需要第三方模型?

五、快速接入:兼容模型直连

5.1 DeepSeek 集成

5.2 智谱 GLM 集成

5.3 注意事项

六、进阶方案:智能路由与切换工具

6.1 Claude Code Router (CCR)

安装

配置

运行

应用场景

优势与注意事项

6.2 CC-Switch

核心功能

安装

快速开始

技术架构

6.3 CCR vs CC-Switch 对比

七、系统架构

八、参考资源

评论(0)

评论(0)