Claude Code 源码分析：新手如何高效编写调用工具的提示词

1次阅读

共计 1897 个字符，预计需要花费 5 分钟才能阅读完成。

很多开发者在初次使用 Claude Code 时，常常会遇到以下问题：

提示词过于笼统，导致返回结果与预期相差甚远
多次交互才能得到想要的结果，效率低下
相同提示词在不同时间调用，得到的结果不一致

这些问题往往源于对工具内部工作机制的不了解。通过分析源码，我们可以更好地理解如何编写高效的提示词。

Claude Code 首先会将输入的提示词进行 token 化处理。关键代码段如下：

def tokenize_prompt(prompt: str) -> List[int]:
    # 将提示词分割为 token 序列
    tokens = []
    for word in prompt.split():
        tokens.extend(_get_word_tokens(word))
    return tokens[:MAX_TOKEN_LENGTH]  # 截断超长部分

这里需要注意：

单个单词可能被拆分为多个 token
总 token 长度有限制 (通常为 4096)

系统会分析 token 序列来识别用户意图：

def detect_intent(tokens: List[int]) -> Dict:
    # 提取关键动词和名词
    verbs = [t for t in tokens if t in VERB_IDS]
    nouns = [t for t in tokens if t in NOUN_IDS]

    # 判断任务类型
    if any(t in DATA_CLEANING_VERBS for t in verbs):
        return {'task_type': 'data_cleaning'}
    elif any(t in API_GEN_VERBS for t in verbs):
        return {'task_type': 'api_generation'}
    # 其他类型判断...

从这段代码可以看出，在提示词中使用明确的行为动词和对象名词非常重要。

 请清洗以下 CSV 数据：1. 删除包含空值的行
2. 将日期列统一格式化为 YYYY-MM-DD
3. 对金额列进行四舍五入保留 2 位小数

数据样例：[这里粘贴前几行数据]

 生成一个 Python FastAPI 端点：- 路径：/items/{item_id}
- 方法：GET
- 功能：根据 ID 查询商品信息
- 返回：JSON 格式，包含 name,price,stock 字段
- 添加参数验证和错误处理

 分析以下 Python 报错原因并提供修复建议：[粘贴完整错误信息]

代码上下文：[描述代码功能和相关片段]

参数	适用场景	推荐值范围
temperature	需要创意性输出	0.7-1.0
top_p	需要确定性结果	0.1-0.5
max_tokens	控制响应长度	按需设置

模糊指令 ：” 优化这段代码 ” → 明确说明优化目标
缺少上下文 ：诊断错误时不提供完整报错信息
矛盾要求 ：同时要求 ” 简洁 ” 和 ” 详细解释 ”
格式混乱 ：未结构化的大段文字提示
文化差异 ：使用 idiom 可能被误解

import asyncio
from typing import Optional

async def call_claude_code(
    prompt: str,
    max_retries: int = 3,
    **kwargs
) -> Optional[str]:
    """调用 Claude Code 的异步封装"""
    retry_delay = 1

    for attempt in range(max_retries):
        try:
            # 实际调用代码
            response = await make_async_request(
                prompt=prompt,
                temperature=0.3,  # 稳定性优先
                top_p=0.5,
                **kwargs
            )
            return response

        except Exception as e:
            if attempt == max_retries - 1:
                raise

            await asyncio.sleep(retry_delay)
            retry_delay *= 2  # 指数退避

# 使用示例
async def main():
    prompt = """ 生成一个 Python 函数：- 输入：字符串列表
    - 功能：统计各字符串长度
    - 返回：字典格式 {string: length}
    - 添加类型注解 """

    result = await call_claude_code(prompt)
    print(result)

asyncio.run(main())