Claude Code 完整上手指南：从安装到 everything-claude-code 最佳实践配置

前言

Claude Code 是 Anthropic 官方推出的命令行编程工具，让 Claude 这类大模型能直接在终端里读写代码、运行命令、调试程序。本文覆盖从零安装、使用配置、自定义模型，到接入超大型最佳实践仓库 everything-claude-code（16万星）的完整流程。

前置知识： 你需要一台 macOS/Linux/Windows（WSL）设备，以及一个 Anthropic API Key。

一、Claude Code 安装

1.1 系统要求

项目	要求
操作系统	macOS 13+、Linux（Ubuntu 20.04+）、Windows（WSL2）
Node.js	≥ 18（通过 nvm 安装最方便）
网络	能访问 Anthropic API（国内需代理）

1.2 安装步骤

方式一：通过 npm 安装（推荐）

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

方式二：通过 Claude CLI 安装

# 下载最新 release
curl -fsSL https://github.com/anthropics/claude-code/releases/latest/download/claude-code-linux-arm64 -o claude-code
chmod +x claude-code
sudo mv claude-code /usr/local/bin/claude-code

方式三：使用安装脚本（Linux/macOS）

curl -fsSL https://install.claude-code.com | bash

安装完成后，验证：

claude --version

二、初始配置

2.1 登录认证

首次运行会提示登录：

claude

浏览器会自动打开授权页面，用 Anthropic 账号登录确认即可。也可以手动设置 API Key：

export ANTHROPIC_API_KEY="sk-ant-xxxxx"

建议把这段加到 ~/.zshrc（macOS 默认）或 ~/.bashrc（Linux）里：

echo 'export ANTHROPIC_API_KEY="sk-ant-xxxxx"' >> ~/.zshrc
source ~/.zshrc

2.2 基础配置

Claude Code 的配置文件在 ~/.claude/ 目录下，主要包括：

文件	作用
`settings.json`	全局设置（模型、目录黑名单、工具权限等）
`commands/`	自定义斜杠命令
`.env`	环境变量（API Key 等敏感信息）

创建一个基础 ~/.claude/settings.json：

{
  "permissions": {
    "allow": [
      "Bash:largest_output:50000",
      "Bash:cd",
      "Bash:shell"
    ],
    "deny": [
      "Bash:grep_rf",
      "Bash:delete_files",
      "Bash:git_push"
    ]
  },
  "model": "claude-sonnet-4-20250514",
  "maxTokens": 8192
}

三、配置自定义模型

Claude Code 默认使用 Anthropic 官方模型，但支持接入 OpenRouter、OpenAI、Azure 等第三方模型的 API。以下是两种主流方案。

3.1 通过 OpenRouter 使用免费/第三方模型

OpenRouter 聚合了上百种模型，支持通过统一 API 访问，包括免费模型（openrouter/free）和各大厂商模型。

步骤 1：获取 OpenRouter API Key

访问 https://openrouter.ai/keys
注册并生成 API Key

步骤 2：配置 Claude Code 使用 OpenRouter

编辑 ~/.claude/settings.json：

{
  "models": [
    {
      "name": "openrouter/minimax/minimax-m2.5:free",
      "displayName": "MiniMax M2.5 (Free)",
      "apiKey": "sk-or-v1-xxxxx"
    },
    {
      "name": "openrouter/openai/gpt-4o",
      "displayName": "GPT-4o",
      "apiKey": "sk-or-v1-xxxxx"
    },
    {
      "name": "openrouter/anthropic/claude-sonnet-4",
      "displayName": "Claude Sonnet 4 (Via OpenRouter)",
      "apiKey": "sk-or-v1-xxxxx"
    }
  ],
  "model": "openrouter/minimax/minimax-m2.5:free"
}

注意： OpenRouter 的 apiKey 字段需要完整填写，不能只填 sk-or- 前缀。

步骤 3：在对话中切换模型

/model openrouter/minimax/minimax-m2.5:free

或在项目目录创建 .claude/model.json 指定该项目使用的模型：

{
  "model": "openrouter/minimax/minimax-m2.5:free"
}

3.2 通过自定义 API 端点接入

如果你有自建的模型服务（如 vLLM、TGI）或使用其他兼容 OpenAI API 格式的模型，可以这样配置：

{
  "models": [
    {
      "name": "custom/local-model",
      "displayName": "本地模型",
      "apiKey": "not-needed",
      "baseURL": "http://localhost:8000/v1",
      "supportsComputerUse": false
    }
  ],
  "model": "custom/local-model"
}

