Claude Code 配置指南

Fri, 30 Jan 2026 08:00:00 +0800

Claude Code 配置指南

Claude Code 是 Anthropic 推出的一个本地运行的 Agent 框架，可以接入 Claude 或者兼容 Claude 的第三方模型，支持工具使用和技能配置。

下面是 Ubuntu 22.04 系统 的安装配置记录：

1. 安装 Claude Code

下载安装 claude code (需要魔法，参考安装教程)，并且为了使用第三方 API 需要禁用登录。

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

vim ~/.claude.json
# 添加/修改下面内容为
# "hasCompletedOnboarding": true // 禁用登录

# 如果已经使用 claude 需要清理一下 ~/.claude.json 的备份
# rm -rf ~/.claude.json.*

2. 安装 cc-switch (可选)

cc-switch 是一个可以在 claude code 中同时管理并且切换不同的大模型 API，支持 Claude 和兼容 Claude 的第三方模型。

注意：如果只使用 Claude 官方模型可以跳过这一步

2.1 下载安装

选择对应的 CLI 版本，下面具体获取的包需要在 release 界面获取，优先获取 musl 静态编译版。

# 下载
curl -LO https://github.com/SaladDay/cc-switch-cli/releases/download/v4.5.0/cc-switch-cli-v4.5.0-linux-x64-musl.tar.gz

tar -xzf cc-switch-cli-*.tar.gz # 解压
rm cc-switch-cli-*.tar.gz # 删除压缩包
chmod +x cc-switch # 执行权限
sudo mv cc-switch /usr/local/bin/ # 放到系统路径

2.2 配置 API

参考文档 (有中文版)，输入对应的模型提供商、URL、模型 ID、接口令牌等信息。

➜  cc-switch provider list              # 列出所有供应商
No providers found.
Use 'cc-switch provider add' to create a new provider.

➜  ~ cc-switch provider add
Add New Provider
==================================================
> Provider Name: DeepSeek
> Website URL (optional): 
Generated ID: deepseek

Configure Claude Provider:
> API Key: ********************************
> Base URL: https://api.deepseek.com/anthropic
> Configure model names? Yes
> Default Model:： deepseek-chat
> Haiku Model:： deepseek-chat
> Sonnet Model:： deepseek-chat
> Opus Model:： deepseek-chat
> Configure optional fields (notes, sort index)? Yes

Optional Fields Configuration:
> Notes: 
> Sort Index: 

=== Provider Configuration Summary ===
ID: deepseek
Provider Name:: DeepSeek

Core Configuration:
  API Key: sk-0...841d
  Base URL: https://api.deepseek.com/anthropic
  Model: deepseek-chat
======================
? 
Confirm create this provider? (y/N) y 

# 再查看就有了
➜  cc-switch provider list                                     
┌───┬──────────┬──────────┬────────────────────────────────────┐
│   ┆ ID       ┆ Name     ┆ API URL                            │
╞═══╪══════════╪══════════╪════════════════════════════════════╡
│ ✓ ┆ deepseek ┆ DeepSeek ┆ https://api.deepseek.com/anthropic │
└───┴──────────┴──────────┴────────────────────────────────────┘

ℹ Application: claude
→ Current: deepseek # 当前使用的 deepseek

# 在打开 claude 就可以使用了
➜ claude

模型的 URL、ID、Token 令牌等获取参考 Copilot 配置文档。这里配置的 DeepSeek 模型，下面是加入 Claude Code 的测试结果：

3. 配置 Skills

可以在开源仓库/社区获取 Skills，如：

3.1 Skill 结构

Skill 包含如下结构，可以理解为高级提示词。参考教程: 官方文档、中文教程

skill-name/
├── SKILL.md          # Required: Skill instructions and metadata
├── scripts/          # Optional: Helper scripts
├── templates/        # Optional: Document templates
└── resources/        # Optional: Reference files

3.2 安装 Skill

