Claude Code

Anthropic 官方命令行 AI 编程工具。

关联 NotebookLM：https://notebooklm.google.com/notebook/017d096b-6f41-4343-b29e-0985fe953a7f (opens new window)

---

快速开始

• 安装：https://claudecn.com/docs/claude-code/quickstart/
• 官方文档：https://platform.claude.com/docs/en/intro
• Console：https://platform.claude.com/dashboard

---

基础使用

# 启动
claude

# 常用命令（在 Claude Code 内）
/status          # 查看当前状态和模型
/clear           # 清空对话
/config          # 配置设置
/help            # 帮助

---

使用非官方模型（省钱 / 本地方案）

Claude Code 默认使用 Anthropic 官方 API，但可以通过代理层切换到其他模型（Gemini、本地 Ollama 等）。

方案对比

方案	适用场景	复杂度	推荐度
claude-code-router	只用 Gemini，追求简单	低	⭐⭐⭐⭐
LiteLLM	多模型、本地 Ollama、灵活路由	中	⭐⭐⭐⭐⭐
Ollama 直接配置	仅本地模型，简单场景	低	⭐⭐⭐

方案 A：claude-code-router（最省心，Gemini 专用）

npm install -g @musistudio/claude-code-router

配置 ~/.claude-code-router/config.json：

{
  "LOG": true,
  "LOG_LEVEL": "info",
  "Providers": [
    {
      "name": "gemini",
      "api_base_url": "https://generativelanguage.googleapis.com/v1beta/models/",
      "api_key": "你的_GEMINI_API_KEY",
      "model": "gemini-2.5-flash"
    }
  ]
}

启动：

ccr start   # 启动后台代理
ccr code    # 替代 claude 命令启动客户端

进去后输入 /status 确认模型。

方案 B：LiteLLM（万能灵活，推荐）

适合多模型切换、本地 Ollama、智能路由等复杂场景。

核心配置 litellm_config.yaml：

litellm_settings:
  drop_params: true

model_list:
  - model_name: claude-3-5-sonnet
    litellm_params:
      model: gemini/gemini-2.5-flash
      api_key: "你的-GEMINI-KEY"

启动：

litellm --config litellm_config.yaml --port 4000

配置环境变量：

export ANTHROPIC_BASE_URL="http://localhost:4000"
export ANTHROPIC_API_KEY="sk-dummy-key"
claude

完整配置、多模型路由、本地 Ollama 接入等详细说明：见 LiteLLM 万能模型代理

方案 C：直接连接本地 Ollama（简单场景）

如果只用本地 Ollama 模型，也可以直接配置（不需要 LiteLLM）：

export ANTHROPIC_BASE_URL="http://localhost:11434/v1"
export ANTHROPIC_API_KEY="ollama"
export ANTHROPIC_MODEL="deepseek-r1:14b"

注意：直接连接可能存在协议兼容性问题（工具调用、参数格式等），复杂场景建议用 LiteLLM 做转换。

---

连接本地模型注意事项

模型要求

• ✅ 必须支持 function calling（工具调用）
• ✅ 建议上下文窗口 ≥ 32K（代码分析需要）
• ✅ 推荐模型：deepseek-r1:14b、qwen2.5-coder:14b

常见问题

1. 工具调用失败：确认模型支持 function calling
2. 上下文不够：Ollama 创建大上下文版本

   echo "FROM deepseek-r1:14b
   PARAMETER num_ctx 32768" > Modelfile
   ollama create deepseek-r1:14b-32k -f Modelfile
   

3. 思考过程显示：deepseek-r1 的 <think> 标签可能被显示，建议用 LiteLLM 过滤

---

相关链接

• 教程：https://claude.com/resources/tutorials
• 中文社区：https://claudecn.com/docs/claude-code
• LiteLLM 万能模型代理
• Ollama 本地大模型