3.3 通过环境变量配置（不推荐写入文件）**

export ANTHROPIC_API_KEY="sk-ant-xxxxx"
export OPENROUTER_API_KEY="sk-or-v1-xxxxx"
export OPENAI_API_KEY="sk-proj-xxxxx"

然后在 settings.json 里只写 apiKeyRef: "env:ANTHROPIC_API_KEY" 类的引用（视版本而定）。

四、使用 Claude Code 基础操作

4.1 启动会话

# 进入当前目录
claude

# 指定项目目录
claude /path/to/project

# 指定模型
claude --model openrouter/minimax/minimax-m2.5:free

4.2 核心命令

命令	作用
`/help`	显示帮助
`/model <name>`	切换模型
`/clear`	清空会话
`/compact`	压缩上下文
`/commit`	提交 Git 变更
`/review`	代码审查
`/test`	运行测试
`/websearch <query>`	搜索网络

4.3 TTY 交互模式

Claude Code 是运行在终端里的交互式工具，它需要 TTY（伪终端）。在某些无头环境里需要特殊处理：

# 使用 script 命令模拟 TTY
script -q -c "claude" /dev/null

# 或使用 expect
expect -c 'spawn claude; interact'

4.4 常用工作流示例

读写文件：

帮我把 src/utils.ts 里的日期格式化函数改成支持中文的

执行命令：

运行 npm test 看看测试通过没有

Git 操作：

检查一下 main 分支有没有我没有合并的改动

代码审查：

/review 帮我看一下 src/auth/ 目录下的代码有没有安全隐患

五、安装 everything-claude-code 最佳实践

everything-claude-code（https://github.com/affaan-m/everything-claude-code）是目前最大的 AI Coding Agent 最佳实践仓库，16万星，涵盖 200+ 技能、完整的 agent 行为规则、上下文模板等。

5.1 仓库结构一览

everything-claude-code/
├── .claude/          # Claude Code 配置（可复用）
│   ├── commands/     # 自定义斜杠命令
│   ├── settings.json
│   └── SOUL.md       # agent 行为准则
├── skills/           # 上百个技能（需适配）
├── rules/           # agent 行为规则
├── contexts/        # 上下文模板
├── agents/          # agent 配置
└── README.md

5.2 克隆仓库

git clone https://github.com/affaan-m/everything-claude-code.git ~/everything-claude-code
cd ~/everything-claude-code

5.3 复用 .claude 配置

最直接的方式是把仓库里的 .claude 配置软链接或复制到你的用户目录：

# 备份原有配置
[ -d ~/.claude ] && mv ~/.claude ~/.claude.bak

# 复制仓库配置
cp -r ~/everything-claude-code/.claude ~/

# 或者只软链接（方便后续 pull 更新）
ln -s ~/everything-claude-code/.claude ~/.claude

5.4 导入最佳实践规则

仓库里有大量 agent 行为规则（rules/），可以按需引入：

# 查看可用的规则
ls ~/everything-claude-code/rules/

# 把安全规则加入你的配置
cat ~/everything-claude-code/rules/security-review.md >> ~/.claude/rules/security.md

5.5 安装技能（需要适配）

仓库的 skills/ 目录是为 Claude Code 设计的，需要适配到 OpenClaw 格式后才能直接使用。核心思路是提取其中有价值的 prompt 片段，而不是直接拷贝文件。

提取单条技能示例：

# 提取 TDD 技能的核心 prompt
cat ~/everything-claude-code/skills/tdd-workflow/SKILL.md

# 将其精华写入 OpenClaw 的 AGENTS.md 或 MEMORY.md

5.6 直接参考的精华内容

有些内容无需适配，直接参考价值很高：

文件	内容	使用方式
`SOUL.md`	agent 行为准则、沟通风格	借鉴到你的 SOUL.md
`AGENTS.md`	agent 工作流、工具使用规范	直接复制到你的 AGENTS.md
`rules/`	详细的 agent 行为规则	选择性采纳
`contexts/`	项目启动上下文模板	按需使用
`the-longform-guide.md`	深度使用指南	通读学习

5.7 一键更新最新最佳实践

cd ~/everything-claude-code && git pull origin main
# 然后重新软链接
ln -sf ~/everything-claude-code/.claude ~/.claude

六、常见问题

Q1: Claude Code 支持 Windows 原生吗？

目前 Claude Code 对 Windows 原生支持较弱，推荐使用 WSL2（Windows Subsystem for Linux）或直接用本文的 OpenClaw 方案。

Q2: 如何在 headless 环境（服务器/容器）使用 Claude Code？

