Claude Code - Poixe Docs

前言

Claude Code 是一个运行在你终端里的智能编程工具，能够理解你的代码库，通过自然语言指令帮你更快写代码：它可以执行日常重复任务、解释复杂代码，并处理 Git 工作流等操作。本节将在几分钟内让您使用 AI 驱动的编码辅助。完成后，您将了解如何使用 Claude Code 完成常见的开发任务。

Claude Code 官方文档

waiting for content

Claude Code Github 仓库

waiting for content

准备工作

确保您拥有：

打开的终端或命令提示符
一个要处理的代码项目
一个支持 Anthropic Messages 协议的 API 令牌（如何创建令牌）

确保您的终端环境支持：

# node.js
node -v

# git
git --version

配置环境变量：

macOS, Linux, WSL
Windows

# manual setup for temporary use
export ANTHROPIC_BASE_URL=https://api.poixe.com
export ANTHROPIC_API_KEY=$POIXE_API_KEY
export ANTHROPIC_MODEL=claude-3-5-haiku-20241022

# add to shell profile for persistent use (add to ~/.bashrc, ~/.zshrc, etc.)
echo 'export ANTHROPIC_BASE_URL="https://api.poixe.com"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="$POIXE_API_KEY"' >> ~/.bashrc
echo 'export ANTHROPIC_MODEL="claude-3-5-haiku-20241022"' >> ~/.bashrc

setx ANTHROPIC_BASE_URL "https://api.poixe.com"
setx ANTHROPIC_API_KEY "$POIXE_API_KEY"
setx ANTHROPIC_MODEL "claude-3-5-haiku-20241022"

安装 Claude Code

要安装 Claude Code，请使用以下任一方法：

Native Install (Recommended)
Homebrew
WinGet
NPM installation (Deprecated)

macOS, Linux, WSL:

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

Windows PowerShell:

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

Windows CMD:

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

brew install --cask claude-code

winget install Anthropic.ClaudeCode

# Use this method only if you can’t use the native installer.
# Avoid running it with sudo.
npm install -g @anthropic-ai/claude-code

验证安装

安装完成后，您可以通过运行以下命令来验证安装是否成功：

claude --version

启动您的第一个会话

在任何项目目录中打开您的终端并启动 Claude Code：

cd /path/to/your/project
claude

您将看到 Claude Code 欢迎屏幕，其中包含您的会话信息、最近的对话和最新更新。输入 /help 查看可用命令或输入 /resume 继续之前的对话。

提出您的第一个问题

让我们从了解您的代码库开始。尝试以下命令之一：

> what does this project do?

基本命令

以下是日常使用中最重要的命令：

命令	功能	示例
`claude`	启动交互模式	`claude`
`claude "task"`	运行一次性任务	`claude "fix the build error"`
`claude -p "query"`	运行一次性查询，然后退出	`claude -p "explain this function"`
`claude -c`	在当前目录中继续最近的对话	`claude -c`
`claude -r`	恢复之前的对话	`claude -r`
`claude commit`	创建 Git 提交	`claude commit`
`/clear`	清除对话历史	`> /clear`
`/help`	显示可用命令	`> /help`
`exit` 或 Ctrl+C	退出 Claude Code	`> exit`

有关完整的命令列表，请参阅 CLI 参考。

初学者专业提示

对您的请求要具体

不要这样说：“fix the bug”尝试这样说：“fix the login bug where users see a blank screen after entering wrong credentials”

使用分步说明

将复杂任务分解为步骤：

> 1. create a new database table for user profiles

> 2. create an API endpoint to get and update user profiles

> 3. build a webpage that allows users to see and edit their information

让 Claude 先探索

在进行更改之前，让 Claude 了解您的代码：

> analyze the database schema

> build a dashboard showing products that are most frequently returned by our UK customers

使用快捷方式节省时间

按 ? 查看所有可用的键盘快捷方式
使用 Tab 进行命令补全
按 ↑ 查看命令历史
输入 / 查看所有斜杠命令

常见问题解答

出现 Invalid API Key · Please run /login 报错？

为什么显示 offline 状态？

Claude Code 通过连接 Google 来判断网络状态。显示 “offline” 不影响正常使用，只是表明无法连接到 Google。

为什么浏览网页的 Fetch 会失败？

Claude Code 在访问网页前需要调用 Claude 服务进行安全检查。您需要：

保持稳定的国际互联网连接
必要时使用全局代理

API 报错如何处理？

如果遇到 API 报错：

确认 ANTHROPIC_API_KEY 和 ANTHROPIC_BASE_URL 设置正确
检查网络连接，确保可以访问 API 端点
查看报错信息，参考错误处理进行排查
如有需要，联系团队获取帮助

如何退出 Claude Code？

在交互模式下，输入 exit 或按两次 Ctrl+C 即可退出 Claude Code。

如何更新 Claude Code？

一行命令搞定：claude update

使用场景

对话

编程

​前言

Claude Code 官方文档

Claude Code Github 仓库

​准备工作

​安装 Claude Code

​验证安装

​启动您的第一个会话

​提出您的第一个问题

​基本命令

​初学者专业提示

​常见问题解答

前言