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

一、Claude Code 简介

Claude Code 是 Anthropic 推出的终端智能编码代理工具，它"住在你的终端里"，能够理解项目结构、编辑代码、执行命令、管理 Git 等开发任务。虽然支持 IDE 集成，但其核心设计理念是命令行驱动。

简单来说，在任何终端环境中运行 claude 命令，就能让 AI 助手协助你编写代码、修复 bug、生成文档，甚至管理版本控制。

二、安装与配置

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 或 CLI 指定的本地存储位置。后续可通过 /login 命令重新登录或切换账户。

2.3 基础使用示例

进入项目目录并启动：

bash
cd /path/to/your/project
claude

在交互模式下，直接用自然语言描述需求：

> create utilities/logger.py with rotating file handler
> write unit tests for date parsing edge cases
> explain this function foo in module bar
> refactor module baz to async/await

Claude Code 会自动读取项目上下文，理解代码结构并执行相应操作。

三、为什么需要接入第三方模型？

虽然 Claude Code 功能强大，但直接使用官方模型存在以下挑战：

3.1 现实问题