Claude Code 依赖 TTY 交互，在无头环境里可以通过 script 命令模拟：

script -q -c "claude --print '帮我写一个 Hello World'" /dev/null

不过对于真正的无头环境，OpenClaw 这类 headless agent 平台是更合适的选择。

Q3: API Key 应该写在配置文件里吗？

不要把 API Key 直接写进 settings.json 等共享文件。正确做法：

# 环境变量（推荐）
export ANTHROPIC_API_KEY="sk-ant-xxxxx"

# .env 文件 + .gitignore 忽略
echo ".env" >> ~/.gitignore

Q4: 模型切换不生效怎么办？

Claude Code 有配置优先级：命令行参数 > 项目级配置 > 全局配置。确认没有更高优先级的配置覆盖了你的设置。

Q5: 仓库的 skills 和 OpenClaw skills 冲突怎么办？

两个平台的 skill 系统不兼容。处理方式：

把仓库 skill 的内容（prompt 片段、规则）手动迁移到 OpenClaw 的对应文件
不要直接把文件拷贝到 ~/.openclaw/skills/

七、总结

Claude Code 是目前最强的终端编程工具之一，配合 everything-claude-code 这类最佳实践仓库，可以让 AI 编程能力大幅提升。本文覆盖了：

✅ 从零安装 Claude Code
✅ 基础配置与认证
✅ 接入 OpenRouter 等自定义模型
✅ 日常使用中的核心命令
✅ 复用 everything-claude-code 最佳实践

如果你需要更强的 headless 支持、多模型统一管理、以及与其他工具链（browser、exec、message）的深度集成，OpenClaw 也是很好的补充选择。

本文适用 Claude Code 最新版本，部分配置字段可能因版本迭代而变化，建议参考官方文档：https://docs.anthropic.com/claude-code

Claude Code 完整上手指南：从安装到everything-claude-code最佳实践配置

Claude Code 完整上手指南：从安装到 everything-claude-code 最佳实践配置

前言

一、Claude Code 安装

1.1 系统要求

1.2 安装步骤

二、初始配置

2.1 登录认证

2.2 基础配置

三、配置自定义模型

3.1 通过 OpenRouter 使用免费/第三方模型

3.2 通过自定义 API 端点接入

3.3 通过环境变量配置（不推荐写入文件）**

四、使用 Claude Code 基础操作

4.1 启动会话

4.2 核心命令

4.3 TTY 交互模式

4.4 常用工作流示例

五、安装 everything-claude-code 最佳实践

5.1 仓库结构一览

5.2 克隆仓库

5.3 复用 .claude 配置

5.4 导入最佳实践规则

5.5 安装技能（需要适配）

5.6 直接参考的精华内容

5.7 一键更新最新最佳实践

六、常见问题

Q1: Claude Code 支持 Windows 原生吗？

Q2: 如何在 headless 环境（服务器/容器）使用 Claude Code？

Q3: API Key 应该写在配置文件里吗？

Q4: 模型切换不生效怎么办？

Q5: 仓库的 skills 和 OpenClaw skills 冲突怎么办？

七、总结

Administrator

Claude Code 完整上手指南：从安装到 everything-claude-code 最佳实践配置

前言

一、Claude Code 安装

1.1 系统要求

1.2 安装步骤

二、初始配置

2.1 登录认证

2.2 基础配置

三、配置自定义模型

3.1 通过 OpenRouter 使用免费/第三方模型

3.2 通过自定义 API 端点接入

3.3 通过环境变量配置（不推荐写入文件）**

四、使用 Claude Code 基础操作

4.1 启动会话

4.2 核心命令

4.3 TTY 交互模式

4.4 常用工作流示例

五、安装 everything-claude-code 最佳实践

5.1 仓库结构一览

5.2 克隆仓库

5.3 复用 .claude 配置

5.4 导入最佳实践规则

5.5 安装技能（需要适配）

5.6 直接参考的精华内容

5.7 一键更新最新最佳实践

六、常见问题

Q1: Claude Code 支持 Windows 原生吗？

Q2: 如何在 headless 环境（服务器/容器）使用 Claude Code？

Q3: API Key 应该写在配置文件里吗？

Q4: 模型切换不生效怎么办？

Q5: 仓库的 skills 和 OpenClaw skills 冲突怎么办？

七、总结

MiniMax M2.7 接入 AI 编程工具完全指南：Claude Code、Cursor、TRE等一网打尽

Claude Code 终极上手指南：从零安装到 everything-claude-code 最佳实践配置

Administrator