Rename claude_code to claude_agent (#188)

Author: dicksontsai

.github/workflows/create-release-tag.yml

@@ -51,9 +51,9 @@ jobs:
           --title "Release v${{ steps.extract_version.outputs.version }}" \
           --generate-notes \
           --notes-start-tag "${{ steps.previous_tag.outputs.previous_tag }}" \
-          --notes "Published to PyPI: https://pypi.org/project/claude-code-sdk/${{ steps.extract_version.outputs.version }}/
+          --notes "Published to PyPI: https://pypi.org/project/claude-agent-sdk/${{ steps.extract_version.outputs.version }}/
 
         ### Installation
         \`\`\`bash
-        pip install claude-code-sdk==${{ steps.extract_version.outputs.version }}
+        pip install claude-agent-sdk==${{ steps.extract_version.outputs.version }}
         \`\`\`"

.github/workflows/publish.yml

@@ -102,7 +102,7 @@ jobs:
       run: |
         twine upload dist/*
         echo "Package published to PyPI"
-        echo "Install with: pip install claude-code-sdk==${{ env.VERSION }}"
+        echo "Install with: pip install claude-agent-sdk==${{ env.VERSION }}"
     
     - name: Create version update PR
       env:
@@ -124,7 +124,7 @@ jobs:
         echo "Getting SHA for pyproject.toml"
         PYPROJECT_SHA=$(gh api /repos/$GITHUB_REPOSITORY/contents/pyproject.toml --jq '.sha')
         echo "Getting SHA for _version.py"
-        VERSION_SHA=$(gh api /repos/$GITHUB_REPOSITORY/contents/src/claude_code_sdk/_version.py --jq '.sha')
+        VERSION_SHA=$(gh api /repos/$GITHUB_REPOSITORY/contents/src/claude_agent_sdk/_version.py --jq '.sha')
 
         # Commit pyproject.toml via GitHub API (this creates signed commits)
         message="chore: bump version to ${{ env.VERSION }}"
@@ -138,10 +138,10 @@ jobs:
           -f branch="$BRANCH_NAME"
 
         # Commit _version.py via GitHub API
-        base64 -i src/claude_code_sdk/_version.py > version.py.b64
+        base64 -i src/claude_agent_sdk/_version.py > version.py.b64
         gh api \
           --method PUT \
-          /repos/$GITHUB_REPOSITORY/contents/src/claude_code_sdk/_version.py \
+          /repos/$GITHUB_REPOSITORY/contents/src/claude_agent_sdk/_version.py \
           -f message="$message" \
           -F content=@version.py.b64 \
           -f sha="$VERSION_SHA" \
@@ -152,11 +152,11 @@ jobs:
         
         ## Changes
         - Updated version in \`pyproject.toml\`
-        - Updated version in \`src/claude_code_sdk/_version.py\`
+        - Updated version in \`src/claude_agent_sdk/_version.py\`
         
         ## Release Information
-        - Published to PyPI: https://pypi.org/project/claude-code-sdk/${{ env.VERSION }}/
-        - Install with: \`pip install claude-code-sdk==${{ env.VERSION }}\`
+        - Published to PyPI: https://pypi.org/project/claude-agent-sdk/${{ env.VERSION }}/
+        - Install with: \`pip install claude-agent-sdk==${{ env.VERSION }}\`
         
         🤖 Generated by GitHub Actions"
         

.github/workflows/test.yml

@@ -28,7 +28,7 @@ jobs:
 
       - name: Run tests
         run: |
-          python -m pytest tests/ -v --cov=claude_code_sdk --cov-report=xml
+          python -m pytest tests/ -v --cov=claude_agent_sdk --cov-report=xml
 
       - name: Upload coverage to Codecov
         uses: codecov/codecov-action@v4

CLAUDE.md

@@ -18,7 +18,7 @@ python -m pytest tests/test_client.py
 
 # Codebase Structure
 
-- `src/claude_code_sdk/` - Main package
+- `src/claude_agent_sdk/` - Main package
   - `client.py` - ClaudeSDKClient for interactive sessions
   - `query.py` - One-shot query function
   - `types.py` - Type definitions

README.md

@@ -1,11 +1,11 @@
-# Claude Code SDK for Python
+# Claude Agent SDK for Python
 
-Python SDK for Claude Code. See the [Claude Code SDK documentation](https://docs.anthropic.com/en/docs/claude-code/sdk/sdk-python) for more information.
+Python SDK for Claude Agent. See the [Claude Agent SDK documentation](https://docs.anthropic.com/en/docs/claude-code/sdk/sdk-python) for more information.
 
 ## Installation
 
 ```bash
-pip install claude-code-sdk
+pip install claude-agent-sdk
 ```
 
 **Prerequisites:**
@@ -17,7 +17,7 @@ pip install claude-code-sdk
 
 ```python
 import anyio
-from claude_code_sdk import query
+from claude_agent_sdk import query
 
 async def main():
     async for message in query(prompt="What is 2 + 2?"):
@@ -28,10 +28,10 @@ anyio.run(main)
 
 ## Basic Usage: query()
 
-`query()` is an async function for querying Claude Code. It returns an `AsyncIterator` of response messages. See [src/claude_code_sdk/query.py](src/claude_code_sdk/query.py).
+`query()` is an async function for querying Claude Code. It returns an `AsyncIterator` of response messages. See [src/claude_agent_sdk/query.py](src/claude_agent_sdk/query.py).
 
 ```python
-from claude_code_sdk import query, ClaudeAgentOptions, AssistantMessage, TextBlock
+from claude_agent_sdk import query, ClaudeAgentOptions, AssistantMessage, TextBlock
 
 # Simple query
 async for message in query(prompt="Hello Claude"):
@@ -79,7 +79,7 @@ options = ClaudeAgentOptions(
 ## ClaudeSDKClient
 
 `ClaudeSDKClient` supports bidirectional, interactive conversations with Claude
-Code. See [src/claude_code_sdk/client.py](src/claude_code_sdk/client.py).
+Code. See [src/claude_agent_sdk/client.py](src/claude_agent_sdk/client.py).
 
 Unlike `query()`, `ClaudeSDKClient` additionally enables **custom tools** and **hooks**, both of which can be defined as Python functions.
 
@@ -94,7 +94,7 @@ For an end-to-end example, see [MCP Calculator](examples/mcp_calculator.py).
 #### Creating a Simple Tool
 
 ```python
-from claude_code_sdk import tool, create_sdk_mcp_server, ClaudeAgentOptions, ClaudeSDKClient
+from claude_agent_sdk import tool, create_sdk_mcp_server, ClaudeAgentOptions, ClaudeSDKClient
 
 # Define a tool using the @tool decorator
 @tool("greet", "Greet a user", {"name": str})
@@ -186,7 +186,7 @@ For more examples, see examples/hooks.py.
 #### Example
 
 ```python
-from claude_code_sdk import ClaudeAgentOptions, ClaudeSDKClient, HookMatcher
+from claude_agent_sdk import ClaudeAgentOptions, ClaudeSDKClient, HookMatcher
 
 async def check_bash_command(input_data, tool_use_id, context):
     tool_name = input_data["tool_name"]
@@ -232,15 +232,15 @@ async with ClaudeSDKClient(options=options) as client:
 
 ## Types
 
-See [src/claude_code_sdk/types.py](src/claude_code_sdk/types.py) for complete type definitions:
+See [src/claude_agent_sdk/types.py](src/claude_agent_sdk/types.py) for complete type definitions:
 - `ClaudeAgentOptions` - Configuration options
 - `AssistantMessage`, `UserMessage`, `SystemMessage`, `ResultMessage` - Message types
 - `TextBlock`, `ToolUseBlock`, `ToolResultBlock` - Content blocks
 
 ## Error Handling
 
 ```python
-from claude_code_sdk import (
+from claude_agent_sdk import (
     ClaudeSDKError,      # Base error
     CLINotFoundError,    # Claude Code not installed
     CLIConnectionError,  # Connection issues
@@ -259,7 +259,7 @@ except CLIJSONDecodeError as e:
     print(f"Failed to parse response: {e}")
 ```
 
-See [src/claude_code_sdk/_errors.py](src/claude_code_sdk/_errors.py) for all error types.
+See [src/claude_agent_sdk/_errors.py](src/claude_agent_sdk/_errors.py) for all error types.
 
 ## Available Tools
 

e2e-tests/test_agents_and_settings.py

@@ -5,7 +5,7 @@
 
 import pytest
 
-from claude_code_sdk import (
+from claude_agent_sdk import (
     AgentDefinition,
     ClaudeAgentOptions,
     ClaudeSDKClient,

e2e-tests/test_dynamic_control.py

@@ -2,7 +2,7 @@
 
 import pytest
 
-from claude_code_sdk import (
+from claude_agent_sdk import (
     ClaudeAgentOptions,
     ClaudeSDKClient,
 )

e2e-tests/test_include_partial_messages.py

@@ -9,8 +9,8 @@
 
 import pytest
 
-from claude_code_sdk import ClaudeSDKClient
-from claude_code_sdk.types import (
+from claude_agent_sdk import ClaudeSDKClient
+from claude_agent_sdk.types import (
     ClaudeAgentOptions,
     StreamEvent,
     AssistantMessage,

e2e-tests/test_sdk_mcp_tools.py

@@ -8,7 +8,7 @@
 
 import pytest
 
-from claude_code_sdk import (
+from claude_agent_sdk import (
     ClaudeAgentOptions,
     ClaudeSDKClient,
     create_sdk_mcp_server,

e2e-tests/test_stderr_callback.py

@@ -2,7 +2,7 @@
 
 import pytest
 
-from claude_code_sdk import ClaudeCodeOptions, query
+from claude_agent_sdk import ClaudeAgentOptions, query
 
 
 @pytest.mark.e2e
@@ -15,7 +15,7 @@ def capture_stderr(line: str):
         stderr_lines.append(line)
 
     # Enable debug mode to generate stderr output
-    options = ClaudeCodeOptions(
+    options = ClaudeAgentOptions(
         stderr=capture_stderr,
         extra_args={"debug-to-stderr": None}
     )
@@ -39,7 +39,7 @@ def capture_stderr(line: str):
         stderr_lines.append(line)
 
     # No debug mode enabled
-    options = ClaudeCodeOptions(stderr=capture_stderr)
+    options = ClaudeAgentOptions(stderr=capture_stderr)
 
     # Run a simple query
     async for _ in query(prompt="What is 1+1?", options=options):