把下载好的 Skill 放到下面目录就可以在 Claude Code 中使用：

1
2

mkdir -p ~/.config/claude-code/skills/
cp -r skill-name ~/.config/claude-code/skills/

下面以 write-skill 为例，右边有 install 命令：

➜  npx skills add tldraw/tldraw # 中间的命令通过方向键和空格键选中
➜  ls -lah /root/.claude/skills # 可以在 skills 目录下查找到对应的 skills
total 8.0K
drwxr-xr-x 2 root root 4.0K Feb  3 19:34 .
drwxr-xr-x 9 root root 4.0K Feb  3 19:36 ..
lrwxrwxrwx 1 root root   32 Feb  3 19:34 find-skills -> ../../.agents/skills/find-skills
lrwxrwxrwx 1 root root   32 Feb  3 19:34 review-docs -> ../../.agents/skills/review-docs
lrwxrwxrwx 1 root root   34 Feb  3 19:34 skill-creator -> ../../.agents/skills/skill-creator
lrwxrwxrwx 1 root root   41 Feb  3 19:34 update-release-notes -> ../../.agents/skills/update-release-notes
lrwxrwxrwx 1 root root   32 Feb  3 19:34 write-docs -> ../../.agents/skills/write-docs
...

3.3 测试

第一次使用会询问工具权限，如果不应该使用工具可以附上应该怎么做，例如 Fetch(https://github.com/alibaba/MNN) 这一步被取消了，理由是当前目录就在 MNN 中。

实用工具

Fri, 30 Jan 2026 08:00:00 +0800

实用工具

开发过程中用到的一些实用小工具配置记录。

文章	说明	状态
Ubuntu 环境配置	Ubuntu 系统开发环境配置记录	✅ 完成
Jetson 环境配置	NVIDIA Jetson 开发板环境配置记录	✅ 完成
Termux 环境配置	Android Termux 终端环境配置记录	✅ 完成
Python 环境配置	Python 环境管理工具介绍与配置	✅ 完成

文章	说明	状态
VSCode Copilot 配置	配置 Copilot Chat 使用本地局域网大模型 API	✅ 完成
flash.vscode 插件	在 VSCode 中快速跳转到屏幕可见的任意一行	✅ 完成

文章	说明	状态
Claude Code 配置	Anthropic 推出的本地运行 Agent 框架	✅ 完成
iFlow CLI 配置	阿里推出的终端 Agent 框架	✅ 完成

文章	说明	状态
Git 命令备忘	Git 常用命令速查	✅ 完成
Linux 常用命令备忘	Linux 日常开发常用命令速查	✅ 完成
SSH 命令备忘	SSH 密钥管理、配置文件、端口转发等	✅ 完成
Vim 常用命令备忘	Vim 日常开发常用命令速查	✅ 完成
FZF 使用备忘	命令行模糊搜索工具，提升终端效率	✅ 完成
Zoxide 使用备忘	更智能的 cd 命令，自动记忆常用目录	✅ 完成
Zsh 配置	Zsh 终端配置与优化	✅ 完成
reptyr 使用	将运行中的进程转移到新的终端	📝 TODO
Tmux 使用	终端复用器 Tmux 配置与使用	✅ 完成
Netcat 局域网传输	Netcat 网络工具在局域网文件传输中的应用	✅ 完成

模型下载工具

文章	说明	状态
HuggingFace/ModelScope 下载器	HuggingFace 和 ModelScope 模型下载工具介绍	✅ 完成

Claude Code on huluhuluu

Claude Code 配置指南

Claude Code 配置指南

1. 安装 Claude Code

2. 安装 cc-switch (可选)

2.1 下载安装

2.2 配置 API

3. 配置 Skills

3.1 Skill 结构

3.2 安装 Skill

3.3 测试

实用工具

实用工具

目录

环境配置

VSCode 相关

AI Agent 框架

终端工具

模型下载工具