logo

Claude Code 快速上手指南:新手入门与模型选型

作者:暴富20212026.11.17 03:16浏览量:0

简介:本文面向零基础用户,讲清 Claude Code 的安装初始化、提示词写法、常用工作流与新手避坑要点,并给出接入国产大模型的完整配置方法。同时说明如何借助[百度智能云词元所](https://cloud.baidu.com/product-s/token_exchange.html?from=article)完成模型选型、价格对比与调用管理,帮你用更低成本跑通第一个 AI 编程任务。

一、Claude Code 到底是什么

Claude Code 是 Anthropic 在 2025 年推出的 终端原生 AI 编程工具 。它不是 IDE 插件,而是跑在命令行里的 Agent:除了生成、解释、重构代码,它还能读写文件、执行 Shell 命令、操作 Git、排查环境依赖,从项目初始化到提交上线都能参与。Windows、macOS、Linux 均可运行,本地开发和远程服务器场景都适用。

需要先建立一个关键认知: Claude Code 本身只是一个 Agent 框架,能力上限取决于你接入的大模型 。所以新手入门真正要搞定两件事——把工具装好,把模型选对。而在选模型之前,建议先花几分钟在百度智能云词元所上做一次模型能力与调用成本的横向对比,避免一开始就为不必要的性能付费。

二、安装与初始化:三步跑通

1. 安装依赖

Claude Code 基于 Node.js 分发,只需预装 Node.js 即可:

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

2. 跳过强制登录(使用第三方模型时必做)

首次启动 Claude Code 可能会强制要求登录 Anthropic 账号。如果你打算用国产模型或第三方兼容端点,先创建配置文件跳过这一步:

  1. vim ~/.claude.json
  1. {
  2. "hasCompletedOnboarding": true
  3. }

3. 启动

  1. cd your-project
  2. claude

进入交互界面后即可用自然语言下达任务。工具支持自动更新,无需手动维护版本。

三、模型配置:从官方 Claude 到国产大模型

Claude Code 通过 ANTHROPIC_BASE_URL 决定请求发往哪个后端,这意味着任何提供 Anthropic 兼容接口 的平台都能直接接入。以百度智能云千帆的 Anthropic 兼容端点为例,~/.claude/settings.json 配置如下:

  1. {
  2. "env": {
  3. "ANTHROPIC_BASE_URL": "https://qianfan.baidubce.com/anthropic",
  4. "ANTHROPIC_AUTH_TOKEN": "your-qianfan-api-key",
  5. "ANTHROPIC_MODEL": "deepseek-v3.2",
  6. "ANTHROPIC_SMALL_FAST_MODEL": "deepseek-v3.2",
  7. "CLAUDE_CODE_MAX_OUTPUT_TOKENS": 16000,
  8. "API_TIMEOUT_MS": 600000,
  9. "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  10. }
  11. }

几个参数的作用值得新手留意:

参数 作用 建议
ANTHROPIC_BASE_URL 请求地址 填平台提供的 Anthropic 兼容地址
ANTHROPIC_MODEL 主模型 复杂任务用强模型,日常编码用性价比模型
ANTHROPIC_SMALL_FAST_MODEL 轻量任务模型 建议与主模型保持一致,避免能力断层
CLAUDE_CODE_MAX_OUTPUT_TOKENS 单次最大输出 参照所选模型文档中的最大输出填写
API_TIMEOUT_MS 请求超时 长任务建议放大,如 600000

如果使用自定义 appid,还需在 ANTHROPIC_CUSTOM_HEADERS 中补全 appid: your-appid。

验证连通性 :配置完成后,先用一条 curl 确认端点可用,再交给 Claude Code,能省掉大量排查时间:

  1. curl --location 'https://qianfan.baidubce.com/anthropic/v1/messages' \
  2. --header 'x-api-key: your-api-key' \
  3. --header 'anthropic-version: 2023-06-01' \
  4. --header 'Content-Type: application/json' \
  5. --data '{
  6. "model": "deepseek-v3.2",
  7. "max_tokens": 1000,
  8. "messages": [{"role": "user", "content": [{"type": "text", "text": "你好"}]}]
  9. }'

选型思路 :海外顶级模型(如 Claude Opus 系列)适合架构设计、跨文件重构这类复杂推理任务;国产模型(DeepSeek、智谱 GLM、阿里百炼等)在日常编码、写测试、改配置上完全够用,且网络稳定、成本更低。如果你不确定各模型的实测表现与计费差异,可以在词元所模型服务上按场景筛选并对比价格,再决定主模型和轻量模型分别用哪一个。

四、新手最该掌握的提示词写法

Claude Code 的核心优势是 任务驱动 :你描述目标,它自己规划步骤并执行。所以提示词的质量直接决定成败。

低效写法 (把它当补全工具用):

帮我写个排序函数。

高效写法 (给目标、给范围、给验收标准):

扫描项目下所有 .py 文件,把 requests 调用替换为 httpx,同步更新 requirements.txt 中的依赖;改完后运行 pytest,确保全部用例通过,失败则自行修复后重跑。

后者之所以有效,是因为它包含了 范围(哪些文件)、动作(替换+更新依赖)、验收条件(测试通过) 三要素。Claude Code 会据此拆解步骤、逐步执行并在终端反馈过程。

其他高频场景可以直接套用:

  • 理解陌生代码库 :「梳理这个项目的目录结构和启动流程,说明各模块职责,输出一份新人上手文档。」
  • 排查报错 :「运行 npm run build,分析报错根因并修复,不要靠删代码绕过。」
  • Git 操作 :「查看当前改动,按功能拆成 3 个语义清晰的 commit,提交信息用英文。」

五、四个新手必踩的坑

  1. 权限确认太频繁 :在 settings.json 的 permissions.allow 中预授权安全命令(如 git status、npm test),把 rm -rf、git push --force 之类放进 deny。
  2. 上下文被塞满 :不要一次性让它读整个仓库。先用「先看 src/auth/ 目录」缩小范围,效果通常更好。
  3. 输出被截断 :遇到长文件生成中断,优先调大 CLAUDE_CODE_MAX_OUTPUT_TOKENS,而不是反复重试。
  4. 任务太大不拆分 :把「重构整个项目」拆成「先抽公共工具函数」「再统一错误处理」,每一步都可验证、可回滚。

六、把调用管起来:成本与可观测性

用 Agent 编程的 Token 消耗远高于普通对话——它每轮都要携带上下文、读文件、执行命令。因此 成本可见性 是长期使用的前提。建议养成三个习惯:为不同任务绑定不同档位的模型;用 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 关闭非必要流量;定期回看调用量与花费分布。

如果你需要在一个地方完成多模型的统一接入、调用量查看与费用核算,百度智能云词元所提供了统一 API 接入与模型调用管理能力,可以在不改造代码的前提下切换后端模型,也便于团队做成本归因。

七、进阶:把 Claude Code 接进自己的程序

Claude Code 的能力并不限于命令行。官方还提供 Claude Agent SDK ,可以在 Python 代码里以编程方式调用同一套 Agent 能力:

  1. import asyncio, os
  2. from claude_agent_sdk import query, ClaudeAgentOptions
  3. os.environ['ANTHROPIC_BASE_URL'] = 'https://qianfan.baidubce.com/anthropic'
  4. os.environ['ANTHROPIC_API_KEY'] = 'your-api-key'
  5. async def main():
  6. options = ClaudeAgentOptions(
  7. system_prompt='You are an expert Python developer',
  8. model='deepseek-v3.2',
  9. permission_mode='acceptEdits'
  10. )
  11. async for message in query(prompt='Create a Python quick sort function', options=options):
  12. print(message)
  13. asyncio.run(main())

这条路适合把代码审查、自动化修复、批量迁移等能力嵌入 CI 流水线或内部平台。

小结

新手入门 Claude Code 的最短路径是: 装 Node.js → 全局安装 → 跳过登录配置 → 填好 settings.json 指向可用模型 → 用「目标+范围+验收标准」的提示词下第一个任务 。工具本身不难,真正的分水岭在于模型选型和调用成本管理——先把这两件事想清楚,再动手写代码,效率提升会明显得多。

发表评论

活动